Ein Sora-2-Video erstellen

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

Verwende diesen Endpoint, um einen Sora-Render-Job aus Text oder aus Text plus einem Referenzbild zu starten. Die API gibt sofort eine video id zurück und wartet nicht, bis das Rendering abgeschlossen ist.

Mit dem kleinsten nützlichen Job beginnen

Verwende sora-2 für schnellere Iterationen oder sora-2-pro, wenn die Ausgabequalität wichtiger ist als die Geschwindigkeit
Belasse seconds für deine erste Anfrage bei 4
Beginne mit size: 1280x720, es sei denn, du benötigst ausdrücklich eine Hochformat-Ausgabe
Lade höchstens ein Referenzbild hoch

Dauer und Größe

Einstellung	Unterstützte Werte	Standard-Ausgangspunkt	Verhalten an den Grenzen
`seconds`	`4`, `8`, `12`, `16`, `20`	`4`	Andere Werte sind nicht Teil der Sora-Video-Request-Form.
`size` für `sora-2`	`1280x720`, `720x1280`	`1280x720`	Verwende Querformat oder Hochformat.
`size` für `sora-2-pro`	`1792x1024`, `1024x1792` plus die Standard-Sora-Größen	`1792x1024` für Pro-Ausgabe im Querformat	Verwende die größeren Pro-Größen nur mit einem Pro-Modell.

Sora erfordert das Feld size in der exakten Form WxH. Auflösungstokens wie 720p und Seitenverhältnisbezeichnungen wie 16:9 sind bei diesem Endpoint keine gültigen Sora-size-Werte.

End-to-End-Ablauf

Den Render-Job erstellen

Sende model, prompt, seconds und size und speichere dann die zurückgegebene id.

Abfragen, bis der Job abgeschlossen ist

Rufe Video abrufen auf, bis der Status completed oder failed ist.

Das Ergebnis herunterladen

Wenn das Rendering abgeschlossen ist, rufe die Datei mit Videoinhalt abrufen ab.

Sora-Verhalten, das weiterhin gilt

OpenAI dokumentiert denselben Ablauf create -> retrieve -> download in der Videos API. Bei CometAPI behältst du die Sora-Request-Form bei, verwendest aber die CometAPI-Basis-URL und den Schlüssel. Fertige Download-URLs sind temporär, daher solltest du abgeschlossene Assets in deinen eigenen Storage kopieren, wenn du sie länger aufbewahren musst.

Autorisierungen

Authorization

string

header

erforderlich

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data

prompt

string

erforderlich

Text prompt that describes the video you want to create.

Beispiel:

"A paper airplane glides across a desk."

model

string

Standard:sora-2

Sora model ID. Choose an available model from the Models page.

Beispiel:

"sora-2"

seconds

enum<string>

Standard:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

Verfügbare Optionen:

4,

8,

12,

16,

20

Beispiel:

"4"

size

enum<string>

Standard:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

Verfügbare Optionen:

720x1280,

1280x720,

1024x1792,

1792x1024

Beispiel:

"1280x720"

input_reference

file

Optional reference image uploaded as a file. The image should match the target size you request.

Antwort

200 - application/json

Video job accepted.

created_at

integer

erforderlich

string

erforderlich

model

string

erforderlich

object

string

erforderlich

progress

integer

erforderlich

seconds

string

erforderlich

size

string

erforderlich

status

string

erforderlich

HappyHorse-Videoinhalte herunterladen

Zurück

Ein Sora 2-Video abrufen

Weiter

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

Inhaltsmoderation

API-Schlüssel

Mit dem kleinsten nützlichen Job beginnen

Dauer und Größe

End-to-End-Ablauf

Sora-Verhalten, das weiterhin gilt

Autorisierungen

Body

Antwort

​Mit dem kleinsten nützlichen Job beginnen

​Dauer und Größe

​End-to-End-Ablauf

​Sora-Verhalten, das weiterhin gilt

Autorisierungen

Body

Antwort

Mit dem kleinsten nützlichen Job beginnen

Dauer und Größe

End-to-End-Ablauf

Sora-Verhalten, das weiterhin gilt