这部分给自己编程、开发网站或连接业务系统的用户使用。只想用 AI 助手处理任务，请走 CC Switch 使用教程；这里可以按你需要的接口查参数、看示例。

第一次接接口，按这四步走#

  1. 1

    创建归壹 API 密钥

    在 API 密钥 中创建专用密钥，确认分组、有效期和额度。网站登录密码不能替代它。

  2. 2

    确认模型和接口类型

    从模型广场或模型列表复制完整模型 ID，再确认当前线路支持哪个协议。同一个模型昵称不代表所有接口都支持。

  3. 3

    先发最小请求

    先用一句短文本和非流式请求确认地址、密钥和模型，再增加图片、工具或流式输出。生成请求会按模型价格计费。

  4. 4

    核对结果和使用日志

    确认回答或任务结果符合预期，再到归壹使用日志核对模型、用量和扣费。遇到超时先查任务或记录，避免连续重复提交。

获取模型列表

OpenAI 与 Gemini 风格的模型目录。

Chat Completions

messages 格式，多轮聊天和流式返回。

Responses

input 格式，与 Chat 的请求和返回不同。

Claude Messages

Claude Code 等客户端使用的 Messages 协议。

Gemini 原生对话

contents、parts 与媒体输入。

生成和编辑图片

OpenAI、Qwen 与 Gemini 格式的区别。

生成和查询视频

异步任务、状态查询和内容下载。

转录、翻译与语音生成

文件上传、文字转语音和 Gemini 音频。

向量与重排序

知识库检索需要的 Embeddings 与 Rerank。

实时语音

WebSocket 连接与当前功能边界。

其他接口与兼容范围

旧补全、内容审查、文件和微调。

地址、鉴权和模型，分别填什么#

项目说明
归壹服务地址https://univto.com
OpenAI 兼容 SDK 的 base_urlhttps://univto.com/v1；不要再重复追加 /v1
直接发 HTTP 请求使用每篇文档写明的完整路径，例如 /v1/chat/completions
常见鉴权Authorization: Bearer YOUR_GUIYI_API_KEY；Messages 等格式以对应页面为准
Content-TypeJSON 请求用 application/json；上传文件时让客户端生成 multipart 边界
模型 ID从归壹复制完整 ID，不把参考文档或第三方平台的示例型号当成已开通型号

代码中的环境变量和大写英文都是占位内容，需要在你自己的运行环境设置。静态文档不会自动读取密钥，也不会在页面里替你发出请求。不要把长期 API 密钥写进公开网页、截图或代码仓库。

读示例前，先看接口适用范围#

页面说明代表什么
有归壹历史接入或测试依据曾在对应线路验证过特定流程，当前是否可用仍受模型、权限、余额和上游状态影响
协议参考，需确认线路说明接口写法，不表示归壹已为你的账号开通该功能
暂停或尚未完成生成验收不能把示例当作当前可直接使用的服务承诺
模型目录可见不等于工具调用、流式、图片、实时语音等能力全部已验证

不同上游支持的接口和参数有差异。归壹有统一入口，也保留部分原生协议；上游文档里出现的路径不能只替换域名就认定能在归壹使用。图片、视频和音频页会区分已知的归壹入口与其他协议参考。

返回方式主要有三种#

方式程序怎么处理
普通 JSON等请求完成，按该协议解析正文和 usage；Chat、Responses、Messages 的字段不同
流式 SSE逐条读取事件和增量，处理中断与结束事件；不能把它当作一次完整 JSON
异步任务先保存真实返回的任务 ID，再查询状态，成功后取结果；视频通常采用这种方式

报错时，先查这几项#

现象检查方向
401 / 鉴权失败密钥是否完整、有效；是否误填网站密码或上游密钥
403 / 权限不足密钥分组、模型限制和账号权限
404 / 接口或模型找不到完整路径、重复 /v1、模型 ID，以及线路支持的协议
400 / 参数错误JSON、必填项、文件格式、模型支持的参数与接口类型
429 / 限流按返回信息退避，不要不停重试；有些上游也用此状态表达额度限制
5xx / 超时先查看使用日志或任务状态，再决定是否重试；提交成功但回包丢失时可能重复计费

状态码只是排查方向，最终以响应中的错误内容为准。记录时间、接口、模型、状态码和脱敏后的请求标识即可；不要提交完整 API 密钥或私人对话。详细排查可看 常见错误，费用说明可看 用量与扣费。