Model ID

seedance-2-5-260628

Calling method: async

seedance-2-5-260628 API Usage Guide

Overview

seedance-2-5-260628 is the latest-generation Dreamina Seedance video generation model, supporting text-to-video and image-to-video workflows with rich reference inputs including images, videos, audios, and pre-uploaded avatar assets.

Key Features

Text-to-Video & Image-to-Video: Supports pure text prompts with optional first/last frame anchoring
Flexible Duration: 4-15 seconds of generated video
Resolutions: 480p and 720p outputs
Flexible Aspect Ratios: Standard, cinematic, and adaptive ratios
Audio Generation: Optional audio synthesis alongside video
Web Search: Grounded generation using live web search
Rich References: Reference images, videos, audios, and avatar asset IDs
Reproducibility: Seed parameter ensures deterministic output
Watermark Control: Choose whether to embed a watermark

Authentication

All API requests require authentication using an API key. Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Submit Video Generation Request

Base URL

https://console.gmicloud.ai

Endpoint

POST /api/v1/ie/requestqueue/apikey/requests

Request Format

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5-260628",
    "payload": {
      "prompt": "A lone astronaut walks across a crimson Martian landscape at sunset.",
      "first_frame": "https://example.com/frame.jpg",
      "duration": 8,
      "resolution": "720p",
      "ratio": "16:9",
      "seed": 42,
      "watermark": false,
      "generate_audio": true,
      "web_search": false
    }
  }'

Request Parameters

Parameter	Type	Required	Description	Default	Constraints
`prompt`	string	Yes	Text description of the video	`""`	Required
`duration`	integer	No	Duration in seconds	`5`	4-15
`resolution`	enum	No	Output resolution	`"720p"`	`"480p"`, `"720p"`
`ratio`	enum	No	Aspect ratio	`"16:9"`	`"16:9"`, `"4:3"`, `"1:1"`, `"3:4"`, `"9:16"`, `"21:9"`, `"adaptive"`
`seed`	integer	No	Random seed for reproducibility	`null`	0-4294967295
`watermark`	boolean	No	Whether to embed a watermark	`false`	true / false
`generate_audio`	boolean	No	Whether to synthesize audio	`true`	true / false
`web_search`	boolean	No	Whether to enable web search grounding	`false`	true / false
`first_frame`	image	No	First frame image for I2V	`""`	Publicly accessible URL
`last_frame`	image	No	Last frame image for I2V	`""`	Publicly accessible URL
`reference_images`	array	No	Reference images (URLs)	`[]`	Up to 9 publicly accessible URLs
`reference_videos`	array	No	Reference videos (URLs)	`[]`	Up to 3 publicly accessible URLs
`reference_audios`	array	No	Reference audio files (URLs)	`[]`	Up to 3 publicly accessible URLs
`avatar_asset_ids`	array	No	Pre-uploaded avatar asset IDs	`[]`	Array of asset ID strings

Response

{
  "request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12",
  "model": "seedance-2-5-260628",
  "status": "queued",
  "created_at": 1750442925,
  "updated_at": 1750442925,
  "queued_at": 1750442925
}

Check Request Status

Endpoint

GET /api/v1/ie/requestqueue/apikey/requests/{request_id}

Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/c1c5a812-3c44-4c77-b02c-91c934abcd12" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12",
  "org_id": "your-org-id",
  "model": "seedance-2-5-260628",
  "status": "success",
  "payload": {
    "prompt": "A lone astronaut walks across a crimson Martian landscape at sunset.",
    "duration": 8,
    "resolution": "720p",
    "ratio": "16:9",
    "seed": 42,
    "watermark": false,
    "generate_audio": true
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/generated-video.mp4",
    "thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg"
  },
  "created_at": 1750442925,
  "updated_at": 1750442930,
  "queued_at": 1750442925
}

Request Status Values

Status	Description
`queued`	Request is waiting to be processed
`processing`	Video generation is in progress
`success`	Video generation completed successfully
`failed`	Video generation failed
`cancelled`	Request was cancelled

List Your Requests

Endpoint

GET /api/v1/ie/requestqueue/apikey/requests?model_id=seedance-2-5-260628

Get Model Information

Endpoint

GET /api/v1/ie/requestqueue/apikey/models/seedance-2-5-260628

Tips for Better Results

Detailed Prompts: More descriptive text yields better visuals
Use First/Last Frame: Anchor the start and end for tighter I2V consistency
Adaptive Ratio: Use adaptive to let the model choose the best ratio for your content
Seeds for Control: Use a fixed seed for reproducible outputs
Audio Sync: Enable generate_audio for immersive, sound-matched videos
Reference Videos: Supplying a reference video guides motion and timbre, and is priced differently from a text-only generation

Examples

Text-to-Video

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5-260628",
    "payload": {
      "prompt": "A thunderstorm rolls over a medieval castle at night, lightning illuminating stone towers",
      "duration": 12,
      "resolution": "720p",
      "ratio": "21:9",
      "generate_audio": true
    }
  }'

Image-to-Video with First and Last Frame

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5-260628",
    "payload": {
      "prompt": "The flower slowly blooms, petals unfurling in morning light",
      "first_frame": "https://example.com/bud.jpg",
      "last_frame": "https://example.com/bloom.jpg",
      "duration": 6,
      "resolution": "720p",
      "ratio": "1:1",
      "generate_audio": false
    }
  }'

With Reference Assets

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5-260628",
    "payload": {
      "prompt": "The character walks through a neon-lit alley",
      "avatar_asset_ids": ["asset-id-abc123"],
      "reference_images": ["https://example.com/style-ref.jpg"],
      "duration": 10,
      "resolution": "720p",
      "ratio": "adaptive"
    }
  }'

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

seedance-2-5-260628

seedance-2-5-260628 API Usage Guide

Overview

Key Features

Authentication

Submit Video Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Get Model Information

Endpoint

Tips for Better Results

Examples

Text-to-Video

Image-to-Video with First and Last Frame

With Reference Assets

​seedance-2-5-260628 API Usage Guide

​Overview

​Key Features

​Authentication

​Submit Video Generation Request

​Base URL

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Example

​Response

​Request Status Values

​List Your Requests

​Endpoint

​Get Model Information

​Endpoint

​Tips for Better Results

​Examples

​Text-to-Video

​Image-to-Video with First and Last Frame

​With Reference Assets

seedance-2-5-260628 API Usage Guide

Overview

Key Features

Authentication

Submit Video Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Get Model Information

Endpoint

Tips for Better Results

Examples

Text-to-Video

Image-to-Video with First and Last Frame

With Reference Assets