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": "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"
  }
}

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 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.
  2. 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:
  1. Resolution presets such as 2K and 3K
  2. Ratio presets such as 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, and 21:9
  3. Custom size strings such as 2304x1728
  4. 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
​
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

​
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