Seedance 1.5 Pro

Seedance 1.5 Pro generates videos from text, a first-frame image, or first-and-last-frame images. The generation mode is selected automatically from the number of images in input.image_urls.

Model

Model Name	Duration	Resolution	Aspect Ratios
`doubao-seedance-1.5-pro`	4-12s	480p, 720p, 1080p	16:9, 4:3, 1:1, 3:4, 9:16, 21:9

Pricing

Formula-based billing: duration × per_second. The rate depends on resolution and whether generate_audio is enabled.

Resolution	No Audio	With Audio
480p	3 credits/s	7 credits/s
720p	7 credits/s	14 credits/s
1080p	15 credits/s	30 credits/s

Examples:

720p, 5s, with audio: 14 × 5 = 70 credits
1080p, 8s, no audio: 15 × 8 = 120 credits
480p, 12s, with audio: 7 × 12 = 84 credits

Create Task

POST https://api.aivideoapi.ai/v1/videos/generations

Request Body

Field	Type	Required	Description
`model`	string	Yes	Must be `doubao-seedance-1.5-pro`
`input`	object	Yes	Generation parameters, see below
`callback_url`	string	No	URL to receive task completion/failure notifications

Input Object

Field	Type	Required	Description
`prompt`	string	Yes	Text description for the video
`image_urls`	string[] \| object[]	No	0 images = text-to-video, 1 image = first-frame image-to-video, 2 images = first-and-last-frame image-to-video
`duration`	integer	No	Video duration in seconds: 4-12 (default: 5)
`aspect_ratio`	string	No	`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9` (default: `16:9`). `ratio` is also accepted as an alias
`resolution`	string	No	`480p`, `720p`, or `1080p` (default: `720p`)
`generate_audio`	boolean	No	Generate synchronized audio (default: `true`)
`watermark`	boolean	No	Add watermark (default: `false`)
`camera_fixed`	boolean	No	Request a fixed camera (default: `false`). See Camera Fixed
`seed`	integer	No	Random seed. Range: [-1, 4294967295]

video_urls, audio_urls, generation_type, web_search, and return_last_frame are not supported by this model.

Generation Modes

`image_urls` count	Mode	Behavior
0	Text-to-video	Generates video from `prompt` only
1	First-frame image-to-video	Uses the image as the first frame
2	First-and-last-frame image-to-video	Uses the first image as the first frame and the second image as the last frame

Image URLs Format

image_urls supports string arrays and object arrays:

"image_urls": [
  "https://example.com/first-frame.jpg",
  "https://example.com/last-frame.jpg"
]

"image_urls": [
  { "url": "https://example.com/first-frame.jpg" },
  { "url": "https://example.com/last-frame.jpg" }
]

Only public HTTP(S) image URLs are supported.

Examples

Text-to-Video

curl -X POST https://api.aivideoapi.ai/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1.5-pro",
    "callback_url": "https://your-server.com/webhook",
    "input": {
      "prompt": "A girl walking through a neon city at night, cinematic camera movement",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true
    }
  }'

First-Frame Image-to-Video

curl -X POST https://api.aivideoapi.ai/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1.5-pro",
    "input": {
      "prompt": "The camera slowly pushes in. The character smiles and turns toward the light.",
      "image_urls": [
        "https://example.com/first-frame.jpg"
      ],
      "duration": 8,
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "generate_audio": true
    }
  }'

First-and-Last-Frame Image-to-Video

curl -X POST https://api.aivideoapi.ai/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-1.5-pro",
    "input": {
      "prompt": "Animate the transition from the first frame to the final frame with a smooth cinematic move.",
      "image_urls": [
        { "url": "https://example.com/first-frame.jpg" },
        { "url": "https://example.com/last-frame.jpg" }
      ],
      "duration": 8,
      "aspect_ratio": "9:16",
      "resolution": "1080p",
      "generate_audio": false
    }
  }'

Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "cbf6b69d-4f03-4817-8ed7-94c0292184a8"
  }
}

Query Task

curl https://api.aivideoapi.ai/v1/tasks/{taskId} \
  -H "Authorization: Bearer sk-your-api-key"

Status transitions: pending -> processing -> completed or failed.

Completed

{
  "id": "7d89c51e-9430-410e-909e-df347131ebaa",
  "status": "completed",
  "model": "doubao-seedance-1.5-pro",
  "created_at": 1774790227,
  "completed_at": 1774796529,
  "output": {
    "urls": [
      "https://file.aivideoapi.ai/videos/2026/07/04/abc.mp4"
    ],
    "metadata": {
      "seed": 41485,
      "ratio": "16:9",
      "duration": 5,
      "resolution": "720p",
      "generate_audio": true,
      "framespersecond": 24
    }
  }
}

Video URLs may expire. Download promptly after generation completes.

Callback

Pass callback_url when creating the task. The system will send a POST request to your URL when the task completes or fails.

See Callback Guide for request headers and retry behavior.

Parameters

Duration

Integer, unit: seconds. Default: 5.

Range: 4-12
Duration affects billing

Aspect Ratio

Default: 16:9.

Supported values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.

Seed

Integer.

Range: integer in [-1, 4294967295]
The actual seed used is returned in output.metadata.seed

Camera Fixed

Boolean. Default: false.

Value	Description
`true`	Request a fixed camera. The platform appends fixed-camera guidance to the prompt, but the actual result is not guaranteed.
`false`	Do not request a fixed camera.

Error Codes

When a request fails, the API returns a JSON error response:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your credit balance is too low. Please top up.",
    "type": "billing_error"
  }
}

Error Reference

HTTP Status	Code	Type	Description
400	`invalid_request`	invalid_request_error	Missing or invalid parameters
401	`invalid_api_key`	authentication_error	API key is invalid, disabled, or deleted
402	`insufficient_credits`	billing_error	Credit balance too low, please top up
403	`ip_not_allowed`	permission_error	Request IP not in the key's allowlist
404	`model_not_found`	invalid_request_error	Model does not exist or is inactive
404	`task_not_found`	invalid_request_error	Task ID does not exist
429	`rate_limit_exceeded`	rate_limit_error	Too many requests, please slow down
429	`spend_limit_exceeded`	billing_error	Key spend limit reached (hourly/daily/total)
500	`internal_error`	api_error	Unexpected server error
503	`upstream_error`	upstream_error	Upstream AI provider returned an error

Common Scenarios

invalid_request (400)

Returned when required fields are missing or invalid.

{
  "error": {
    "code": "invalid_request",
    "message": "'model' is required.",
    "type": "invalid_request_error"
  }
}

insufficient_credits (402)

Your balance is too low. Check your balance with GET /v1/credits and top up in Dashboard > Billing.

invalid_api_key (401)

Possible causes:

The key does not start with sk-
The key has been disabled or deleted
The user account has been banned

upstream_error (503)

The upstream AI provider returned an error. This may happen when:

The input contains sensitive or prohibited content
The provider is temporarily unavailable
The request parameters are not supported by the provider

Credits are automatically refunded when a task fails due to upstream errors.