需要完整参数和请求示例？进入 开发者接口文档，按模型、对话、图片、视频、音频等类别查阅；本页保留常用地址速查。

先按工具选择协议：Claude Code 原生使用 Anthropic Messages，Codex 原生使用 OpenAI Responses。Chat Completions 是另一种常见开发接口；模型名字相似，不表示这些接口可以直接互换。

常用接口一览#

用途方法与完整地址注意事项
读取可见模型GET https://univto.com/v1/models需要归壹密钥；目录可见不等于 Agent 全能力兼容
Claude Code：MessagesPOST https://univto.com/v1/messagesCC Switch 基础地址填 https://univto.com；模型须支持 Messages
Codex：ResponsesPOST https://univto.com/v1/responsesCC Switch 基础地址填 https://univto.com/v1；模型须支持 Responses
开发者进阶：Chat CompletionsPOST https://univto.com/v1/chat/completions与 Messages、Responses 的请求体和返回结构不同

怎么证明这次请求是你的？#

OpenAI 兼容的 Chat Completions、Responses 请求通常在请求头携带 Authorization: Bearer 加归壹 API 密钥。Anthropic Messages 使用其客户端对应的鉴权头与版本头；使用 CC Switch 时交由工具生成，不要把 Chat 请求头和请求体直接拼成 Messages。密钥不要放进网址。

OpenAI 兼容请求头示意，仅使用占位值
Authorization: Bearer YOUR_GUIYI_API_KEY
Content-Type: application/json

开发者：最简单的 Chat Completions 请求#

字段含义新手怎么填
model模型的精确 ID从本人可用模型列表复制
messages本轮要发给模型的消息列表至少放一条 role 为 user 的文字消息
stream是否分段接收回答首次调试使用 false，成功后再尝试 true

本表仅对应 Chat Completions。Responses 通常使用 input，Messages 还有 max_tokens 等要求，不应照搬本表。Agent 的工具调用、流式输出、多轮往返也需要单独验证；普通 Chat 成功只是基础连接参考。

报错时先看这一列#

常见状态先检查什么
400 / 参数错误请求体格式、模型支持的参数、上下文长度
401 / 认证失败API 密钥是否完整、过期、停用或已删除
403 / 无权限令牌分组、模型权限及账户访问限制
404 / 找不到接口地址是否重复 /v1，模型 ID 与接口是否正确
429 / 请求过多按提示等待，降低并发；不要快速反复重试
5xx / 服务端错误保存时间、模型及脱敏错误信息，稍后小量重试或联系支持

Claude Code

按 CC Switch GUI 配置 Messages。

Codex

按 CC Switch GUI 配置 Responses。

开发者请求示例

查看独立的 Chat Completions 请求。