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"
}Seedream
Seedream-5.0-Lite Image Generation
Seedream 5.0 Lite image generation and editing with preset sizes, custom dimensions, and up to 10 reference images
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_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis 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
modelmust beseedream-5.0-liteorseedream-5.0-lite-editinput.promptis required and supports up to 2000 charactersinput.naccepts integers from1to15input.image_urlsis optional forseedream-5.0-liteimage-to-image requests and required forseedream-5.0-lite-edit; both accept1to10URLs- successful submit responses return
task_idandcreated_time; query final task state through the unified status endpoint
Size Parameter
input.size supports four accepted forms:
- Resolution presets such as
2Kand3K - Ratio presets such as
1:1,4:3,3:4,16:9,9:16,3:2,2:3, and21:9 - Custom size strings such as
2304x1728 - Structured JSON objects such as
{ "width": 2304, "height": 1728 }
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://cdn.vidgo.ai/temp/reference1.jpg",
"https://cdn.vidgo.ai/temp/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
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
Seedream-5.0-Lite text-to-image model identifier
Available options:
seedream-5.0-lite Input parameters for Seedream-5.0-Lite text-to-image or image-to-image generation
Show child attributes
Show child attributes
Webhook callback URL for result notifications
Example:
"https://your-domain.com/callback"