模型列表与元信息

模型由平台运营配置，按账号授权动态返回。调用前请确认控制台或 API 列表中包含目标模型。

---

术语：模型 ID

模型 ID 是平台为每个可调用模型分配的唯一标识（例如 qwen-plus）。开发文档全文统一用「模型 ID」指这一字符串；不同 API 的 JSON 字段名不同，但取值相同。

控制台 UI 里的 modelCode 是产品侧展示标签，复制得到的字符串就是模型 ID，不是另一套编码。第三方工具（Cursor 等）里填写的模型名，也应使用这一取值（与 OpenAI SDK 的 model 参数相同）。

---

1. OpenAI 形态 — GET /v1/models

curl -s https://aiservice.jellytoken.com/v1/models \
  -H "Authorization: Bearer uas_xxx"

{
  "object": "list",
  "data": [
    {
      "id": "qwen-plus",
      "object": "model",
      "created": 1718510000,
      "owned_by": "jellytoken",
      "type": "TEXT",
      "description": "{\"inputParameters\":[...]}"
    }
  ]
}

单模型详情

curl -s https://aiservice.jellytoken.com/v1/models/qwen-plus \
  -H "Authorization: Bearer uas_xxx"

---

2. 平台模型列表 — GET /api/ai/models

curl -s "https://aiservice.jellytoken.com/api/ai/models" \
  -H "Authorization: Bearer uas_xxx"

{
  "models": [
    {
      "modelKey": "wan2.6-i2v",
      "type": "VIDEO",
      "description": "{\"inputParameters\":[...]}",
      "isActive": true
    }
  ]
}

鉴权失败时 HTTP 200，响应体为 { "models": [], "error": "...", "errorCode": "..." }；未携带 Key 时 HTTP 401。

按类型过滤

查询参数 typeFilter：TEXT | IMAGE | VIDEO

export API_KEY="uas_你的密钥"
export API_BASE_URL="https://aiservice.jellytoken.com"

# 仅返回 TEXT 模型（IMAGE / VIDEO 同理）
curl -s "$API_BASE_URL/api/ai/models?typeFilter=TEXT" \
  -H "Authorization: Bearer $API_KEY" | jq .

返回项的 type 应与 typeFilter 一致；若账号未授权某类模型，对应过滤结果可能为空数组。

列表项字段 modelKey 的取值即 模型 ID。API 不返回 provider 或 displayName（展示名由控制台 UI 配置）；判断供应商时请查 modelKey 速查表 或 模型接入说明 目录。

---

3. 模型元信息 — GET /api/ai/models/{modelId}/schema

路径中的 {modelId} 为 模型 ID（与列表项 modelKey 取值相同）。可用于确认模型是否存在、类型及描述：

curl -s https://aiservice.jellytoken.com/api/ai/models/nano-banana/schema \
  -H "Authorization: Bearer uas_xxx"

{
  "modelKey": "nano-banana",
  "type": "IMAGE",
  "description": "{\"inputParameters\":[...]}"
}

关于入参/出参说明：请以 异步任务 的通用结构及 模型接入说明 中对应供应商/模态文档为准（当前以文档为唯一参数说明来源）。控制台模型详情提供文档入口链接，不含完整参数表。

---

4. 控制台查看

---

5. 从模型类型选择推荐 API

推荐查找路径：

1. 用 GET /api/ai/models 或控制台复制模型 ID。
2. 查 modelKey 速查表 定位接入文档；或看 type 先选择上表默认推荐。
3. 需要模型特有参数时，进入 模型接入说明 中对应供应商/模态文档。
4. 只有已有供应商原生代码需要复用时，再阅读 供应商原生接口兼容。

---

6. 授权与可见性

供应商原生接口兼容路径下：GET /compatible-mode/v1/models 返回百炼（DashScope）通道已授权模型；GET /ark/api/v3/models 返回方舟（Bytedance）通道已授权模型。形态与 GET /v1/models 一致。查询全部供应商授权模型请用 GET /v1/models 或控制台。

---

相关文档

• 快速开始
• modelKey 速查表
• 模型接入说明
• 异步任务
• 供应商原生接口兼容