Get API Key Get API
Docs

seedance-1-0-pro Video Generation

- Async processing mode, returns task ID for subsequent queries

  • Supports text-to-video, image-to-video (first frame/last frame)
  • Supports landscape, portrait, and square aspect ratios

Request example

curl --request POST \
  --url https://api.openveer.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-1-0-pro-fast",
    "prompt": "A cute kitten playing in the sunlight, fluffy fur, bright eyes",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "1080p"
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorization

Authorization string

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Request Parameters

model string

Video generation model name

Supported models:

  • seedance-1-0-pro-fast - Fast version, quick generation, suitable for preview and iteration
  • seedance-1-0-pro-quality - High-quality version, longer generation time, better quality
nsfw_check boolean

Whether to run content moderation before submitting the video task.

  • true: use omni-moderation-latest to review prompts and input images
  • false or omitted: do not send a moderation request, adding no moderation cost or latency (default)
prompt string

Video content description

Describe scenes, actions, styles in detail for better generation results

Example: "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"

duration integer

Video duration (seconds)

Supported range: 2 \~ 12 seconds

Default: 5

aspect_ratio string

Video aspect ratio

Options:

  • 16:9 - Landscape
  • 9:16 - Portrait
  • 1:1 - Square
  • 4:3 - Traditional ratio
  • 3:4 - Vertical traditional ratio
  • 21:9 - Ultra-wide

Default: 16:9

resolution string

Video resolution

Options:

  • 480p - Standard definition
  • 720p - High definition
  • 1080p - Full HD

Default: 1080p

seed integer

Seed integer for controlling the randomness of generated content

Value range: Integer between -1 and 2^32-1

Note



* With the same request, if the model receives different seed values (e.g., not specifying seed or setting seed to -1, which will use a random number), different results will be generated

* With the same request, if the model receives the same seed value, similar results will be generated, but not guaranteed to be identical

Resolution and Aspect Ratio Combinations

Resolution Supported Aspect Ratios Notes
480p 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 All supported
720p 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 All supported
1080p 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 All supported
image_with_roles array
Image array with roles for more precise control
url string

Image URL address

role string

Image role

  Options:

  * first_frame - First frame image, as video starting frame (only one supported)
  * last_frame - Last frame image, as video ending frame (quality version only, only one supported)
Example:
[
  {"url": "https://example.com/start.png", "role": "first_frame"},
  {"url": "https://example.com/end.png", "role": "last_frame"}
]
Warning
  • Only one image per role is supported
    • last_frame is only supported by seedance-1-0-pro-quality version, fast version does not support first and last frame together

Response

code integer

Response status code, 200 on success

data array
Response data array
status string

Task status, submitted when initially submitted

task_id string

Unique task identifier for querying task status and results

Use Cases

Case 1: Quick Preview Landscape Video

{
  "model": "seedance-1-0-pro-fast",
  "prompt": "Sunset at the beach, golden sunlight on the sea, waves gently hitting the sand"
}

Case 2: High-Quality Portrait Short Video

{
  "model": "seedance-1-0-pro-quality",
  "prompt": "A girl spinning under cherry blossom trees, petals falling with the wind",
  "duration": 5,
  "aspect_ratio": "9:16",
  "resolution": "1080p"
}

Case 3: Dynamic Transition Effect (First/Last Frame)

{
  "model": "seedance-1-0-pro-quality",
  "prompt": "Scene transitions from day to night, city lights gradually turning on",
  "image_with_roles": [
    {"url": "https://example.com/day.png", "role": "first_frame"},
    {"url": "https://example.com/night.png", "role": "last_frame"}
  ],
  "duration": 5
}
Note

Query Task Results

Video generation is an async task that returns a task_id upon submission. Use the Get Task Status endpoint to query generation progress and results.

This documentation is built and hosted on Mintlify, a developer documentation platform.