API 参考
概览
本节解释 https://api.anyint.ai 背后的主要 API 家族，并链接到按端点组织的路由地图。
本节解释 https://api.anyint.ai 背后的主要 API 家族。最重要的区别在于，AnyInt 提供不止一种兼容家族。有些路由采用 OpenAI 风格，有些采用 Anthropic 风格，有些是 Gemini 原生风格，而媒体和音乐工作流则面向任务。
如果你需要逐条路由地图，请先查看 端点索引。LLM 和集成工具也可以读取 https://anyint.ai/docs/api-endpoints.json。
本节记录面向客户的公开网关契约。它有意排除非公开运营路由、管理员路由、调试端点、部署细节和提供方回调内部细节。
当前端点家族
| 家族 | 状态 | 路由 | 适用场景 |
|---|---|---|---|
| Models API | Stable | /openai/v1/models, /anthropic/v1/models | 发现可用模型 |
| OpenAI 兼容 | Stable | /openai/v1/chat/completions | 现有的 OpenAI SDK 客户端 |
| OpenAI Responses | Beta | /openai/v1/responses | 要求 Responses API 的 Agent 工具 |
| Anthropic 兼容 | Stable | /anthropic/v1/messages, /anthropic/v1/messages/count_tokens | Claude 风格客户端和 token 计数 |
| Gemini 兼容 | Stable | ...generateContent, ...streamGenerateContent | Gemini 原生请求结构 |
| 媒体 API | Stable | OpenAI 风格视频、DashScope 和提供方原生媒体路由 | 图片和视频生成 |
| AI 音乐 | Stable | /suno/* | 音乐生成和异步媒体工作流 |
认证模式
已发布的路由目前根据家族使用两种请求头风格：
- Bearer 认证：
Authorization: Bearer <API_KEY> - 提供方风格认证：
x-api-key: <API_KEY>以及任何所需的兼容性请求头，例如anthropic-version
请使用该页面上为你正在集成的端点家族所文档化的请求头约定。
推荐的集成顺序
- 在发布硬编码的模型 ID 之前，调用 Models API。
- 如果你只需要聊天或流式传输，先从 OpenAI 兼容 API 开始。
- 只有当客户端要求 Responses API wiring 时，才使用 OpenAI Responses API。
- 当你需要提供方原生请求体时，切换到 Anthropic 兼容 API 或 Gemini 兼容 API。
- 使用 媒体 API、Kling 视频 等模型专页和 AI 音乐 API 处理不是普通聊天补全的资产生成工作流。
- 生产发布前运行 验证你的集成 清单。
异步与同步路由
同步或优先流式
- OpenAI 兼容聊天
- Anthropic 消息
- Gemini 文本和图像生成
- DashScope 图像生成
基于任务
- DashScope 视频生成
- 所有 AI 音乐工作流
- OpenAI 风格视频任务
基于任务的 API 通常会先返回一个任务 ID。随后你再轮询查询端点，或接收 webhook 回调。不要把初始 200 响应视为最终资产。
选择 API 家族的实用规则
如果满足以下情况，请使用 OpenAI 兼容路由：
- 你希望尽快完成首次集成
- 你的应用已经在使用 OpenAI SDK
- 你不需要提供方原生的请求字段
如果满足以下情况，请使用提供方原生路由：
- 你需要 Anthropic 的内容块或 token 计数
- 你需要 Gemini
generateContent,streamGenerateContent，或functionDeclarations - 你希望在自己的产品中镜像提供方的原生请求格式
如果满足以下情况，请使用媒体或音乐路由：
- 输出是图片、视频或歌曲，而不是普通文本响应
- 工作流本质上是异步的
- 你需要任务轮询或 webhook 回调