Skip to main content
POST
/
kyyAiPower
/
v1
/
seedance
/
videos
curl --request POST \
--url https://zcbservice.aizfw.cn/kyyAiPower/v1/seedance/videos \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance_1_5_pro_720p",
"content": [
{
"type": "text",
"text": "A cat yawning at the camera"
}
],
"ratio": "16:9",
"duration": 5,
"generate_audio": true
}'

{
    "id": "video_abc123def456",
    "object": "video",
    "created": 1761635478,
    "model": "seedance_1_5_pro_720p",
    "status": "queued"
}

​
Seedance Create Video Task

Create high-quality video generation tasks using Volcano Engine Seedance (即梦) AI model, supporting text-to-video, image-to-video (first frame/first and last frames), and more.

​
Authentication

All requests require a Bearer token in the request header: 
Authorization: Bearer {{YOUR_API_KEY}}

​
Supported Models

​
Seedance 1.5 Series (Billed by Second)

480p

seedance_1_5_pro_480pSupports audio generation, image-to-video

720p

seedance_1_5_pro_720pSupports audio generation, image-to-video

1080p

seedance_1_5_pro_1080pSupports audio generation, image-to-video

​
Seedance 2.0 Series (Billed per Task)

1-5 seconds

seedance_2_0_4s_5sSupports image-to-video, text-to-video

6-10 seconds

seedance_2_0_6s_10sSupports image-to-video, text-to-video

11-15 seconds

seedance_2_0_11s_15sSupports image-to-video, text-to-video

​
Request Parameters

​
model
string
required
Model name, see supported models list above
​
content
array
required
Input content array, supports text and image formats. See content array structure below
​
ratio
string
Video aspect ratioOptions: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
Default values:
  • Text-to-video: 16:9 (Seedance 1.5 Pro uses adaptive)
  • Image-to-video: adaptive
​
duration
integer
Video duration in seconds, supports 2-12 seconds, defaults to 5
Seedance 1.5 pro special notes:
  • Specific duration: Integer from 4-12 seconds
  • Auto-select duration: Set to -1, model automatically selects 4-12 seconds

​
Content Array Structure

​
Text Content Object

​
type
string
required
Fixed value: text
​
text
string
required
Text prompt, Chinese up to 500 characters, English up to 1000 words
Example: 
{
  "type": "text",
  "text": "A cat yawning at the camera"
}

​
Image Content Object

​
type
string
required
Fixed value: image_url
​
image_url.url
string
required
Image URL
​
role
string
Image role, choose based on use case:
  • first_frame or omit - First frame image (image-to-video with first frame)
  • last_frame - Last frame image (image-to-video with first and last frames)
  • reference_image - Reference image (Seedance 1.0 lite i2v, 1-4 images)
Image Requirements:
  • Format: jpeg, png, webp, bmp, tiff, gif (Seedance 1.5 pro supports heic, heif)
  • Aspect ratio: (0.4, 2.5)
  • Dimensions: (300px, 6000px)
  • Size: < 30 MB
Example: 
{
  "type": "image_url",
  "image_url": {
    "url": "https://example.com/image.jpg"
  },
  "role": "first_frame"
}

​
Response Parameters

​
id
string
Video generation task ID, stored for 7 days, used for querying task status
​
object
string
Object type, fixed as video
​
created
integer
Task creation timestamp
​
model
string
Model name used
​
status
string
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
  • cancelled - Cancelled

​
Use Cases

Text-to-Video

Generate video using only text prompts

Image-to-Video (First Frame)

Use 1 image as first frame, combined with text to generate video

Image-to-Video (First & Last)

Use 2 images as first and last frames to control video start and end

​
Important Notes

Important Limitations:
  • Image scenarios are mutually exclusive: first frame, first and last frames, and reference images cannot be mixed
  • Audio generation is only supported by Seedance 1.5 pro series
  • Task IDs are stored for 7 days, please save generated videos promptly
Best Practices:
  1. Video generation is asynchronous, use the returned id to query task status and results
  2. Choose appropriate resolution and duration to balance quality and cost
  3. For image-to-video, image quality directly affects generation results
curl --request POST \
--url https://zcbservice.aizfw.cn/kyyAiPower/v1/seedance/videos \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
"model": "seedance_1_5_pro_720p",
"content": [
{
"type": "text",
"text": "A cat yawning at the camera"
}
],
"ratio": "16:9",
"duration": 5,
"generate_audio": true
}'

{
    "id": "video_abc123def456",
    "object": "video",
    "created": 1761635478,
    "model": "seedance_1_5_pro_720p",
    "status": "queued"
}