跳转到主要内容
POST
/
api
/
v3
/
contents
/
generations
/
tasks
curl --request POST \
  --url https://api.aiid.edu.kg/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-0-lite-i2v-250428",
  "mode": "reference_material",
  "prompt": "测试文字",
  "content": [
    {
      "type": "text",
      "text": "测试文字"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/image/9979f1a754b3571d5e8bdcc397eedf53.png"
      },
      "role": "reference_image",
      "name": "1"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/1979f1a754b3571d5e8bdcc397eedf53.mp4"
      },
      "role": "reference_video",
      "name": "2"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://imageproxy.zhongzhuan.chat/api/proxy/video/3979f1a754b3571d5e8bdcc397eedf53.mp3"
      },
      "role": "reference_audio",
      "name": "3"
    }
  ],
  "duration": 5,
  "size": "1280x720"
}
'
{
  "id": "task_xxx",
  "created_at": "<string>",
  "items": "<string>"
}

授权

Authorization
string
header
必填

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

请求体

application/json
model
enum<string>
必填

必填。模型名称。可传 Seedance 对外模型,也可传 gemini-omni

可用选项:
doubao-seedance-1-0-lite-i2v-250428,
doubao-seedance-1-0-lite-t2v-250428,
doubao-seedance-1-0-pro-250528,
doubao-seedance-1-0-pro-fast-251015,
doubao-seedance-1-5-pro-251215,
doubao-seedance-2-0-260128,
doubao-seedance-2-0-fast-260128,
gemini-omni
示例:

"doubao-seedance-2-0-260128"

prompt
string
必填

必填。视频生成主描述,不能为空。

示例:

"参考素材生成一段剧情短视频"

content
object[]

可选。火山方舟 content 数组,按顺序混排文本与素材项。文本项使用 { "type": "text", "text": "..." };图片、视频、音频项分别使用 image_urlvideo_urlaudio_url 对象并在其中放 url,可配合 role(如 reference_imagereference_videoreference_audio)和 name 供文本引用。

function_mode
string

可选。高级功能模式,如 omni_reference 用于全能参考。

mode
string

可选。兼容模式字段,如 t2vi2vi2v_first_lastreference_imagesreference_materialgemini-omni 支持 t2vr2vedit

image_url
string

可选。单张参考图 URL。

image_urls
string[]

可选。多张参考图 URL 列表。

input_reference
string

可选。兼容参考输入字段。

end_image_url
string

可选。末帧参考图 URL。

last_image_url
string

可选。末帧参考图 URL 别名。

video_urls
string[]

可选。参考视频 URL 列表。

audio_urls
string[]

可选。参考音频 URL 列表。

seconds

可选。视频时长,秒;与 duration 兼容。

duration

可选。视频时长,秒;与 seconds 兼容。

aspect_ratio
string

可选。画幅比例,如 16:9

ratio
string

可选。画幅比例别名,如 16:9

size
string

可选。分辨率或尺寸兼容字段。

quality
string

可选。生成质量配置。

resolution
string

可选。输出分辨率。

fps
number

可选。帧率。

generate_audio
boolean

可选。是否生成音频。

watermark
boolean

可选。是否添加水印。

响应

200 - application/json

任务创建成功

id
string
必填

任务 ID。

示例:

"task_xxx"

status
enum<string>

任务状态。

可用选项:
queued,
running,
succeeded,
failed
created_at
string

创建时间(Unix 秒)。

items
string