curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedream-5.0-lite",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A serene Japanese garden with cherry blossoms and a koi pond",
    "size": "2K",
    "n": 1
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "KC9IIO8MLOAN18JX",
    "created_time": "2026-04-16T18:36:35"
  }
}

{
  "detail": "prompt is required"
}

{
  "detail": "Invalid API key"
}

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": "seedream-5.0-lite",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A serene Japanese garden with cherry blossoms and a koi pond",
    "size": "2K",
    "n": 1
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "KC9IIO8MLOAN18JX",
    "created_time": "2026-04-16T18:36:35"
  }
}

{
  "detail": "prompt is required"
}

{
  "detail": "Invalid API key"
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the response result through the unified Query Task Status endpoint.

Seedream-5.0-Lite Image Generation

Seedream-5.0-Lite is an image generation and editing model for async production workflows. It supports text-to-image, reference-based editing, flexible preset sizes, and custom dimensions through the same unified Vidgo API submit and status endpoints.

Available Models

seedream-5.0-lite - Text-to-image and image-to-image generation with preset or custom output sizes
seedream-5.0-lite-edit - Image editing with 1 to 10 JPEG or PNG reference images

Request Notes

model must be seedream-5.0-lite or seedream-5.0-lite-edit
input.prompt is required and supports up to 2000 characters
input.n accepts integers from 1 to 15
input.image_urls is optional for seedream-5.0-lite image-to-image requests and required for seedream-5.0-lite-edit; both accept 1 to 10 URLs
successful submit responses return task_id and created_time; query final task state through the unified status endpoint

Size Parameter

input.size supports four accepted forms:

Resolution presets such as 2K and 3K
Ratio presets such as 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, and 21:9
Custom size strings such as 2304x1728
Structured JSON objects such as { "width": 2304, "height": 1728 }

Object-style size is supported for both seedream-5.0-lite and seedream-5.0-lite-edit. Use preset sizes when you want quick resolution or aspect-ratio control. Use custom strings or objects when your workflow needs exact dimensions.

Custom Size Example

{
  "model": "seedream-5.0-lite",
  "input": {
    "prompt": "A cinematic bookstore interior with clean bilingual signage and soft blue-hour light",
    "size": {
      "width": 2304,
      "height": 1728
    },
    "n": 1
  }
}

Edit Mode Example

{
  "model": "seedream-5.0-lite-edit",
  "input": {
    "prompt": "Keep the composition and convert the scene into a snowy evening with warmer storefront light",
    "image_urls": [
      "https://example.com/reference1.jpg",
      "https://example.com/reference2.jpg"
    ],
    "size": "2304x1728",
    "n": 1
  }
}

Error Response Shape

Validation and authentication failures follow the unified Vidgo API error shape:

{
  "detail": "prompt is required"
}

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

Option 1
Option 2

model

enum<string>

required

Seedream-5.0-Lite text-to-image model identifier

Available options:

seedream-5.0-lite

input

object

required

Input parameters for Seedream-5.0-Lite text-to-image or image-to-image generation

Show child attributes

callback_url

string<uri>

Webhook callback URL for result notifications

Example:

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

Response

Task submitted successfully

code

integer

required

HTTP status code

Example:

200

data

object

required

Show child attributes

Seedream-4.5 Image Generation Z-Image Generation

Overview

Image Series

Video Series

Music Series

File Management

Task Management

Account Management

Seedream-5.0-Lite Image Generation

Seedream-5.0-Lite Image Generation

Available Models

Request Notes

Size Parameter

Custom Size Example

Edit Mode Example

Error Response Shape

Authorizations

Body

Response

​Seedream-5.0-Lite Image Generation

​Available Models

​Request Notes

​Size Parameter

​Custom Size Example

​Edit Mode Example

​Error Response Shape

Authorizations

Body

Response

Seedream-5.0-Lite Image Generation

Available Models

Request Notes

Size Parameter

Custom Size Example

Edit Mode Example

Error Response Shape