参数与报价请求

查询当前约束

每个模型的输入和销售规格由实时目录发布。先查询 模型目录，再读取 GET /v1/models/{id} 的 input_schema 和 prices。available 表示该模型有已验证路由和销售价，不保证每一种参数组合都有价格；具体请求以报价接口为准。

input_schema 使用 JSON Schema 描述属性、类型、必填字段、枚举、范围与默认值。不要用供应商的模型名替代 jisu 模型 ID，也不要将其他模型的参数直接复用。

报价字段

POST /v1/quotes 使用 Bearer 凭证的 read 权限，只计算报价，不预留资金。

input 与 options 会合并后按模型 schema 校验，不接受 schema 未声明的参数；两者不能包含同名字段，缺省参数使用模型已发布的默认值。改变参数或数量后应重新报价。

素材与音色

asset_ids、voice_id 和 consent_attested 必须位于 input。它们也必须出现在所用模型的 schema 中。

• asset_ids：引用本人已上传或已归档的稳定资源 ID；上传步骤见上传源素材。
• voice_id：引用本人可用的平台音色 ID；音色绑定原供应商渠道。
• consent_attested：音色克隆必须为 true，表示已确认拥有使用该声音的权利。

供应商回调地址由平台生成，不支持通过模型输入覆盖平台接收地址。用户结果通知在开发页单独配置。

接受报价

报价返回 quote_id、model、resolved_model、price_version、quantity、unit、unit_price、estimated_amount、max_amount、expires_at。当前实现的 pricing_mode 为 fixed；所有金额是 CNY 十进制字符串。按 Token 等可变用量的封顶结算尚未开放。

POST /v1/tasks 需要 create 权限和 Idempotency-Key 请求头，JSON 仅包含 quote_id 与可选 title。title 去除首尾空白后为 1 至 200 字符。任务创建时锁定报价、预留资金，并返回 202。

{
  "quote_id": "YOUR_QUOTE_ID",
  "title": "夏日海报"
}

同一创作的网络重试必须同时保留原幂等键和原请求体。不要在超时后只换 quote_id 而继续用旧键，也不要换新键重复生成。确认是新的创作后才创建新的报价与幂等键。

接口契约

完整请求 schema、分页参数、鉴权和响应码见 OpenAPI。本页描述平台通用规则，具体图片、视频、语音和音乐的模型参数仍由实时目录决定。