立即注册

供应商原生接口兼容

供应商原生接口兼容

供应商原生接口兼容允许你在 保留百炼 / 火山方舟原生 URL 路径和请求体 的前提下，使用 JELLYTOKEN API Key 鉴权；部分异步场景下平台可代为轮询任务进度并触发 Webhook。

推荐选择：新项目默认使用平台统一入口（文本走 /v1/chat/completions，图片/视频走 /api/ai/tasks）。供应商原生接口兼容主要用于迁移已有百炼/火山方舟原生 HTTP 路径、请求体或 SDK 代码。

类比：

平台原生域名JELLYTOKEN 兼容入口
百炼 DashScopedashscope.aliyuncs.comaiservice.jellytoken.com/bailian
火山方舟ark.cn-beijing.volces.comaiservice.jellytoken.com/ark

1. 入口前缀

前缀上游典型用途
/bailian/**阿里云百炼 DashScope通义 Chat、万相图像/视频、Codex Responses
/ark/**火山方舟 ArkSeedance 视频、方舟 Chat/图像

鉴权：使用平台 API Key（Authorization: Bearer uas_xxx）。

2. 与 /api/ai 的区别

维度/api/ai/*供应商原生接口兼容
请求形态平台统一入参结构（videoParams / imageParams 等）尽量贴近上游 JSON
模型参数videoParams / imageParams上游原生 body
适用新项目默认推荐，统一集成、文档驱动迁移存量供应商原生代码
异步平台统一任务 API可选异步托管，查单方式见下文

3. 默认路径白名单

未在白名单的路径返回 404。

百炼 /bailian

方法路径
POST/compatible-mode/v1/chat/completions
POST/compatible-mode/v1/responses
GET/compatible-mode/v1/models
POST/apps/anthropic/v1/messages
POST/api/v1/services/aigc/video-generation/video-synthesis
POST/api/v1/services/aigc/multimodal-generation/generation
POST/api/v1/services/aigc/image-generation/generation
GET/api/v1/tasks/*

方舟 /ark

方法路径
POST/api/v3/chat/completions
POST/api/v3/responses
POST/api/compatible/v1/messages
POST/api/v3/contents/generations/tasks
GET/api/v3/contents/generations/tasks/*
POST/api/v3/images/generations
GET/api/v3/models

4. Base URL 替换示例

百炼 OpenAI 兼容 Chat

原 Base URLJELLYTOKEN 兼容 Base URL
https://dashscope.aliyuncs.com/compatible-mode/v1https://aiservice.jellytoken.com/bailian/compatible-mode/v1
from openai import OpenAI

client = OpenAI(
    api_key="uas_xxx",
    base_url="https://aiservice.jellytoken.com/bailian/compatible-mode/v1",
)

方舟 Chat

原 Base URLJELLYTOKEN 兼容 Base URL
https://ark.cn-beijing.volces.com/api/v3https://aiservice.jellytoken.com/ark/api/v3

百炼 Anthropic Messages（Claude Code 迁移）

原 Base URLJELLYTOKEN 兼容 Base URL
https://dashscope.aliyuncs.com/apps/anthropic/v1https://aiservice.jellytoken.com/bailian/apps/anthropic/v1
import anthropic

client = anthropic.Anthropic(
    api_key="uas_xxx",
    base_url="https://aiservice.jellytoken.com/bailian/apps/anthropic/v1",
)

方舟 Anthropic Messages（Claude Code 迁移）

原 Base URLJELLYTOKEN 兼容 Base URL
https://ark.cn-beijing.volces.com/api/compatible/v1https://aiservice.jellytoken.com/ark/api/compatible/v1

5. model 字段

POST body 中的 model 须为控制台已授权的 模型 ID（如 doubao-seedance-2.0、wan2.6-i2v）。

GET /compatible-mode/v1/models 返回当前账号在百炼（DashScope）通道下已授权的模型；GET /ark/api/v3/models 返回方舟（Bytedance）通道下已授权的模型。形态均与 GET /v1/models 一致，为对应供应商子集。查询全部供应商授权模型请用 GET /v1/models。

6. 异步任务查单

通过供应商原生接口兼容提交的异步任务，完成后可使用平台统一查单 API：

GET /api/ai/tasks/{taskId}

taskId 格式与 异步任务 文档一致。也可配置 Webhook 接收完成通知。

7. 视频生成示例（百炼路径）

API_BASE_URL=https://aiservice.jellytoken.com
API_KEY=uas_xxx

curl -s -X POST "$API_BASE_URL/bailian/api/v1/services/aigc/video-generation/video-synthesis" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.6-i2v",
    "input": {
      "prompt": "一只猫在跑"
    },
    "parameters": {}
  }'

具体 body 结构以百炼官方文档为准；model 填控制台模型 ID。

8. 注意事项

  1. Embeddings 等未在白名单的路径不可用，请联系平台扩展或使用 /api/ai/tasks
  2. 原生接口兼容路径下请传已授权的 模型 ID，不要使用未在控制台开通的模型名
  3. 计费与限流与平台其他 API 一致

相关文档