跳转到正文MaoMaoToken
控制台

创建视频任务

请求端点

POST /v1/videos
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

请求参数

字段类型必填说明
modelstring是模型 ID(需在控制台已开通)
promptstring是视频内容描述提示词
secondsinteger是生成时长,必须为整数且在模型范围内
resolutionstring否输出清晰度,若填写需与模型规格一致
aspect_ratiostring否画幅比例(如 16:9);可用值取决于模型配置
referencesarray否参考素材列表,详见「参考素材要求」

请求示例

基础文生视频

{
  "model": "seedance2.0-Q-720p",
  "prompt": "一艘小船穿过清晨的薄雾,镜头从水面低角度跟拍,阳光逐渐照亮远处山峰。",
  "seconds": 5,
  "aspect_ratio": "16:9"
}

cURL 示例

curl https://api.maomaotoken.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-Q-720p",
    "prompt": "一艘小船穿过清晨的薄雾,镜头从水面低角度跟拍,阳光逐渐照亮远处山峰。",
    "seconds": 5,
    "aspect_ratio": "16:9"
  }'

响应

创建成功返回任务对象,其中 id 用于后续查询。任务通常处于 queued 或 in_progress 状态。

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "seedance2.0-Q-720p",
  "status": "queued",
  "progress": 0,
  "created_at": 1791000000
}

重要提示

  • 妥善保存响应中的 id,用于后续状态查询
  • 网络超时后不要立即重复创建请求,应先确认是否已创建
  • 创建成功仅表示任务已受理,不代表视频已经完成生成
  • 参考素材(若有)必须使用公网 HTTPS URL,视频参考不接受 Base64 格式
本页内容

On this page