Integrationsleitfäden
Fehler
Preise & Abrechnung
Offizielle API
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 --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"
}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-2für schnellere Iterationen odersora-2-pro, wenn die Ausgabequalität wichtiger ist als die Geschwindigkeit - Belassen Sie
secondsbei4fü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
Render-Job erstellen
Senden Sie
model, prompt, seconds und size, und speichern Sie dann die zurückgegebene id.Abfragen, bis der Job abgeschlossen ist
Rufen Sie Video abrufen auf, bis der Status
completed oder failed lautet.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
Bearer token authentication. Use your CometAPI key.
Body
multipart/form-data
Text prompt that describes the video you want to create.
Beispiel:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
Beispiel:
"sora-2"
Clip duration in seconds.
Verfügbare Optionen:
4, 8, 12 Beispiel:
"4"
Output resolution formatted as width x height.
Verfügbare Optionen:
720x1280, 1280x720, 1024x1792, 1792x1024 Beispiel:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
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"
}