Sora 2 Pro-API

Integrieren Sie Sora 2 Pro über API

Erstellen Sie Text-, Bild- oder Storyboard-Videoaufgaben mit /api/v1/video/sora-pro, fragen Sie dann den Status ab und liefern Sie Ergebnisse mit Prüfergebnis.

Alles, was Sie für die Lieferung von Sora 2 Pro benötigen

Eine API deckt Sora 2-, Sora 2 Pro- und Storyboard-Workflows mit klarer Abrechnung und vorhersehbaren Abfragen ab.

Sieben unterstützte Modelle

Wählen Sie zwischen den Varianten Sora 2 Text/Bild, Sora 2 Stable Text/Bild und Sora 2 Pro Text/Bild/Storyboard.

Gestaffelte Credits

Die Credits skalieren mit Dauer und Qualität, einschließlich Standard/Hoch für Sora 2 Pro.

Aufgabenbasierte Lieferung

Erstellen Sie eine Aufgabe, fragen Sie das Prüfergebnis ab und senden Sie die endgültige result_url.

Authentifizierung und Basis-URL

Alle Endpunkte werden von https://sora2-api.com bedient. Senden Sie den API-Schlüssel von der Konsole im Authorization-Header.

  • Geben Sie bei jeder Anfrage die Autorisierung: Bearer YOUR_API_KEY an.
  • Verwenden Sie Content-Type: application/json für JSON-Nutzlasten.
  • Antworten umfassen Code/Nachricht/Daten; Das Prüfergebnis kann 4xx/5xx zurückgeben. Überprüfen Sie daher auch den HTTP-Status.

Gutschriften und Abrechnung

Die Abrechnung variiert je nach Modell, Dauer und Qualitätsstufe.

  • Sora 2 Text/Bild: 10 Sekunden = 100 Credits, 15 Sekunden = 150 Credits.
  • Sora 2 Stabiler Text/Bild: 10 Sekunden = 100 Credits, 15 Sekunden = 150 Credits.
  • Sora 2 Pro Text/Bild: 10s = 375, 15s = 675.
  • Sora 2 Pro-Storyboard: 10 Sekunden = 375, 15 Sekunden = 675, 25 Sekunden = 875.
  • Die oben genannten Preise sind Endpreise; Gebühren werden aufgerundet.

Kernendpunkte

Erstellen Sie zunächst eine Generierungsaufgabe und fragen Sie dann Ihr Guthaben ab oder überprüfen Sie es.

Erstellen Sie ein Sora 2 Pro-Video

Senden Sie Text-, Bild- oder Storyboard-Jobs, ziehen Sie die Credits sofort ab und erhalten Sie eine Task-ID.

Methode: POSTPfad: /api/v1/video/sora-pro

Nutzlastparameter

  • Modell: Erforderlich. Verwenden Sie eine der oben unterstützten Modellzeichenfolgen.
  • prompt: Erforderlich, außer für Storyboard. Beschreiben Sie die Szene, die Sie generieren möchten.
  • imageData: Erforderlich für Bild-zu-Video. Base64-Daten-URL mit Präfix „data:image/*;base64,“.
  • imageUrl: Optional. Öffentliche Bild-URL, wenn Sie Base64 nicht senden möchten.
  • Aspektverhältnis: Optional. „Querformat“ oder „Hochformat“ (Standard-Querformat).
  • nFrames: Optional. „10“/„15“/„25“ (25 ist nur Storyboard).
  • Größe: Optional (Pro-Text/Bild). „Standard“ oder „Hoch“.
  • RemoveWatermark: Optional (Text/Bild). Flag „Wasserzeichen entfernen“, Standardwert „true“.
  • Aufnahmen: Erforderlich für Storyboard. Reihe von Aufnahmen mit Szene und Dauer.
  • isPublic: Optional. Ob das Ergebnis öffentlich ist, standardmäßig wahr.

Notizen

  • Unterstützte Modelle: sora-2-text-to-video, sora-2-image-to-video, sora-2-text-to-video-stable, sora-2-image-to-video-stable, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-storyboard.
  • Credits werden bei der Einreichung abgezogen; Fehlgeschlagene Aufträge werden automatisch erstattet.
  • Für den Storyboard-Modus ist das Shots-Array erforderlich.

Schussstruktur

Erforderlich für Storyboard-Anfragen; Jedes Element definiert eine Szene und Dauer.

[
  { "scene": "Ein gemütliches Café bei Sonnenaufgang, warmes Licht.", "duration": 7.5 }
]
  • Szene: Beschreibung der Aufnahme.
  • Dauer: Sekunden (unterstützt Dezimalzahlen wie 7,5).

Musteranfrage

curl -X POST https://sora2-api.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "Eine filmische Kamerafahrt durch einen neonbeleuchteten Straßenmarkt in der Abenddämmerung.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

Beispielantwort

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890",
    "taskId": "task_1234567890"
  }
}

Generierungsergebnis prüfen

Aufgabenstatus abfragen und Ergebnisse synchronisieren.

Methode: POSTPfad: /api/video-generations/check-result

Nutzlastparameter

  • taskId: Erforderlich. Der Bezeichner, der zurückgegeben wurde, als Sie die Generierungsaufgabe erstellt haben.

Notizen

  • Gibt Status, Fortschritt und result_url zurück, sofern verfügbar.
  • Kann 4xx/5xx zur Validierung, Genehmigung oder für nicht gefundene Fälle zurückgeben.

Musteranfrage

curl -X POST https://sora2-api.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task_1234567890"
  }'

Beispielantwort

{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_1234567890",
    "status": "running",
    "progress": 0,
    "result_url": ""
  }
}

Holen Sie sich Benutzerguthaben

Restguthaben und VIP-Status abrufen.

Methode: POSTPfad: /api/get-user-credits

Notizen

  • Erfordert einen gültigen API-Schlüssel oder eine gültige Sitzung.
  • Gibt die Felder left_credits und is_vip zurück.

Musteranfrage

curl -X POST https://sora2-api.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Beispielantwort

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_vip": true
  }
}

1. Erstellen Sie die Aufgabe

Senden Sie /api/v1/video/sora-pro mit Ihrer Nutzlast und speichern Sie dann die Task-ID.

2. Verfolgen Sie den Fortschritt

Fragen Sie /api/video-generations/check-result ab, bis der Status „Erfolgreich“ oder „Fehlgeschlagen“ lautet.

3. Liefern Sie das Video

Verwenden Sie result_url/result_urls, um das generierte Video zu verteilen oder zu speichern.

Häufig gestellte Fragen

Welche Modelle werden unterstützt?

Verwenden Sie sora-2-text-to-video oder sora-2-image-to-video; Sora 2 Pro fügt Text-, Bild- und Storyboard-Varianten hinzu.

Welche Werte unterstützt nFrames?

Verwenden Sie für alle Modi „10“ oder „15“. „25“ ist nur für das Storyboard. Pro Text/Bild unterstützt Standard- oder Hochformat.

Warum kann das Prüfergebnis 4xx/5xx zurückgeben?

Der Endpunkt validiert Besitz und Eingabe, sodass ungültige oder nicht autorisierte Aufgaben neben Code/Nachricht auch 4xx/5xx zurückgeben können.

Hilfreiche Ressourcen

Starten Sie mit der Tikdek Video API

Erstellen Sie Ihren API-Schlüssel und beginnen Sie in wenigen Minuten mit der Generierung von Sora 2 Pro-Videos.