Przejdź do głównej treści
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"
    }
  ]
}

Autoryzacje

​
Authorization
string
header
wymagane

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

Nagłówki

​
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

Dostępne opcje:
application/json,
application/x-ndjson

Treść

application/json
​
model
enum<string>
wymagane

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.

Dostępne opcje:
sora-2,
sora-2-pro
Przykład:

"sora-2"

​
prompt
string
wymagane

The text prompt describing the video to generate.

Przykład:

"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.

Dostępne opcje:
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).

Dostępne opcje:
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.

Dostępne opcje:
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.

Przykład:

"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>
domyślnie: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).

Dostępne opcje:
1.0,
2.0

Odpowiedź

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