curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "sora-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A time-lapse of a bustling city street transitioning from day to night",
"duration": 15,
"aspect_ratio": "16:9"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2025-11-12T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 401,
"error": {
"message": "Unauthorized - Invalid API key",
"type": "authentication_error"
}
}Sora 2 Video Generation
Standard quality video generation
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": "sora-2",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A time-lapse of a bustling city street transitioning from day to night",
"duration": 15,
"aspect_ratio": "16:9"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1757165031-uyujaw3d",
"status": "not_started",
"created_time": "2025-11-12T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 401,
"error": {
"message": "Unauthorized - Invalid API key",
"type": "authentication_error"
}
}- 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.
Sora 2 Video Generation
Generate standard quality videos using OpenAI’s Sora 2 model. Supports text-to-video and image-to-video generation.Available Models
- sora-2 - Standard quality video generation
- sora-2-private - Private deployment for standard quality
Duration Options
- 10 seconds - Short video clips
- 15 seconds - Standard duration
Advanced Parameters
Style
Control the visual aesthetic of your generated videos with predefined styles:thanksgiving- Thanksgiving stylecomic- Comic stylenews- News styleselfie- Selfie stylenostalgic- Nostalgic/Retro styleanime- Anime style
Storyboard
Enable storyboard mode for finer control over video generation details. Set totrue to enable or false to disable.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