跳转到主要内容
POST
https://ai.kaiho.cc
/
v1
/
videos
/
generations
curl --location 'https://ai.kaiho.cc/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "城市霓虹灯下的雨夜街道",
    "aspect_ratio": "16:9"
}'
{
    "code": "success",
    "data": "task-wave1741000000000123456789"
}
本接口为异步调用。任务成功提交后会返回 task_id,您需要通过 查询任务状态 接口获取最终的生成结果。生成后的文件链接有效期为 24 小时。
curl --location 'https://ai.kaiho.cc/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "城市霓虹灯下的雨夜街道",
    "aspect_ratio": "16:9"
}'
{
    "code": "success",
    "data": "task-wave1741000000000123456789"
}

认证方式

在请求头中使用 API Key 进行身份验证。您可以在 API Key 管理 页面获取您的密钥。
Authorization: Bearer YOUR_API_KEY

请求参数

model
string
必填
模型名称,固定为 doubao-seedance-1-5-pro
prompt
string
必填
视频生成的提示词。
image_urls
array
图片输入。用于图生视频场景,可包含首帧和尾帧图片链接。
aspect_ratio
string
默认值:"16:9"
视频宽高比。
  • 16:9
  • 9:16
  • 1:1
duration
integer
视频生成时长。
audio
object
音频生成配置。支持在生成视频的同时生成环境音或配音。

响应参数

code
string
响应状态码 * success - 请求成功,任务已提交
data
string
任务 ID,格式为 task-wave{timestamp}{userId}{random},用于通过 查询任务状态 接口获取生成结果

使用示例

文本生成视频(带音频)
{
    "model": "doubao-seedance-1-5-pro",
    "prompt": "城市霓虹灯下的雨夜街道",
    "aspect_ratio": "16:9"
}

注意事项

  1. 异步处理: 视频生成通常需要数分钟。请记录返回的 data (任务 ID) 并轮询状态接口。
  2. 错误处理:
    • invalid_request: 请求参数无效。
    • authentication_error: 身份验证失败,请检查您的 API 密钥。
    • payment_required: 账户余额不足,请充值后再试。
    • quota_not_enough: 用户额度不足。
    • rate_limit_error: 请求过于频繁,请稍后再试。
    • server_error: 服务器内部错误,请稍后重试。
  3. 有效期: 生成后的视频文件链接有效期为 24 小时。