使用指南
模型广场与计费
选择模型、理解价格卡片、确认能力与可用性
模型广场与计费
模型广场是选择模型和了解调用价格的入口，展示平台当前可公开提供的模型目录。实际可调用范围仍由 API Key 所属调用分组和实时可用状态决定。
如何选择模型
- 按名称搜索，或按模型品牌、能力和接口类型筛选；
- 打开详情，确认模型支持的接口、可用分组和价格类型；
- 用
GET /v1/models确认该 Key 可见的模型 ID； - 在业务后端使用返回的模型 ID 发起请求。
模型目录字段
GET /v1/models 返回当前 Key 可调用的模型，字段说明如下：
| 字段 | 类型 | 说明 |
|---|---|---|
data[].id | string | 模型 ID，提交请求时原样填写 |
data[].object | string | 固定为 model |
data[].created | integer | 目录记录时间（Unix 秒） |
data[].owned_by | string | 模型的提供方标识，仅供参考 |
data[].supported_endpoint_types | string[] | 该模型可用的接口类型 |
模型目录只用于确认「这个 Key 能不能调用这个模型」，具体参数限制（参考图数量、输入视频规格、输出时长与清晰度等）以模型详情页和接口返回的参数错误为准。平台不会替模型猜测参数，也不会在不支持的参数上静默降级。
价格卡片怎么读
| 展示 | 含义 |
|---|---|
| 输入 / 输出 | 按输入和输出 Token 分别计费，单位显示为 1K 或 1M Token。 |
| 缓存输入 / 缓存写入 | 只有支持提示词缓存的模型才会显示。 |
| 按次 | 每次成功请求按固定价格计费。 |
| 视频按量计费 | 视频模型按当前生效价格展示；未提供价格的分辨率、时长或模式不显示。 |
价格展示用于估算，实际扣费以请求实际使用量、请求所属分组和服务端账单记录为准。
视频模型
doubao-seedance 和 seedance 系列会显示独立的价格矩阵，按「是否含视频输入」和「输出分辨率」拆分，支持的单元格给出视频费用，不支持的组合明确显示「不支持」。
阅读矩阵时，先确定本次是否提交视频输入，再选择需要的分辨率。例如只上传文字或图片参考时应看「不含视频输入」一栏；提交视频作为输入时应看「含视频输入」一栏。不要根据相邻档位推测未展示的价格或能力。
调用前请确认：
- 模型 ID 出现在你的
/v1/models响应中； - 请求使用视频接口
/v1/video/generations，而不是文本接口； - 参考图或参考视频符合该模型的公开参数要求；
- 业务端为异步任务保存并轮询返回的任务 ID。
素材引用与模型
素材入库与模型无关：素材只需要入库一次，平台会按当前模型准备对应的素材引用。同一个素材 ID 可以在不同模型之间直接切换使用，切换模型只需要改请求里的 model 字段。
哪些模型共用同一套素材库、以及真人素材支持哪些模型，见素材库接口。
计费与账单
模型广场展示的是价格说明，不等于最终结算金额。文本模型通常按实际输入、输出和缓存用量结算；图片、音频或视频模型可能按次、按时长或按模型定义的计量单位结算。
视频等异步任务在完成时结算：提交成功只受理任务，不会预先扣费，任务完成后账单里只出现一条实际扣费记录。提交前平台会校验账户余额（或当前 API Key 额度）是否覆盖本次预估，不足时会直接返回可读提示，不会创建任务。任务完成后可在钱包或用量记录中核对模型、时间、请求 ID 和实际扣费。
参数校验失败（HTTP 400）表示请求未被受理，通常不会产生生成任务费用；已返回任务 ID 后的计费、失败和退款规则按该模型与平台价格配置处理。
可用性变化
模型卡片不显示或 /v1/models 中不存在某个模型，表示它当前不属于该 Key 的可用目录，请切换同类模型，不要在客户端写死已不可用的模型名称。
「无可用渠道」「模型暂不可用」表示当前时段无法路由到该模型，不代表 API Key 格式错误。先刷新模型列表或切换同类模型；持续不可用时再联系平台支持并提供请求 ID。