入门
核心概念
在你集成 AnyInt 之前，先从几个核心概念来理解这个平台会有所帮助。
在你集成 AnyInt 之前，先从几个核心概念来理解这个平台会有所帮助。
概念地图
| 概念 | 含义 | 在哪里确认 |
|---|---|---|
| API 家族 | 有自己请求体和鉴权约定的一组 route | API 参考 |
| 模型 ID | 发送到 model 字段里的精确字符串 | 模型 API |
| API key | 用于鉴权网关请求的凭据 | API 密钥 |
| 项目或团队 key | 按团队、环境或工作负载划分的 key | 团队密钥 |
| Task ID | 异步媒体或音乐流程返回的任务标识 | 媒体与音乐 |
| Callback | 支持时用于接收异步任务事件的客户自有 URL | Webhook 与通知 |
| 回退 | 在明确策略下使用的次级模型或 route 路径 | 模型回退 |
1. 一个网关，多种模型家族
AnyInt 是一个平台，但它暴露了多个路由家族：
- 兼容 OpenAI
- 兼容 Anthropic
- 兼容 Gemini
- 媒体生成
- AI 音乐
这意味着“一个平台”并不等于“一个请求形态”。它指的是跨多个 AI 接口的一层统一操作层。
| 家族 | 典型用途 |
|---|---|
| OpenAI 兼容 | 聊天、助手和许多 SDK 的最快首次接入路径 |
| Anthropic 兼容 | Claude 风格消息和 content block |
| Gemini 兼容 | Gemini 原生 contents[].parts[]、流式和函数流程 |
| 媒体生成 | 图片和视频生成 route |
| AI 音乐 | 歌曲、翻唱、歌词、分轨和音乐视频工作流 |
2. 更容易的访问是产品的一部分
AnyInt 不只是一个中继。它的核心目的之一是降低使用先进 AI 模型所需的成本和精力。
这包括：
- 更少的特定供应商集成
- 更少的计费界面
- 在一个地方管理密钥和访问权限
- 一套文档覆盖多种工作流
3. 模型选择是一个产品问题
许多用户知道自己想解决什么任务，但不知道哪个模型最适合。这就是为什么模型选择不应被视为纯手动决策。
在许多实际场景中：
- 多个模型都能达到同样可接受的结果
- 最贵的模型并不总是必需的
- 最大的挑战是将任务需求与合适的模型和价格点相匹配
4. 智能路由（即将推出）的关键在于更好的默认选择
智能路由（即将推出）应被理解为一个模型选择层，而不仅仅是一个传输功能。
它的价值在于：
- 更合理地选择模型
- 避免不必要地使用高端模型
- 改善质量、延迟和成本之间的平衡
5. 模型 ID 是唯一真实来源
不要猜测模型 ID。请从以下位置获取： GET /openai/v1/models 或使用你账户可用的列表。可用性可能因账户、计费模式、套餐或购买配置而异。
6. API 密钥连接访问与计费
API 密钥是平台访问的主要身份验证机制。根据你调用的路由家族，请求头格式可能不同：
Authorization: Bearer <key>x-api-key: <key>
密钥也与计费模式相关，因为请求可能会消耗预付余额、订阅权益或团队管理的访问策略。
7. 异步任务在媒体工作流中很常见
并非每个路由都会立即返回最终成品。媒体和 AI 音乐工作流通常遵循以下模式：
- 创建任务
- 接收任务 ID
- 轮询查询端点或等待 webhook
- 下载生成的成品
常见错误
| 错误 | 正确模型 |
|---|---|
| 以为一个网关就代表一种 JSON schema | 请求体必须匹配 API 家族 |
| 从营销材料复制模型名称 | 使用模型 API 返回的精确 data[].id |
| 把任务创建当作资产完成 | 轮询或处理回调直到成功 |
| 到处复用同一个 key | 按环境、项目或团队拆分 key |
| 以为回退会自动发生 | 定义何时允许回退，并记录回退事件 |
需要保留的思维模型
把 AnyInt 看作：
- 一种更轻松访问先进 AI 模型的方式
- 一个用于更优模型选择的平台
- 一个支持多种 API 家族的网关
- 一个用于管理计费、密钥和策略的控制面
- 一个用于异步媒体和音乐生成的工作流层