立即注册

模型接入前准备

接入前准备

在查阅各模型文档前，请先完成以下步骤。

1. 获取 API Key

在 JELLYTOKEN 控制台创建 Key，格式 uas_<32位>。
详见 鉴权与 API Key。

Authorization: Bearer uas_你的密钥

2. Base URL

建议先设置根域名，再按协议选择 SDK base_url 或 HTTP URL：

export API_KEY="uas_你的密钥"
export API_BASE_URL="https://aiservice.jellytoken.com"
场景SDK base_url / HTTP URL
OpenAI Chat / Responses SDKhttps://aiservice.jellytoken.com/v1
Anthropic SDK / Claude Codehttps://aiservice.jellytoken.com
直接调用 Messages HTTPhttps://aiservice.jellytoken.com/v1/messages
图片/视频异步任务https://aiservice.jellytoken.com/api/ai/tasks
百炼原生接口兼容https://aiservice.jellytoken.com/bailian
火山方舟原生接口兼容https://aiservice.jellytoken.com/ark

3. 确认模型已授权

# OpenAI 形态列表（仅返回当前账号可用模型）
curl -s https://aiservice.jellytoken.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

# 平台模型元信息
curl -s https://aiservice.jellytoken.com/api/ai/models \
  -H "Authorization: Bearer $API_KEY"

model / modelKey 必须填列表中的 模型 ID，不要使用厂商控制台内部 model 名。
各 modelKey 对应接入文档见 modelKey 速查表。

4. 按场景选入口

文本对话？
  ├─ 默认新接入              → POST /v1/chat/completions
  ├─ Claude Code / Anthropic SDK → POST /v1/messages
  ├─ Codex / Responses 工作流    → POST /v1/responses
  └─ 迁移百炼/火山方舟原生 body  → 供应商原生接口兼容

图片 / 视频生成？
  ├─ 推荐：统一任务 API   → POST /api/ai/tasks + 轮询 / Webhook
  └─ 已有百炼/火山方舟示例代码 → 供应商原生接口兼容路径

按模态选择入口后，进入 模型接入说明 中对应供应商文档查看 modelKey 与示例。

5. 厂商参考文档

供应商在线文档
阿里百炼阿里云百炼帮助中心
火山方舟火山方舟官方文档

接入文档中的「厂商 API 参考」链接指向上述官方站点。

6. 推荐阅读顺序

  1. 模型接入说明 — 先按场景选择推荐协议
  2. modelKey 速查表 — 从 modelKey 定位主文档
  3. 再进入对应供应商/模态目录，确认模型特有参数
  4. 需要原生路径和请求体时再读 供应商原生接口兼容 / 厂商协议 文档
  5. 错误码与限流