模型服务 API 文档

Seedance2.0

视频模型服务。请在用户控制台创建并授权 API Key 后调用。

已发布视频视觉

服务摘要

模型 IDSeedance2.0

模型类型视频

计费方式按秒计费

认证

所有请求均须携带用户控制台“Token 令牌管理”中创建的 API Key。API Key 的模型范围、有效期、IP 网段和额度限制由创建时的 Token 配置决定。

请求头

Authorization: Bearer <API Key>

获取 API Key

前往用户控制台创建 Token，并在模型授权范围中包含当前模型。

安全提示不要在浏览器前端代码、公开仓库或截图中暴露 API Key。API Key 泄露后请立即在用户控制台停用。

统一 API 地址

推荐直接使用统一入口。网关会读取请求中的 model，并按当前发布模型类型自动路由到对话、图片、视频、向量、重排序或音频等内部标准接口。

POST

https://model.wlaicloud.com/v1/

统一入口调用示例

以下示例使用当前模型的真实发布名称。请将 <API Key> 替换为您在用户控制台创建的 Key。

curl 示例

curl 'https://model.wlaicloud.com/v1/' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <API Key>' \
  -d '{"model":"Seedance2.0","input":{"prompt":"清晨的海面，镜头缓慢推进","media":[]}}'

请求示例

{
  "model": "Seedance2.0",
  "input": {
    "prompt": "清晨的海面，镜头缓慢推进",
    "media": []
  }
}

标准兼容接口

统一入口适用于大多数接入场景。若现有服务或 SDK 依赖标准接口，也可以使用以下路径；仅应调用与当前模型类型匹配的接口。

POST

https://model.wlaicloud.com/v1/videos/generations

视频生成通常为异步任务：通过统一入口提交后取得 task_id，再使用 GET https://model.wlaicloud.com/v1/?model=Seedance2.0&task_id={task_id} 查询任务结果。

请求参数

参数	类型	说明
`model`必填	string	当前页面展示的模型 ID。
`input.prompt`	string	视频生成提示词。
`input.media`	array	可选参考媒体；不同模型支持能力不同。
`parameters`	object	可选生成参数，如分辨率、时长、比例。

常见错误

状态码	原因	处理建议
`401`	未提供、无效或已停用 API Key	检查 Authorization 请求头，或在用户控制台重新创建 Token。
`403`	Token 未授权当前模型、IP 不在允许网段或账号不可用	检查 Token 的模型范围、IP 限制和状态。
`400`	模型类型与调用接口不匹配或参数不符合要求	确认请求体包含正确的 model；推荐改用统一入口 /v1/。
`429`	超过并发、速率或额度限制	降低并发并重试，或在用户控制台调整 Token 配额。
`5xx`	网关或上游模型服务暂时不可用	保留响应中的 request id，稍后采用退避策略重试。