Sora 2 Pro

Overview

Sora 2 Pro is the upgraded OpenAI Sora pipeline offered through Pixwith.ai. It supports text-to-video and image-to-video generation up to 15 seconds with refined physics, improved motion fidelity, optional watermark removal, and outputs at 720p or 1080p.


Test API KEY: key_00000000000000000000000000000000

Endpoints

1. Create Task

Request


POST https://api.pixwith.ai/api/task/create

Headers

Header	Value	Required
Content-Type	application/json	Yes
Api-Key	{API_KEY}	Yes

Request Parameters

Parameter	Type	Required	Description
prompt	string	Yes	The input prompt (e.g., “A cat walking in the garden”)
image_urls	array	Conditional	Provide 1 image URL when using image-to-video mode.
model_id	string	Yes	`2-21` (Sora 2 Pro)
options	object	Yes	Configuration options for the task
options.prompt_optimization	boolean	Yes	If true, the prompt is auto-translated to English for better results.
options.aspect_ratio	string	Yes	Aspect ratio of the output. Valid values: `'Portrait'` or `'Landscape'`.
options.resolution	string	Yes	`'720p'` or `'1080p'`.
options.duration	int	Yes	Duration in seconds. Valid values: `10` or `15`.
options.remove_watermark	boolean	No	Remove provider watermark. Default: `false`.

Example Request – Text-to-Video (720p Portrait)


{
  "prompt": "A ballet dancer spinning through a sunlit atrium",
  "model_id": "2-21",
  "options": {
    "prompt_optimization": true,
    "aspect_ratio": "Portrait",
    "resolution": "720p",
    "duration": 10,
    "remove_watermark": false
  }
}

Example Request – Image-to-Video (1080p Landscape)


{
  "prompt": "Animate this product hero shot with subtle camera push-ins",
  "image_urls": [
    "https://cdn.pixwith.ai/images/example_start.jpeg"
  ],
  "model_id": "2-21",
  "options": {
    "prompt_optimization": true,
    "aspect_ratio": "Landscape",
    "resolution": "1080p",
    "duration": 15,
    "remove_watermark": true
  }
}

Response Parameters

Parameter	Type	Description
code	int	`1` = success, `0` = error
message	string	Success or error message
data	object
data.task_id	string	Unique task identifier
data.estimated_time	int	Estimated processing time in seconds (720p ≈ 400s for 10s; 1080p up to ≈ 1100s for 15s)

Response


{
  "code": 1,
  "message": "success",
  "data": {
    "task_id": "d425ab4dc256f0ebaa84862b9cea8a3d",
    "estimated_time": 720
  }
}