Zum Hauptinhalt springen
POST
/
v1
/
videos
Create a Sora video job
curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper airplane glides across a desk.' \
  --form input_reference='@example-file'
{
  "created_at": 1773296991,
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "model": "sora-2",
  "object": "video",
  "progress": 0,
  "seconds": "4",
  "size": "1280x720",
  "status": "queued"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Verwenden Sie diesen Endpoint, um einen neuen 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 Rendern abgeschlossen ist.

​
Beginnen Sie mit dem kleinsten sinnvollen Job

  • Verwenden Sie sora-2 für schnellere Iterationen oder sora-2-pro, wenn die Ausgabequalität wichtiger ist als die Geschwindigkeit
  • Belassen Sie seconds bei 4 für Ihre erste Anfrage
  • Beginnen Sie mit size: 1280x720, sofern Sie nicht ausdrücklich ein Hochformat benötigen
  • Laden Sie höchstens ein Referenzbild hoch

​
End-to-End-Ablauf

1

Render-Job erstellen

Senden Sie model, prompt, seconds und size, und speichern Sie dann die zurückgegebene id.
2

Abfragen, bis der Job abgeschlossen ist

Rufen Sie Video abrufen auf, bis der Status completed oder failed lautet.
3

Ergebnis herunterladen oder remixen

Wenn das Rendern abgeschlossen ist, rufen Sie die Datei mit Videoinhalt abrufen ab. Wenn Sie eine gezielte Variation möchten, verwenden Sie Video remixen für das abgeschlossene Ergebnis.

​
Sora-Verhalten, das weiterhin gilt

OpenAI dokumentiert denselben Ablauf create -> retrieve -> download in der Videos API. In CometAPI behalten Sie die Sora-Anfragestruktur bei, verwenden jedoch die CometAPI-Basis-URL und den Schlüssel. Abgeschlossene Download-URLs sind temporär, daher sollten Sie fertige Assets in Ihren eigenen Speicher kopieren, wenn Sie sie langfristig aufbewahren müssen.

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 a current model from the Models page.

Beispiel:

"sora-2"

​
seconds
enum<string>
Standard:4

Clip duration in seconds.

Verfügbare Optionen:
4,
8,
12
Beispiel:

"4"

​
size
enum<string>
Standard:1280x720

Output resolution formatted as width x height.

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
​
id
string
erforderlich
​
model
string
erforderlich
​
object
string
erforderlich
​
progress
integer
erforderlich
​
seconds
string
erforderlich
​
size
string
erforderlich
​
status
string
erforderlich