curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "sora-2-pro",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic drone shot flying through a misty forest at dawn",
"duration": 25,
"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 Pro Video Generation (Deprecated)
Premium HD quality video generation
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "sora-2-pro",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic drone shot flying through a misty forest at dawn",
"duration": 25,
"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 Pro Video Generation (Deprecated)
Generate premium HD quality videos using OpenAI’s Sora 2 Pro model. Supports text-to-video and image-to-video generation with longer duration options.Available Models
- sora-2-pro - Premium HD quality video generation
- sora-2-pro-private - Private deployment for premium quality
Duration Options
- 15 seconds - HD quality
- 25 seconds - Extended HD 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