Model ID

seedance-1-0-pro-250528

seedance-1-0-pro-250528 API Usage Guide

Overview

seedance-1-0-pro-250528 is a professional-grade video generation model that supports both text-to-video and image-to-video workflows. It is designed for flexible, high-quality video synthesis with customizable duration, resolution, aspect ratio, and camera behavior. This model is ideal for creators who need cinematic, controllable outputs with reproducibility via seeds.

Key Features

Text-to-Video & Image-to-Video: Supports pure text prompts and optionally an initial first frame
Flexible Duration: 3–12 seconds of generated video
Multiple Resolutions: 480p, 720p, or 1080p outputs
Aspect Ratios: Standard and cinematic ratios supported (16:9, 9:16, 21:9, etc.)
Camera Controls: Option to fix or allow camera motion
Reproducibility: Seed parameter ensures deterministic output
Watermark Control: Choose whether to embed 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-1-0-pro-250528",
    "payload": {
      "prompt": "The head gradually rises, revealing the climber`s back.",
      "first_frame": "https://storage.googleapis.com/gmi-video-assests-prod/public-assets/person-walking-winter-snow-boots-1193959625-770x533-1_jpg.jpeg",
      "duration": 8,
      "resolution": "720p",
      "ratio": "16:9",
      "camerafixed": false,
      "seed": 42,
      "watermark": false
    }
  }'

Request Parameters

Parameter	Type	Required	Description	Default	Constraints
`prompt`	string	Yes	Text description with optional flags like `--ratio`, `--resolution`, `--duration`, `--camerafixed`	""	Required
`duration`	integer	No	Duration in seconds	5	3–12
`resolution`	enum	No	Output resolution	”720p”	Options: `"480p"`, `"720p"`, `"1080p"`
`ratio`	enum	No	Aspect ratio of output	”16:9”	Options: `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"`, `"21:9"`, `"1:1"`
`camerafixed`	boolean	No	Whether camera stays fixed	false	true / false
`seed`	integer	No	Random seed for reproducibility	null	0–4294967295
`watermark`	boolean	No	Whether to include watermark	false	true / false
`first_frame`	image	No	First frame image for Image-to-Video (optional for Pro)	""	Must be a publicly accessible image url

Response

{
  "request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12",
  "model": "seedance-1-0-pro-250528",
  "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/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12",
  "org_id": "your-org-id",
  "model": "seedance-1-0-pro-250528",
  "status": "success",
  "payload": {
    "prompt": "A futuristic city skyline glowing with neon lights, camera panning slowly across tall skyscrapers",
    "duration": 8,
    "resolution": "720p",
    "ratio": "16:9",
    "camerafixed": false,
    "seed": 42,
    "watermark": false
  },
  "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-1-0-pro-250528

Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=seedance-1-0-pro-250528" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Model Information

Endpoint

GET /api/v1/ie/requestqueue/apikey/models/seedance-1-0-pro-250528

Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models/seedance-1-0-pro-250528" \
  -H "Authorization: Bearer YOUR_API_KEY"

List Available Models

Endpoint

GET /api/v1/apikey/models

Example

curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
    "model_ids": [
        "seedance-1-0-pro-250528",
        "Minimax-Hailuo-02",
        "Wan-AI_Wan2.2-I2V-A14B",
        "Wan-AI_Wan2.2-T2V-A14B",
        "Veo3-Fast",
        "Luma-Ray2",
        "Veo3",
        "Kling-Text2Video-V2.1-Master",
        "Kling-Image2Video-V2.1-Standard",
        "Kling-Image2Video-V2.1-Pro",
        "Kling-Image2Video-V2.1-Master",
        "Kling-Text2Video-V1.6-Standard",
        "Kling-Text2Video-V2-Master",
        "Kling-Image2Video-V2-Master",
        "Kling-Image2Video-V1.6-Standard",
        "Kling-Image2Video-V1.6-Pro",
        "Wan-AI_Wan2.1-I2V-14B-720P",
        "Wan-AI_Wan2.1-I2V-14B-480P",
        "Wan-AI_Wan2.1-FLF2V-14B-720P",
        "Wan-AI_Wan2.1-T2V-14B"
    ]
}

Tips for Better Results

Detailed Prompts: More descriptive text yields better visuals
Use First Frame for I2V: Provide a starting image for higher temporal consistency
Seeds for Control: Use a fixed seed for reproducibility
Camerafixed: Set true to keep perspective locked
Resolution vs Cost: Higher resolutions take longer and may cost more

Examples

Cinematic Cityscape

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-1-0-pro-250528",
    "payload": {
      "prompt": "A cyberpunk city drenched in rain, with flying cars weaving between neon-lit towers",
      "duration": 10,
      "resolution": "1080p",
      "ratio": "21:9",
      "camerafixed": true
    }
  }'

Image-to-Video (First 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-1-0-pro-250528",
    "payload": {
      "prompt": "Extend this frame into a surreal animation of a floating island",
      "first_frame": "https://example.com/myimage.jpg",
      "duration": 6,
      "resolution": "720p"
    }
  }'

​seedance-1-0-pro-250528 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

​Example

​Get Model Information

​Endpoint

​Example

​List Available Models

​Endpoint

​Example

​Response

​Tips for Better Results

​Examples

​Cinematic Cityscape

​Image-to-Video (First Frame)

seedance-1-0-pro-250528 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

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Tips for Better Results

Examples

Cinematic Cityscape

Image-to-Video (First Frame)