1. CSDP 模型网关定位
CSDP 模型网关是平台统一接入全球大模型的入口。用户无需自行注册 OpenAI、Claude、Gemini 等海外账号，无需外币信用卡，只需调用 CSDP 提供的 OpenAI 兼容接口，即可使用 GPT、Claude、Gemini、DeepSeek 等模型。
模型网关底层通过 NewAPI 统一路由，支持国内模型与海外模型。所有跨境流量走 CSDP-WAN 合规专线，平台统一处理数据出境与计费。
- Base URL：`https://api.opc-platform.com/v1`（本地开发：`http://localhost:3003/api/models`）
- 鉴权：使用 OPC 登录后获取的 Bearer Token
- 兼容：OpenAI SDK、LangChain、LlamaIndex 等主流框架
- 计费：按实际 Token 用量从钱包实时扣费
2. 非流式对话示例
使用 OPC 模型网关进行非流式对话，只需将 `Authorization` 头替换为从登录接口获取的 token。
- 接口：`POST /api/models/chat`
- 参数：model、messages、temperature、maxTokens
- 返回：content、usage、cost、provider、latency
3. 流式输出（SSE）
对于长文本生成，建议使用流式接口以减少等待时间。CSDP 模型网关的流式接口遵循 Server-Sent Events 格式，前端可通过 `EventSource` 或 `fetch` 读取数据流。
- 接口：`POST /api/models/chat/stream`
- 请求体与普通对话相同
- 返回：每个 chunk 包含 `content` 片段，最后返回 `done: true` 与 `usage`、`cost`
- 客户端需按 SSE 格式解析 `data:` 开头的行
4. OpenAI SDK 兼容接入
如果你已经使用 OpenAI SDK，通常只需修改 `apiKey` 和 `baseURL` 即可接入 CSDP 模型网关。注意：这里使用的是 OPC 登录 token，不是 OpenAI 官方 API Key。
- JavaScript：`new OpenAI({ apiKey: opcToken, baseURL: "https://api.opc-platform.com/v1" })`
- Python：`OpenAI(api_key=opc_token, base_url="https://api.opc-platform.com/v1")`
- model 参数填写 OPC 平台支持的模型名称，如 `gpt-5.4`、`deepseek-v4-flash`
5. 工具调用与结构化输出
部分模型支持 Function Calling（工具调用）和结构化输出（JSON Mode）。能力可用性取决于模型本身，具体以模型计费标准页标注为准。
- 工具调用：在 `tools` 参数中定义函数，模型会返回 `tool_calls`
- 结构化输出：在请求中指定 `response_format: { type: "json_object" }`
- 当前支持情况：gpt-5.4、claude-sonnet-5、kimi-k2.5 支持部分能力；deepseek-v4-flash 未完整支持工具调用
- 多模态与图片生成、音频转写当前渠道暂未开放
6. 常见问题
接入模型网关时常见的问题与排查方法：
- 401 Unauthorized：检查 Bearer Token 是否有效，是否已登录
- 403 Forbidden：检查是否已完成企业认证
- 模型不存在：确认 model 名称是否为 OPC 平台支持的模型
- 余额不足：充值 Token 额度后再试
- 某些参数不生效：不同模型支持的参数不同，请参考模型计费标准