Skip to main content
POST
/
v1
/
video
/
seedance-2
Create Video Task
curl --request POST \
  --url https://api.loova.ai/api/v1/video/seedance-2 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance_2_0",
  "prompt": "A futuristic city at sunset",
  "function_mode": "omni_reference",
  "ratio": "16:9",
  "duration": 5,
  "image_urls": [],
  "audio_urls": [],
  "video_urls": []
}
'
{
  "code": 200,
  "trace_id": "45c30d76f06549b199a3775544523689",
  "message": null,
  "data": {
    "task_id": "record_id",
    "status": "running",
    "created_at": "2024-01-01T12:00:00Z",
    "credits_cost": 12
  }
}

​
Notes

  • Authentication: Authorization: Bearer <api_key>
  • A successful request returns a task_id
  • Use the returned task_id to query task status and retrieve the final result
  • Business-level failures may return the same code with different message values, so client logic should inspect message when needed

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Validation rules:

  • prompt is required
  • model, ratio, and function_mode must use supported values
  • duration must be between 4 and 15 seconds
  • When function_mode = first_last_frames, a maximum of 2 images is allowed
  • When function_mode = omni_reference, audio-only input is not allowed; at least one image or video must be included if audio is provided
​
prompt
string
required
​
model
enum<string>
default:seedance_2_0
Available options:
seedance_2_0,
seedance_2_0_fast
​
function_mode
enum<string>
default:omni_reference
Available options:
first_last_frames,
omni_reference
​
ratio
enum<string>
default:16:9
Available options:
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
​
duration
integer
default:5
Required range: 4 <= x <= 15
​
image_urls
string<uri>[]
Maximum array length: 9
​
audio_urls
string<uri>[]
Maximum array length: 3
​
video_urls
string<uri>[]
Maximum array length: 3

Response

Successful response

​
code
integer
​
trace_id
string
​
message
string | null
​
data
object