Agent 客户端接入
Agent 客户端接入
将 PixMind GPT-5.6 模型接入 OpenCode、Cursor、Trae、Cherry Studio、Cline 等 Agent 客户端。
PixMind 为大语言模型提供 OpenAI Chat Completions 兼容接口。支持这一协议的 Agent、IDE 和桌面客户端可以复用同一个 API Key、Base URL 与模型 ID。
接入前准备
- 在 API Platform 密钥管理创建 API Key。
- 准备统一 Base URL：
https://aihub-admin.aimix.pro/api-platform/v1。 - 初次接入建议选择
gpt-5.6-terra，连接成功后再按任务切换模型。
API Key 只应保存在客户端的安全凭据、系统钥匙串或环境变量中，不要提交到 Git 仓库。
适用客户端
| 客户端 | 接入协议 | 当前支持 | 配置文档 |
|---|---|---|---|
| OpenCode | OpenAI Chat Completions | 可直接接入 | 查看配置 |
| Cursor | OpenAI Chat Completions | 可直接接入 | 查看配置 |
| Trae | OpenAI Chat Completions | 可直接接入 | 查看配置 |
| Cherry Studio | OpenAI Chat Completions | 可直接接入 | 查看配置 |
| Cline / Roo Code | OpenAI Compatible | 可直接接入 | 查看配置 |
| Codex CLI | OpenAI Responses | 需要协议网关 | 了解限制 |
| Claude Code | Anthropic Messages | 可直接接入 | 查看配置 |
模型选择
Anthropic
| 模型 ID | 定位 | 推荐场景 |
|---|---|---|
claude-fable-5 | 旗舰智能体 | 复杂 Agent、深度推理、长流程任务 |
claude-opus-5 | 高阶推理 | 架构分析、复杂规划、高难度调试 |
claude-sonnet-5 | 均衡编码 | 日常编码、工具调用、代码审查 |
claude-opus-4-8 | 复杂工程 | 大型代码库、跨文件重构、疑难问题 |
claude-opus-4-8-cc | 代码代理 | 终端工具和自动化开发 |
OpenAI
| 模型 ID | 定位 | 推荐场景 |
|---|---|---|
gpt-5.6-sol | 旗舰推理 | 大型代码库、架构设计、复杂调试 |
gpt-5.6-terra | 均衡首选 | 日常开发、工具调用、综合 Agent 任务 |
gpt-5.6-luna | 高速轻量 | 快速问答、小改动和批量任务 |
| 模型 ID | 定位 | 推荐场景 |
|---|---|---|
gemini-3.1-pro-preview | 多模态推理 | 复杂图像与视频理解 |
gemini-3.5-flash | 多模态均衡 | 视觉问答、视频理解、工具调用 |
gemini-3.6-flash | 高效多模态 | 高频多模态与批处理任务 |
gemini-3.7-flash | 视觉与视频 | 快速内容理解 |
gemini-3.5-flash-lite | 轻量多模态 | 分类、提取和批量摘要 |
协议支持
PixMind 同时提供两种客户端协议：
- OpenAI-compatible 客户端使用
POST /api-platform/v1/chat/completions。 - Claude Code 使用
POST /api-platform/anthropic/v1/messages，并可调用同一前缀下的/v1/messages/count_tokens与/v1/models。 - Codex CLI 自定义供应商使用 OpenAI Responses，目前仍需要 Responses 兼容端点。
通用排查
401 Unauthorized：确认客户端实际发送了Authorization: Bearer <API_KEY>或x-api-key。404 Not Found：Base URL 应以/api-platform/v1结尾，客户端负责追加/chat/completions。Model not found：填写模型原始 ID，例如gpt-5.6-terra，不要填写展示名称。- 流式响应异常：先关闭 streaming 验证普通请求，再开启 OpenAI-compatible streaming。