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

先查当前可用的生成模型,再用对应的 JSON Schema 确认创作参数。把目录返回的 slug 填入创建请求的 model。

一、列出生成模型

终端命令
curl "https://intertoken.ai/v1/contents/generations/models" -H "Authorization: Bearer $TP_API_KEY"
JSON
{
  "object": "list",
  "data": [
    {
      "slug": "MODEL_ID",
      "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 表示这个模型可能被路由到要求素材库句柄的供货源;只在请求带媒体时相关。普通公网 URL 会优先路由到无需登记素材的候选;如果当前可用的规格和路由都要求登记,按 asset_required 返回的提示处理

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

二、获取模型参数 Schema

终端命令
curl "https://intertoken.ai/v1/contents/generations/models/ENCODED_MODEL_ID/schema" -H "Authorization: Bearer $TP_API_KEY"

返回该模型创作参数的标准 JSON Schema(required/properties/字段说明),用于在花钱前做客户端校验。把 slug 中的斜杠编码为 %2F,填入 ENCODED_MODEL_ID。

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

错误:

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

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

同一个 slug 可能对应多个供货规格。可在工作台为 Key 设置规格偏好,创建前查看所选规格的价格。

这是账户管理 API,使用登录令牌。

代码
PATCH https://api.taotoken.io/api/v1/keys/{key_id}/route
{ "tier_order": ["quality"] }   // 或 ["value"],不传则默认按性价比自动兜底

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

选择下一篇

Seedance 与其他视频模型的选型 · 首帧图生视频