模型接入说明

模型接入说明

modelKey / 模态 / 供应商 帮你选择最合适的 JELLYTOKEN 推理 API。


先选推荐协议

你的场景默认推荐什么时候选其他协议
文本对话、聊天机器人、Function CallingOpenAI Chat CompletionsAnthropic SDK/Claude Code 用 Messages API;Codex/Responses 工作流用 Responses API
图片生成、图片编辑平台异步任务 API已有百炼/火山方舟原生 HTTP 代码时用 供应商原生接口兼容
视频生成、视频编辑平台异步任务 API已有百炼/火山方舟原生 HTTP 代码时用 供应商原生接口兼容
迁移供应商原生路径供应商原生接口兼容新项目不优先推荐

不确定从哪读起 → 接入前准备


从 modelKey 找到文档

  1. 在控制台「模型超市」复制模型 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"
    
  2. modelKey 速查表 或看返回里的 type 与供应商/展示名:

    • TEXT:优先读文本目录,默认走 /v1/chat/completions
    • IMAGE:优先读图片目录,默认走 POST /api/ai/tasks
    • VIDEO:优先读视频目录,默认走 POST /api/ai/tasks
  3. 如果只知道模型名称、不确定供应商,查 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-maxwan2.6-i2v)。OpenAI/Anthropic 请求字段叫 model,异步任务字段叫 modelKey,取值相同。
  • 供应商原生接口兼容:保留百炼/火山方舟 URL 路径和请求体,仅替换 Base URL 与 API Key。适合迁移存量原生代码,详见 供应商原生接口兼容