Перейти до основного вмісту
POST
/
sora
/
videos
Sora Videos
curl --request POST \
  --url https://api.acedata.cloud/sora/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "sora-2",
  "prompt": "cat running on the river"
}
'
{
  "success": true,
  "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
  "data": [
    {
      "id": "sora-2:task_01k777hjrbfrgs2060q5zvf2a5",
      "video_url": "https://cdn.acedata.cloud/sora/example-video.mp4",
      "state": "succeeded"
    }
  ]
}

Авторизації

​
Authorization
string
header
обов'язково

API token from https://platform.acedata.cloud

Заголовки

​
accept
enum<string>

Specifies the format of the response from the server. If not specified, the default format is application/json. If application/x-ndjson is specified, the response will be in newline-delimited JSON format, streaming the response chunk by chunk

Доступні опції:
application/json,
application/x-ndjson

Тіло

application/json
​
model
enum<string>
обов'язково

The model used to generate the videos. sora-2 is the standard model, sora-2-pro is the high-quality model with longer duration support.

Доступні опції:
sora-2,
sora-2-pro
Приклад:

"sora-2"

​
prompt
string
обов'язково

The text prompt describing the video to generate.

Приклад:

"cat running on the river"

​
duration
enum<integer>

Video duration in seconds. For version 1.0: 10 or 15 (sora-2), or 10, 15, 25 (sora-2-pro). For version 2.0: 4, 8, or 12. Default: 15 for version 1.0, 4 for version 2.0.

Доступні опції:
4,
8,
10,
12,
15,
25
​
orientation
enum<string>

Video orientation. Only applicable when version is 1.0. landscape for horizontal (16:9), portrait for vertical (9:16).

Доступні опції:
landscape,
portrait
​
size
enum<string>

Video size/resolution. For version 1.0: small (standard definition) or large (HD, only supported in sora-2-pro). For version 2.0: pixel resolution like 720x1280, 1280x720, 1024x1792, or 1792x1024. Default for version 2.0: 720x1280.

Доступні опції:
small,
large,
720x1280,
1280x720,
1024x1792,
1792x1024
​
character_url
string

Video URL containing the character to use. Only applicable when version is 1.0. Real people must not appear in the video, otherwise the task will fail.

Приклад:

"https://cdn.acedata.cloud/pdidf5.mp4"

​
character_start
integer

The starting second for the character appearance in the video. Only applicable when version is 1.0. Required when character_url is provided.

​
character_end
integer

The ending second for the character appearance in the video. Only applicable when version is 1.0. Required when character_url is provided. The range (character_end - character_start) must be between 1 and 3 seconds.

​
image_urls
string[]

An array of reference image URLs to guide video generation. For version 1.0: supports multiple images. For version 2.0: only the first image is used and its dimensions should match the size parameter. Do not include images of real people or existing US brand logos, as this may cause the task to fail.

​
callback_url
string

The callback URL which will be called when the video is generated

​
version
enum<string>
за замовчуванням:1.0

The API version to use. Version 1.0 supports duration (10/15/25s), orientation, size (small/large), image_urls, and character parameters. Version 2.0 supports duration (4/8/12s), pixel-based size (e.g. 720x1280), and image_urls (first image used as reference).

Доступні опції:
1.0,
2.0

Відповідь

OK, the request is successful.

​
success
boolean

Whether the request was successful

​
task_id
string

The unique task ID for this video generation request

​
trace_id
string

The trace ID for this request, used for debugging

​
data
object[]

The generated video items