端点参考 · 模型目录与参数 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_required | true 表示这个模型可能被路由到要求素材库句柄的供货源;只在请求带媒体时相关。普通公网 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,不会静默改变你的偏好或更换模型。