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

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 style
  • comic - Comic style
  • news - News style
  • selfie - Selfie style
  • nostalgic - Nostalgic/Retro style
  • anime - Anime style

Storyboard

Enable storyboard mode for finer control over video generation details. Set to true to enable or false to disable.

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

Sora 2 Standard model identifier

Available options:
sora-2,
sora-2-private
callback_url
string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

input
object

Input parameters for generation

Response

Task submitted successfully

code
integer
required

HTTP status code

Example:

200

data
object
required