메인 콘텐츠로 건너뛰기
POST
/
seedance
/
videos
Seedance Videos
curl --request POST \
  --url https://api.acedata.cloud/seedance/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-0-pro-250528",
  "content": [
    {
      "type": "text",
      "text": "A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --wm true --seed 11 --cf false"
    }
  ]
}
'
{
  "success": true,
  "task_id": "93f11baf-347b-4bb4-9520-8653cb46d6a3",
  "trace_id": "a9063166-26ed-4451-85b5-54e896817c69",
  "data": [
    {
      "id": "cgt-2025******-***",
      "model": "doubao-seedance-1-0-pro-250528",
      "status": "succeeded",
      "content": {
        "video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-1-0-pro/****"
      },
      "seed": 10,
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5,
      "framespersecond": 24,
      "service_tier": "default",
      "execution_expires_after": 172800,
      "usage": {
        "completion_tokens": 108900,
        "total_tokens": 108900
      },
      "created_at": 1743414619,
      "updated_at": 1743414673
    }
  ]
}

인증

​
Authorization
string
header
필수

API token from https://platform.acedata.cloud

헤더

​
accept
enum<string>

Specifies the format of the response from the server. If not specified, the default format is application/json.

사용 가능한 옵션:
application/json

본문

application/json
​
model
enum<string>
필수

Model ID to be used for video generation

사용 가능한 옵션:
doubao-seedance-1-0-pro-250528,
doubao-seedance-1-0-pro-fast-251015,
doubao-seedance-1-5-pro-251215,
doubao-seedance-1-0-lite-t2v-250428,
doubao-seedance-1-0-lite-i2v-250428
예시:

"doubao-seedance-1-0-pro-250528"

​
content
object[]
필수

Input content for video generation. Each item MUST contain either 'text' or 'image_url', but not both. The presence and meaning of other fields depend on the 'type'.

예시:
{
  "type": "text",
  "text": "A kitten yawning at the camera. --rs 720p --rt 16:9 --dur 5 --fps 24 --wm true --seed 11 --cf false"
}
​
resolution
enum<string>

Video resolution. Default depends on the model: 720p for most models, 480p for lite models.

사용 가능한 옵션:
480p,
720p,
1080p
​
ratio
enum<string>
기본값:16:9

Aspect ratio of the generated video

사용 가능한 옵션:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9,
adaptive
​
duration
number

Duration of the generated video in seconds. Mutually exclusive with 'frames'.

필수 범위: 2 <= x <= 12
​
frames
integer

Frame count for the generated video. Must satisfy 25+4n (e.g. 29, 33, 37, ..., 289). Mutually exclusive with 'duration'.

필수 범위: 29 <= x <= 289
​
seed
integer

Random seed for reproducible generation. -1 for random.

필수 범위: -1 <= x <= 4294967295
​
camerafixed
boolean

Whether to fix the camera position during generation

​
watermark
boolean

Whether to add a watermark to the generated video

​
generate_audio
boolean
기본값:false

Whether to generate audio for the video. Only supported by doubao-seedance-1-5-pro-251215. Other models will ignore this parameter.

​
callback_url
string<uri>

Callback URL for receiving the final task result notification. When provided, the API returns immediately with a task_id and posts the result to this URL upon completion.

​
return_last_frame
boolean
기본값:false

Whether to return the last frame of generated video

​
service_tier
enum<string>
기본값:default

Service level type for processing this request

사용 가능한 옵션:
default,
flex
​
execution_expires_after
integer
기본값:172800

Task timeout threshold in seconds

필수 범위: 3600 <= x <= 259200

응답

OK, the request is successful.

The response is of type object.