# Create Video Generation Task

This file is the focused AI-readable context for one UniAll documentation page.

URL: https://docs.uniall.ai/models/video/sora-2/create-task
Locale: en
Markdown: https://docs.uniall.ai/ai/pages/models/video/sora-2/create-task.md
Description: Sora 2 create video generation task endpoint.

Agent guidance:
- Use this page when the user is asking about this specific route or model capability.
- Preserve endpoint paths, JSON keys, model IDs, and placeholder values exactly.
- Treat examples such as `sk-***`, `{BASE_URL}`, and `task_xxx` as safe placeholders, not real secrets.

## Page Markdown

## Overview

new sora2 Pro Public Models `sora2-pro-720p`,`sora2-pro-1080p`,`sora2-pro-true-1080p`

## Endpoint


```http
POST /v1/video/generations
```
## Header Parameters

| Name | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `Authorization` | string | No | | Bearer {your_token} |
## Request Body Parameters

| Field | Type | Required | Title | Description |
| --- | --- | --- | --- | --- |
| `model` | string | Yes | Model name | Optional values: sora2-landscape-4s, sora2-landscape-8s, sora2-landscape-12s, sora2-portrait-4s, sora2-portrait-8s, sora2-portrait-12s, sora2-pro-720p, sora2-pro-1080p |
| `prompt` | string | Yes | prompt | |
| `image_url` | string | Yes | reference URL | must be public URLimage URL |
| `aspect_ratio` | string | No | Ratio | "16:9", "9:16" |
| `duration` | string | No | description | 4, 8, 12, 16, 20 |

## Request Examples

### Example 1

```json
{"model": "sora2-portrait-12s",
 "prompt": " ",
 "image_url": "https://example.com/image.jpg" // Optional values}
```

```bash
curl -X POST "{BASE_URL}/v1/video/generations" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "sora2-portrait-12s",
 "prompt": " ",
 "image_url": "https://example.com/image.jpg" // Optional values}'
```
## Response Fields

| Field | Type | Required | Title | Description |
| --- | --- | --- | --- | --- |
| `id` | string | Yes | task ID | |
| `object` | string | Yes | Task type | |
| `model` | string | Yes | Model name | |
| `status` | string | Yes | Status | |
| `progress` | string | Yes | | |
| `created_at` | string | Yes | Created time | |
| `seconds` | string | Yes | duration | |

## Response Examples

### Example 1

```json
{
  "id": "gen_xxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "sora2",
  "status": "queued",
  "progress": 0,
  "created_at": 1770405483,
  "seconds": "12"
}
```