Skip to main content
POST
/
api
/
generate
/
submit
curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A cinematic city reveal after rain, smooth dolly shot, reflective streets, natural ambience.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "seed": 42
  }
}
'
{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2026-04-17T10:30:00"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt

Use this file to discover all available pages before exploring further.

  1. After submission, a task_id is returned immediately. If you provide a callback_url, Vidgo sends a POST request to that URL when the task reaches finished or failed.
  2. You can always fetch the latest task result through the unified Query Task Status endpoint.

​
Seedance 2 Video Generation

Seedance 2 is ByteDance’s multimodal video family for API-based generation. On Vidgo API, you can choose between seedance-2 for higher fidelity and seedance-2-fast for lower-latency generation, while keeping a single submit and status workflow.

​
Available Models

  • seedance-2: Higher-quality video generation with multimodal references and native audio support
  • seedance-2-fast: Faster generation path with the same submit schema and lower per-second pricing

​
Supported Workflows

  • Text to Video: Generate directly from a prompt
  • First and Last Frame: Guide motion between one or two frame anchors via image_urls
  • Multimodal Reference: Add reference images, videos, and audio through reference_image_urls, reference_video_urls, and reference_audio_urls

​
Input Rules

  • resolution supports 480p and 720p
  • duration accepts integer values from 4 to 15
  • image_urls supports up to 2 items
  • image_urls is mutually exclusive with all reference_*_urls fields
  • aspect_ratio supports 1:1, 21:9, 4:3, 3:4, 16:9, and 9:16

​
Seedance 2 vs Seedance 1.5 Pro vs Seedance 1.0 Pro

  • Seedance 2 adds multimodal reference image, video, and audio guidance with first and last frame control in one API shape.
  • Seedance 1.5 Pro focuses on high-quality text-to-video and image-to-video generation with optional audio but without the same multimodal reference set.
  • Seedance 1.0 Pro remains a strong option for earlier Seedance workflows, but Seedance 2 expands creative control and API flexibility for newer production pipelines.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
model
enum<string>
required

Seedance 2 model identifier

Available options:
seedance-2,
seedance-2-fast
​
input
object
required

Input parameters for Seedance 2 generation. image_urls cannot be combined with any reference_*_urls field.

​
callback_url
string<uri>

Optional webhook callback URL for result notifications.

Example:

"https://your-domain.com/callback"

Response

200 - application/json

Task submitted successfully

​
code
integer
required

HTTP status code

Example:

200

​
data
object
required