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-official",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic drone shot flying through a misty forest at dawn, sun rays cutting through the trees, realistic motion, natural ambience.",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "1024p"
}
}
'{
"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": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}OpenAI
Sora 2 Pro Official
Official Sora 2 Pro text-to-video and image-to-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-official",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic drone shot flying through a misty forest at dawn, sun rays cutting through the trees, realistic motion, natural ambience.",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "1024p"
}
}
'{
"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": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_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 result through the unified Query Task Status endpoint.
Sora 2 Pro Official
sora-2-pro-official supports text-to-video generation and optional single-image guided generation with fixed 4s, 8s, 12s, 16s, and 20s durations.
Available Model
- sora-2-pro-official - Official Sora 2 Pro text-to-video and image-to-video generation
Required Parameters
- prompt: Text prompt for video generation
Optional Parameters
- image_urls: Optional reference image array. Maximum
1image. Providing this field enables image-to-video mode - aspect_ratio:
16:9or9:16for text-to-video;auto,16:9, or9:16for image-to-video. Default is16:9for text-to-video andautofor image-to-video - duration:
4,8,12,16, or20. Default is4 - resolution:
720p,1024p, or1080p. Default is1024p
Credit Billing
Billing is calculated based on the selected outputresolution and video duration in seconds.
Notes
image_urlsis optional. If provided, only one image is supported andimage_urls[0]is used as the first frame.aspect_ratio=autois only valid whenimage_urlsis provided.- This page only describes the unified submit request. Query status through the standard task status API.
Authorizations
All API endpoints require Bearer Token authentication.
Get your API Key from the API Key Management Page.
Add it to the request header:
Authorization: Bearer YOUR_API_KEY
Body
application/json