模型接入说明
模型接入说明
按 modelKey / 模态 / 供应商 帮你选择最合适的 JELLYTOKEN 推理 API。
先选推荐协议
| 你的场景 | 默认推荐 | 什么时候选其他协议 |
|---|---|---|
| 文本对话、聊天机器人、Function Calling | OpenAI Chat Completions | Anthropic SDK/Claude Code 用 Messages API;Codex/Responses 工作流用 Responses API |
| 图片生成、图片编辑 | 平台异步任务 API | 已有百炼/火山方舟原生 HTTP 代码时用 供应商原生接口兼容 |
| 视频生成、视频编辑 | 平台异步任务 API | 已有百炼/火山方舟原生 HTTP 代码时用 供应商原生接口兼容 |
| 迁移供应商原生路径 | 供应商原生接口兼容 | 新项目不优先推荐 |
不确定从哪读起 → 接入前准备。
从 modelKey 找到文档
-
在控制台「模型超市」复制模型 ID,或调用 模型列表与元信息:
export API_KEY="uas_你的密钥" export API_BASE_URL="https://aiservice.jellytoken.com" curl -s "$API_BASE_URL/api/ai/models" \ -H "Authorization: Bearer $API_KEY" -
查 modelKey 速查表 或看返回里的
type与供应商/展示名:TEXT:优先读文本目录,默认走/v1/chat/completionsIMAGE:优先读图片目录,默认走POST /api/ai/tasksVIDEO:优先读视频目录,默认走POST /api/ai/tasks
-
如果只知道模型名称、不确定供应商,查 modelKey 速查表,或在控制台模型详情查看文档链接。
平台通用文档:开发者文档首页
厂商在线 API:阿里云百炼帮助中心 · 火山方舟文档
文档导航
下面的 README 都是分类导航页:先按供应商和模态定位,再进入具体协议或模型系列文档。
| 文档 | 说明 |
|---|---|
| 接入前准备 | API Key、Base URL、协议选型 |
| modelKey 速查表 | 全部百炼/方舟 modelKey → 主文档 |
| 百炼 · 文本 | 千问、DeepSeek、GLM、Kimi 等 |
| 百炼 · 图片 | qwen-image、万相文生图 |
| 百炼 · 视频 | 万相 2.x、HappyHorse |
| 火山方舟 · 文本 | doubao-seed 系列 |
| 火山方舟 · 图片 | Seedream |
| 火山方舟 · 视频 | Seedance |
术语
- 模型 ID / modelKey:控制台与 API 使用的同一个模型标识(如
qwen3.7-max、wan2.6-i2v)。OpenAI/Anthropic 请求字段叫model,异步任务字段叫modelKey,取值相同。 - 供应商原生接口兼容:保留百炼/火山方舟 URL 路径和请求体,仅替换 Base URL 与 API Key。适合迁移存量原生代码,详见 供应商原生接口兼容。