TTokenPortal

端点参考 · 模型目录与参数 Schema

Doc status已发布Feature status已上线Last updated：2026-09-19

发起生成请求前，先用这两个端点确认可用模型与它支持的创作参数。不要把模型 slug 或创作参数写死在客户端代码里——平台会改名、加规格、加供货源，写死的值迟早会失效。

一、列出生成模型

GET https://intertoken.ai/v1/contents/generations/models
Authorization: Bearer sk-…

{
  "object": "list",
  "data": [
    {
      "slug": "volcengine/doubao-seedance-2.0",
      "aliases": [],
      "tier_dimension": "video_resolution",
      "schema_version": "2026-08-16",
      "asset_required": false
    }
  ]
}
字段含义
slug创建生成任务时 model 字段要填的正名
aliases同一模型的其它可用名（历史改名后保留），传这些同样有效
tier_dimension计费方式：video_resolution（按分辨率 × 是否含视频输入定价）或 video_duration（按秒计价，需要 duration 必填）——决定创建请求要传 resolution 还是 duration
schema_version该模型创作参数 schema 的版本号，可用于客户端缓存失效判断
asset_requiredtrue 表示这个模型可能被路由到要求素材库句柄的供货源；不代表你一定要走素材库，只在这次请求带图片/视频/音频输入时才相关

错误：取数失败返回 503，不会返回空列表——空列表在这个端点上是"目录里确实没有生成类模型"这个合法状态，与取数故障是两回事，请按状态码区分。

二、获取模型参数 Schema

GET https://intertoken.ai/v1/contents/generations/models/{slug}/schema
Authorization: Bearer sk-…

返回该模型创作参数的标准 JSON Schema（required/properties/字段说明），用于在花钱前做客户端校验。slug 含 / 时需要 URL 编码。

  • required 里列出的字段是该模型计费方式下必填的
  • additionalProperties: true 是有意的：模型方新增创作参数时，平台不会因此拒绝请求
  • 具体哪个模型支持哪些字段按当次取到的 schema 为准，不建议在客户端硬编码一份字段表

错误：

HTTP含义
200正常返回 schema
404目录里没有这个模型 slug
501模型在目录里，但平台还没为它登记参数 schema——模型仍可正常调用，只是这份提前校验用不了
503平台侧取数失败，与"模型不存在"无关，请稍后重试

三、用 Key 的路由配置选货源规格

同一个模型 slug 背后可能有多条货源（例如官方直连与折扣分销），画质一致、价格不同：

这是控制面接口（管理 Key 用的域名，与本页其它数据面端点不同）：

PATCH /api/v1/keys/{key_id}/route
{ "tier_order": ["quality"] }   // 或 ["value"]，不传则默认按性价比自动兜底

一旦请求引用了素材库句柄，候选货源会收窄到"该素材有可用绑定、且服务本次请求模型"的那些——如果收窄后的候选与你设置的路由偏好冲突，或收窄后为空，创建生成任务会直接返回 400，不会静默改变你的偏好或更换模型。

相关链接