Sora2 Image to Video

Character Animation Integration

To enhance character animation capabilities, you can use the character_url and character_timestamps parameters to create character animations:

Sora2 - Characters

Learn how to create character animations and obtain character_id_list for integration

Query Task Status

After submitting a task, you can check task progress and retrieve generation results through the unified query endpoint:

Get Task Details

Learn how to query task status and retrieve generation results

In production environments, it’s recommended to use callback notifications to receive automatic notifications when generation completes, rather than polling the status endpoint.

Market Overview

Browse all available models

Common API

View account credits and usage

API Reference

Request

POST https://api.ruxa.ai/api/v1/tasks/create

Request Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body Parameters

Parameter	Type	Required	Description
`model`	string	Yes	Model name: `sora-2` or `sora-2-hd`
`prompt`	string	Yes	Video description prompt
`seconds`	string	No	Video duration: `10`, `15`, `25` (pro only)
`input_reference`	file	No	Input reference image
`size`	string	No	Video size (see below)
`watermark`	boolean	No	Whether to add watermark, default no watermark
`private`	boolean	No	Whether to hide video, true means video won’t be published and can’t be remixed, default false
`character_url`	string	No	Video URL for creating character (no real people allowed in video)
`character_timestamps`	string	No	Character appearance time range in seconds, format `{start},{end}`, range 1~3 seconds
`metadata`	string	No	Metadata
`character_from_task`	string	No	Completed task ID, can create character from generated task
`character_create`	boolean	No	Automatically create character from generated video after completion
`style`	string	No	Style: `winter`, `comic`, `news`

Size Options

Value	Description	Note
`1024x1792`	HD Portrait	sora-2-hd only
`1792x1024`	HD Landscape	sora-2-hd only
`720x1280`	SD Portrait
`1280x720`	SD Landscape

Width > Height = Landscape, Width < Height = Portrait

Request Example

{
  "model": "sora-2",
  "prompt": "A horse taking flight",
  "seconds": "10",
  "size": "1280x720",
  "watermark": false,
  "private": false
}

Request Example with Character Creation

{
  "model": "sora-2",
  "prompt": "Character running on grass",
  "seconds": "10",
  "size": "1280x720",
  "character_url": "https://example.com/character-video.mp4",
  "character_timestamps": "0,3",
  "character_create": true
}

Request Example with Style

{
  "model": "sora-2",
  "prompt": "City street scene",
  "seconds": "10",
  "size": "1280x720",
  "style": "comic"
}

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_sora-2_1765184045509"
  }
}

Response Status Codes

Code	Description
200	Success
401	Unauthorized - Missing or invalid authentication credentials
402	Insufficient credits
404	Not found
422	Validation error - Request parameters failed validation
429	Rate limited
500	Server error
501	Generation failed

Getting Started

Image Series

Video Series

Common

Sora2 Image to Video

Character Animation Integration

Sora2 - Characters

Query Task Status

Get Task Details

Market Overview

Common API

API Reference

Request

Request Headers

Request Body Parameters

Size Options

Request Example

Request Example with Character Creation

Request Example with Style

Response Example

Response Status Codes

​Character Animation Integration

Sora2 - Characters

​Query Task Status

Get Task Details

​Related Resources

Market Overview

Common API

​API Reference

​Request

​Request Headers

​Request Body Parameters

​Size Options

​Request Example

​Request Example with Character Creation

​Request Example with Style

​Response Example

​Response Status Codes

Character Animation Integration

Query Task Status

Related Resources

API Reference

Request

Request Headers

Request Body Parameters

Size Options

Request Example

Request Example with Character Creation

Request Example with Style

Response Example

Response Status Codes