创建视频生成任务

POST

/v1/contents/generations/tasks

curl --request POST \
  --url https://coder.api.visioncoder.cn/v1/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "model": "seedance-1-5-pro", "content": [ { "type": "text", "text": "一艘帆船驶过晨雾中的湖面，电影感运镜", "image_url": { "url": "https://example.com/reference.png" }, "video_url": { "url": "https://example.com/reference.png" }, "audio_url": { "url": "https://example.com/reference.png" }, "role": "reference_image" } ], "generate_audio": false, "ratio": "16:9", "duration": 5, "watermark": false }'

• Production

提交 Ark Seedance 兼容的视频生成任务。任务异步执行，创建成功后返回任务 ID。

Authorizations

• BearerAuth

Request Body^required

Media typeapplication/json

ArkVideoReq

Ark Seedance 兼容的视频生成请求。

object

model

required

视频生成模型 ID。可调用 GET /v1/models 获取当前可用模型。

string

Example

seedance-1-5-pro

content

required

多模态内容数组。至少传入一项。

Array<object>

>= 1 items

ArkContent

object

type

required

内容类型。

string

Allowed values: text image_url video_url audio_url

Example

text

text

提示词。type 为 text 时使用。

string

Example

一艘帆船驶过晨雾中的湖面，电影感运镜

image_url

ArkMediaUrl

object

url

Media URL (http/https).

string

Example

https://example.com/reference.png

video_url

ArkMediaUrl

object

url

Media URL (http/https).

string

Example

https://example.com/reference.png

audio_url

ArkMediaUrl

object

url

Media URL (http/https).

string

Example

https://example.com/reference.png

role

参考媒体的角色。

string

Allowed values: reference_image reference_video reference_audio

generate_audio

是否生成音频。

boolean

Example

false

ratio

输出视频的宽高比。

string

Allowed values: 16:9 9:16 1:1

Example

16:9

duration

输出视频时长，单位为秒。

integer format: int32

Example

5

watermark

是否添加水印。

boolean

Example

false

Responses

200

任务创建成功。使用返回的 id 查询任务状态。

Media typeapplication/json

ArkVideoResp

object

id

required

任务 ID。

string

model

required

执行任务的模型 ID。

string

status

required

任务状态。

string

Allowed values: queued running succeeded failed

content

ArkVideoResult

object

video_url

生成成功后返回的成品视频地址。

string

error

任务失败原因。status 为 failed 时可能返回。

string

created_at

required

任务创建时间，Unix 秒。

integer format: int64

updated_at

required

任务更新时间，Unix 秒。

integer format: int64

Example

{
  "id": "task_01JVIDEO9Q2W7X4K8",
  "model": "seedance-1-5-pro",
  "status": "queued",
  "content": {
    "video_url": "https://cdn.visioncoder.cn/videos/task_01JVIDEO/result.mp4"
  },
  "created_at": 1783742400,
  "updated_at": 1783742400
}

400

请求参数或模型无效。

401

API Key 缺失或无效。

403

当前账户或 API Key 无权执行请求。

429

请求频率超过限制。

500

服务或上游处理失败。