curl --request POST \
  --url https://api.aihubmax.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.0-reference-to-video",
  "prompt": "Reference @Image1 character styling, @Video1 camera movement rhythm, @Audio1 emotional atmosphere, generate a rainy night street performance video",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/motion.mp4"
  ],
  "audio_urls": [
    "https://example.com/music.mp3"
  ],
  "aspect_ratio": "adaptive",
  "duration": -1,
  "generate_audio": true
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-uyujaw3d",
  "model": "<string>",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "video"
}

{
  "error": {
    "message": "Invalid request format",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "message": "Insufficient account balance",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "message": "Parameter validation failed",
    "type": "validation_error"
  }
}

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "message": "Internal server error",
    "type": "server_error"
  }
}

{
  "error": {
    "message": "Service temporarily unavailable, please try again later",
    "type": "service_unavailable"
  }
}

Seedance

Seedance 2.0 Multimodal Reference to Video

Seedance 2.0 multimodal reference-to-video model, generate videos from reference images, videos, and audio
The standard version supports 480p / 720p / 1080p; Fast supports only 480p / 720p
Up to 9 reference images, 3 reference videos, and 3 reference audio clips, total not exceeding 12
Use @Image1, @Video1, @Audio1 etc. in the prompt to reference materials
Async processing mode, use the returned task ID to query task status
Generated video links are valid for 24 hours, please save them promptly

POST

videos

generations

curl --request POST \
  --url https://api.aihubmax.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.0-reference-to-video",
  "prompt": "Reference @Image1 character styling, @Video1 camera movement rhythm, @Audio1 emotional atmosphere, generate a rainy night street performance video",
  "image_urls": [
    "https://example.com/character.jpg"
  ],
  "video_urls": [
    "https://example.com/motion.mp4"
  ],
  "audio_urls": [
    "https://example.com/music.mp3"
  ],
  "aspect_ratio": "adaptive",
  "duration": -1,
  "generate_audio": true
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-uyujaw3d",
  "model": "<string>",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "video"
}

{
  "error": {
    "message": "Invalid request format",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}

{
  "error": {
    "message": "Insufficient account balance",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "message": "Parameter validation failed",
    "type": "validation_error"
  }
}

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "message": "Internal server error",
    "type": "server_error"
  }
}

{
  "error": {
    "message": "Service temporarily unavailable, please try again later",
    "type": "service_unavailable"
  }
}

Authorizations

Authorization

string

header

required

All APIs require Bearer Token authentication

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

string

default:seedance-2.0-reference-to-video

required

Seedance 2.0 multimodal reference-to-video model variant

seedance-2.0-reference-to-video — Standard
seedance-2.0-fast-reference-to-video — Fast

Examples:

"seedance-2.0-reference-to-video"

"seedance-2.0-fast-reference-to-video"

prompt

string

required

Text prompt describing the desired video content.

Notes:

Supports Chinese and English
Maximum 5000 characters

Required string length: 1 - 5000

Example:

"A corgi running on a rain-soaked street, cinematic shot"

resolution

string

default:720p

Output video resolution. The standard model supports 480p / 720p / 1080p; Fast models support only 480p / 720p.

Examples:

"480p"

"720p"

"1080p"

aspect_ratio

string

default:adaptive

Output video aspect ratio

Options:

16:9, 4:3, 1:1, 3:4, 9:16, 21:9
adaptive — Automatically selected by model (default)

Example:

"adaptive"

duration

integer

default:5

Output video duration in seconds. Supports integers from 4 to 15, or -1 to let the model decide. Default 5.

Example:

-1

generate_audio

boolean

default:true

Whether to generate synchronized audio. Default true.

Example:

true

seed

integer

default:-1

Random seed. -1 means auto-generated by model; a fixed integer improves result reproducibility.

Example:

-1

image_urls

string[]

Reference image URL list

Notes:

Up to 9 images, each ≤30MB
Supports JPEG / PNG / WebP
Use @Image1, @Image2 etc. in the prompt to reference

Example:

[
  "https://example.com/ref1.jpg",
  "https://example.com/ref2.jpg"
]

video_urls

string[]

Reference video URL list

Notes:

Up to 3 clips, total duration 2-15 seconds, total size <50MB
Supports MP4 / MOV
Use @Video1, @Video2 etc. in the prompt to reference

Example:

["https://example.com/motion.mp4"]

audio_urls

string[]

Reference audio URL list

Notes:

Up to 3 clips, each ≤15 seconds / 15MB
Supports MP3 / WAV
Use @Audio1, @Audio2 etc. in the prompt to reference
When only audio is provided, at least 1 reference image or video is also required

Example:

["https://example.com/music.mp3"]

Response

Task created successfully

created

integer

Task creation timestamp

Example:

1757165031

string

Task ID

Example:

"task-unified-1757165031-uyujaw3d"

model

string

Actual model name used

object

enum<string>

Specific task type

Available options:

video.generation.task

progress

integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100

Example:

0

status

enum<string>

Task status

Available options:

pending,

processing,

completed,

failed

Example:

"pending"

task_info

object

Asynchronous task information

Show child attributes

type

enum<string>

Task output type

Available options:

video

Example:

"video"

Image Series

Video Series

Audio Series

Text Series

Document Processing

Task Management

File Management

Seedance 2.0 Multimodal Reference to Video

Authorizations

All APIs require Bearer Token authentication

Body

Response