> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Sora 2 Pro Video Generation > Premium HD quality video generation 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](/api-manual/task-management/status) endpoint. # Sora 2 Pro Video Generation 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 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. ## OpenAPI ````yaml /api-manual/video-series/sora-2-pro.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Sora 2 Pro API description: Sora 2 Pro Premium Quality Video Generation version: 1.0.0 servers: - url: https://api.vidgo.ai description: Production server security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Sora 2 Pro summary: Submit Sora 2 Pro Video Generation Task description: Generate premium HD quality videos using Sora 2 Pro operationId: submitSora2ProTask requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SubmitRequest' examples: sora-2-pro: summary: Sora 2 Pro Video Generation value: 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' sora-2-pro-private: summary: Sora 2 Pro Private Video Generation value: model: sora-2-pro-private callback_url: https://your-domain.com/callback input: prompt: >- A dramatic aerial view of mountains with storm clouds rolling in duration: 25 aspect_ratio: '16:9' responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/SubmitResponse' '400': description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 400 error: message: Invalid request parameters type: invalid_request_error '401': description: Unauthorized - Invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 error: message: Unauthorized - Invalid API key type: authentication_error components: schemas: SubmitRequest: type: object required: - model properties: model: type: string description: Sora 2 Pro model identifier enum: - sora-2-pro - sora-2-pro-private callback_url: type: string format: uri description: Webhook callback URL for result notifications example: https://your-domain.com/callback input: type: object required: - prompt description: Input parameters for generation properties: prompt: type: string description: Generation prompt describing the desired output maxLength: 1000 example: A cinematic video scene image_urls: type: array items: type: string format: uri maxItems: 1 description: >- Reference image URL (for image-to-video). Only one image is supported. Maximum file size: 10MB. Supported formats: .jpeg, .jpg, .png, .webp example: [] duration: type: integer description: Video duration in seconds (15 or 25) enum: - 15 - 25 example: 25 aspect_ratio: type: string description: Video aspect ratio enum: - '16:9' - '9:16' example: '16:9' style: type: string description: Video style enum: - thanksgiving - comic - news - selfie - nostalgic - anime example: anime storyboard: type: boolean description: >- Whether to use storyboard for finer control over video generation details. true: Enable storyboard feature, false: Do not use storyboard example: true SubmitResponse: type: object required: - code - data properties: code: type: integer example: 200 description: HTTP status code data: type: object required: - task_id - status - created_time properties: task_id: type: string example: task-unified-1757165031-uyujaw3d description: Unique task identifier for status tracking status: type: string enum: - not_started example: not_started description: Initial task status created_time: type: string format: date-time example: '2025-11-12T10:30:00' description: ISO 8601 timestamp when the task was created ErrorResponse: type: object required: - code - error properties: code: type: integer example: 400 description: HTTP status code error: type: object required: - message - type properties: message: type: string example: Invalid request parameters description: Error message describing what went wrong type: type: string example: invalid_request_error description: Error type identifier securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- All API endpoints require Bearer Token authentication Get your API Key: Visit the [API Key Management Page](https://vidgo.ai/apis/dashboard/api-key) to get your API Key Add it to the request header: ``` Authorization: Bearer YOUR_API_KEY ``` ````