POST
/
v1
/
videos
curl --request POST \
  --url https://suanwuyou.com.cn/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ratio": "16:9",
  "content": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference-image.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "text",
      "text": "让图片中的男人在木质房间中下象棋，能够看到正脸"
    }
  ],
  "duration": 5,
  "model": "doubao-seedance-2-0-260128",
  "prompt": "让图片中的男人在木质房间中下象棋，能够看到正脸",
  "resolution": "720p"
}
'
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "sora-v3-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1784246400,
  "seconds": "5",
  "size": "720p"
}
{
  "error": {
    "message": "请求参数不正确",
    "type": "invalid_request_error",
    "code": "invalid_parameter"
  }
}
{
  "error": {
    "message": "invalid api key",
    "type": "invalid_request_error",
    "code": "unauthorized"
  }
}
这是异步接口。提交成功只表示任务进入队列，请保存响应中的 id 或 task_id，再调用“查询视频任务”获取最终结果。
常用 model、prompt、seconds 和 video_config。video_config 中可设置 aspect_ratio 与 resolution_name。
除基础字段外，可使用 duration、ratio、resolution、content 和 generate_audio。参考素材可以使用素材接口返回的 content。
Kling 等模型可能通过 metadata 传入参考文件和输出配置。不同分组的模型能力可能不同，请以控制台和实际响应为准。

Seedance 2.0 示例

查看顶层 content、ratio、resolution 请求格式。

HappyHorse 示例

查看文生视频、首帧图生视频、参考生视频和视频编辑。

Authorizations

​
Authorization
string
header
default:Bearer sk-请输入算无忧令牌
required

填写完整的 Bearer 鉴权值，例如 Bearer sk-你的算无忧令牌。

Body

application/json
​
model
string
required

视频模型名，例如 sora-v3-fast、doubao-seedance-2.0-fast、Kling-3.0-Omni 或 sd2_manxue_720p。

Example:

"sora-v3-fast"

​
prompt
string
required

视频内容、镜头、动作和风格提示词。

Example:

"未来城市的飞行器掠过霓虹天际线，电影感运镜。"

​
seconds
string

视频时长；部分模型建议使用字符串。

Example:

"5"

​
duration
integer

视频时长兼容字段。

​
size
string

OpenAI 兼容尺寸字段。

​
video_config
object

Sora 风格输出配置。

​
reference_images
string<uri>[]

参考图片公网 URL 列表。

​
reference_videos
string<uri>[]

参考视频公网 URL 列表。

​
metadata
object

模型相关扩展参数，例如 resolution、ratio、content 或 output_config。

​
content
object[]

素材对象数组，可直接使用创建素材接口返回的 content。

​
ratio
string

Seedance 风格画幅比例。

​
resolution
string

Seedance 风格输出分辨率。

​
generate_audio
boolean

是否生成音频。

Response

任务已提交。

​
id
string
required
​
model
string
required
​
status
string
required

常见值：queued、processing、in_progress、completed、succeeded、failed、cancelled。

​
created_at
integer
required
​
task_id
string
​
object
string
Example:

"video"

​
progress
integer
Required range: 0 <= x <= 100
​
completed_at
integer | null
​
expires_at
integer | null
​
seconds
string
​
size
string
​
url
string<uri> | null
​
video_url
string<uri> | null
​
output
object
​
metadata
object
​
content
object
​
usage
object
​
error
object | null