Video erstellen

Verwenden Sie POST /v1/videos, um Sora 2-Videogenerierungsaufgaben aus Text-Prompts oder Referenzbildern zu erstellen, und fragen Sie dann den Status per Aufgaben-ID ab, um die Ergebnisse zu erhalten.

POST /v1/videos

Create a Sora video job

cURL

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'

200

{
  "created_at": 1773296991,
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "model": "sora-2",
  "object": "video",
  "progress": 0,
  "seconds": "4",
  "size": "1280x720",
  "status": "queued"
}

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