开发者文档
JELLYTOKEN 开发者文档
面向外部开发者的接入指南:在 JELLYTOKEN 控制台 完成账号与密钥管理,通过 平台推理 API 调用多模型能力。
文档导航
接入路线图
| 你要做什么 | 默认推荐 | 直接阅读 |
|---|---|---|
| 文本对话、Function Calling、多轮对话 | OpenAI Chat Completions | 对话补全(OpenAI 兼容) |
| Claude Code 或 Anthropic SDK | Anthropic Messages | Messages API(Anthropic 兼容) |
| Codex / Responses 工作流 | OpenAI Responses | Responses API(OpenAI 兼容) |
| 图片生成、图片编辑 | 平台异步任务 API | 异步任务(图像/视频/文本) |
| 视频生成、视频编辑 | 平台异步任务 API | 异步任务(图像/视频/文本) |
| 迁移已有百炼/火山方舟原生 HTTP 代码 | 供应商原生接口兼容 | 供应商原生接口兼容 |
新接入优先走上表的“默认推荐”。只有已有供应商原生请求体、路径或 SDK 代码需要复用时,再选择供应商原生接口兼容。
入门
控制台
API 参考
| 文档 | 说明 |
|---|---|
| 鉴权与 API Key | Key 格式、请求头、安全建议 |
| 对话补全(OpenAI 兼容) | POST /v1/chat/completions |
| Responses API(OpenAI 兼容) | POST /v1/responses |
| Messages API(Anthropic 兼容) | POST /v1/messages |
| 异步任务(图像/视频/文本) | POST /api/ai/tasks 与轮询 |
| 模型列表与元信息 | 查询可用模型 ID、类型与简要描述 |
| 供应商原生接口兼容 | 迁移百炼 /bailian、火山方舟 /ark 原生路径 |
| Webhook 回调 | 异步任务完成通知与验签 |
模型接入说明
| 文档 | 说明 |
|---|---|
| 模型接入说明 | 按供应商/模态浏览接入指南 |
| 接入前准备 | 鉴权、Base URL、协议选型 |
| modelKey 速查表 | 百炼/方舟 modelKey → 接入文档 |
| 百炼 · 文本 | 千问 / DeepSeek / GLM / Kimi 等 |
| 百炼 · 图片 | qwen-image、万相文生图 |
| 百炼 · 视频 | 万相 2.x、HappyHorse |
| 火山方舟 · 文本 | doubao-seed 系列 |
| 火山方舟 · 图片 | Seedream |
| 火山方舟 · 视频 | Seedance |
开发指南
| 文档 | 说明 |
|---|---|
| 错误码与限流 | 稳定 error_code、HTTP 状态、RPM/TPM |
在 AI 工具里使用 JellyToken
| 文档 | 说明 |
|---|---|
| 接入总览 | 通用 Base URL、API Key、模型 ID 配置 |
| jellytoken 命令行工具 | 官方 CLI:安装、auth、setup、switch |
| Cursor | 在 Cursor Chat / Agent / Edit 中使用 JellyToken |
| Claude Code | 通过 Anthropic 兼容入口接入 Claude Code |
| Codex | 通过 Responses API 接入 Codex |
| OpenCode | 通过 opencode.json 接入 OpenCode |
| OpenClaw | 在 OpenClaw 中配置 JellyToken 模型 |
| TRAE | 在 TRAE 中添加 OpenAI 兼容自定义模型 |
| Hermes Agent | 在 Hermes Agent 中配置自定义 provider |
Base URL
| 入口 | 域名 |
|---|---|
| 控制台 | www.jellytoken.com |
| 推理 API | aiservice.jellytoken.com |
API Key 在控制台创建,实际调用使用“推理 API”域名,不使用控制台域名。
推荐阅读路径
首次接入
已在用 OpenAI / Anthropic SDK
- OpenAI Python/JS → 对话补全,Base URL 改为推理 API 域名
- Codex / Responses → 默认 Responses API;迁移百炼/火山方舟原生 URL 时再看 供应商原生接口兼容
- Anthropic SDK → Messages API
图像 / 视频生成
- 统一异步入口 → 异步任务
- 按 modelKey 查参数与示例 → modelKey 速查表 或 模型列表与元信息,再进入 模型接入说明 对应文档
- 需沿用百炼/火山方舟原生 HTTP 路径 → 供应商原生接口兼容
版本与更新
| 项 | 说明 |
|---|---|
| 文档版本 | v1.0 |
| 模型列表 | 动态下发,以控制台「模型超市」及 GET /v1/models 返回为准 |
正文互链格式:[标题](/docs/quickstart),与文档 slug 一致。