Sora 2 Pro API

Integrieren Sie die Sora 2 Pro API

Erstellen Sie Text-zu-Video-, Bild-zu-Video- und Storyboard-Workflows mit vorhersehbarem Polling und Credit-Kontrolle.

Was die Sora 2 Pro API bietet

Alles, was Sie benötigen, um produktionsreife Sora 2 Pro-Pipelines zu starten.

Fünf Modellvarianten

Wählen Sie sora-2 Text/Bild oder sora-2-pro Text/Bild/Storyboard basierend auf Qualität und Kosten.

Storyboard-Unterstützung

Definieren Sie Multi-Shot-Erzählungen mit shots[] und Dauern pro Shot.

Einheitliche Antworten

Alle Endpunkte geben code/message/data zurück, auch wenn der HTTP-Status bei Fehlern 200 ist.

Authentifizierung & Basis-URL

Basis-URL: https://freesoragenerator.com. Authentifizieren Sie sich mit einem API-Schlüssel oder einem angemeldeten Session-Cookie.

  • Authorization: Bearer [TOKEN] (API-Schlüssel sk- oder JWT), oder senden Sie ein Session-Cookie.
  • Senden Sie Content-Type: application/json mit POST-Bodys.
  • Die meisten Fehler geben weiterhin HTTP 200 zurück; prüfen Sie immer das code-Feld.

Kern-Endpunkte

Erstellen Sie Aufgaben mit /sora-pro und fragen Sie dann check-result für den Status ab.

Generierungsaufgabe erstellen

Eingabe validieren, Credits abziehen, Aufgabe erstellen und taskId zurückgeben.

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

Payload-Parameter

  • Erforderlich. Eines von sora-2-text-to-video, sora-2-image-to-video, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-storyboard.
  • Bedingt. Erforderlich für alle Modelle außer sora-2-pro-storyboard.
  • Bedingt. Base64-Daten-URL wie data:image/png;base64,... Erforderlich für Bild-zu-Video, wenn keine imageUrl vorhanden.
  • Bedingt. Öffentliche Bild-URL, die verwendet wird, wenn imageData nicht angegeben ist.
  • Optional. portrait oder landscape. Standard: landscape.
  • Optional. 10, 15 oder 25 (nur Storyboard). Standardwerte variieren je nach Modell.
  • Optional. standard oder high. Nur für Pro Text/Bild-Modelle.
  • Optional. Wasserzeichen für Nicht-Storyboard-Modelle entfernen. Standard: true.
  • Bedingt. Erforderlich für sora-2-pro-storyboard. Array von '{ Scene, duration }'.

Hinweise

  • imageData hat Vorrang vor imageUrl, wenn beide angegeben sind.
  • prompt ist für Storyboard optional und wird nicht an den Anbieter gesendet; verwenden Sie shots für den Inhalt.
  • nFrames wird auf die zulässigen Werte pro Modell normalisiert.
  • removeWatermark ist standardmäßig true für Nicht-Storyboard-Modelle.
  • shots muss Scene (großes S) und duration > 0 enthalten.

Beispielanfragen

Text-zu-Video
curl -X POST https://freesoragenerator.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": "A cinematic shot of a futuristic city at sunset.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true
  }'
Bild-zu-Video
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-image-to-video",
    "prompt": "Turn this image into a dynamic 10s clip.",
    "imageUrl": "https://example.com/reference.png",
    "aspectRatio": "portrait",
    "nFrames": "10"
  }'
Storyboard
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-storyboard",
    "shots": [
      { "Scene": "Establishing shot of a city skyline at dusk", "duration": 5 },
      { "Scene": "Close-up of a runner splashing through puddles", "duration": 5 }
    ],
    "aspectRatio": "landscape",
    "nFrames": "10"
  }'

Beispielantwort

{
  "code": 0,
  "message": "ok",
  "data": {
    "taskId": "281e5b0*********************f39b9"
  }
}

Aufgabenstatus abfragen

Status, Fortschritt und Ergebnis-URLs nach taskId abrufen.

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

Payload-Parameter

  • Erforderlich. Die von create zurückgegebene taskId.

Hinweise

  • Statuswerte: pending | running | succeeded | failed | cancelled.
  • result_url und result_urls geben die finalen Video-Links zurück, wenn bereit.

Beispielanfrage

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

Beispielantwort

{
  "code": 0,
  "message": "Success",
  "data": {
    "status": "running",
    "progress": 35,
    "result_url": "https://your-domain.com/storage/videos/xxx.mp4",
    "result_urls": [
      "https://your-domain.com/storage/videos/xxx.mp4"
    ],
    "failure_reason": "",
    "error_message": null
  }
}

Benutzer-Credits abrufen

Aktuellen Credit-Stand vor dem Einreichen von Aufgaben prüfen.

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

Hinweise

  • Optionaler Endpunkt; nützlich für Vorabprüfungen.
  • Gibt left_credits und is_vip-Flags zurück.

Beispielanfrage

curl -X POST https://freesoragenerator.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": false
  }
}

Häufige Fehlercodes

Fehler werden über das code-Feld im Antwort-Body angezeigt.

  • 401: Nicht autorisiert
  • 402: Unzureichende Credits
  • -1: Ungültiger model-Parameter
  • -1: Prompt ist erforderlich
  • -1: Bild ist für Bild-zu-Video erforderlich
  • -1: Shots ist für Storyboard erforderlich
  • -1: Bild-Upload fehlgeschlagen
  • -1: Videogenerierungs-Datensatz konnte nicht erstellt werden

Credits-Referenz

Credits variieren je nach Modell, Größe und nFrames. Verwenden Sie diese Tabelle als Grundlage.

ModellParameterCredits
sora-2-text-to-video1020
sora-2-text-to-video1530
sora-2-image-to-video1020
sora-2-image-to-video1530
sora-2-pro-text-to-videostandard + 10375
sora-2-pro-text-to-videostandard + 15675
sora-2-pro-text-to-videohigh + 10825
sora-2-pro-text-to-videohigh + 151.575
sora-2-pro-image-to-videostandard + 10375
sora-2-pro-image-to-videostandard + 15675
sora-2-pro-image-to-videohigh + 10825
sora-2-pro-image-to-videohigh + 151.575
sora-2-pro-storyboard10375
sora-2-pro-storyboard15675
sora-2-pro-storyboard25675

1. Aufgabe erstellen

POST /api/v1/video/sora-pro mit Ihrem Modell und Payload.

2. Fortschritt verfolgen

Fragen Sie /api/video-generations/check-result ab, bis der Status succeeded oder failed ist.

3. Credits überprüfen

Rufen Sie optional /api/get-user-credits auf, bevor Sie große Batches einreichen.

Häufig gestellte Fragen

Kann ich API-Schlüssel oder Session-Cookies verwenden?

Ja. Senden Sie Authorization: Bearer [TOKEN] (API-Schlüssel oder JWT) oder ein angemeldetes Session-Cookie.

Wie formatiere ich Storyboard-Shots?

Geben Sie shots als Array von '{ Scene, duration }' an, wobei Scene großgeschrieben ist und duration in Sekunden angegeben wird.

Warum unterscheiden sich die Credits je nach Modell?

Credits skalieren mit nFrames für alle Modelle; Pro-Modelle variieren zusätzlich nach Größe.

Hilfreiche Ressourcen

Starten Sie mit der Sora 2 Pro API

Generieren Sie einen API-Schlüssel und starten Sie noch heute Ihren ersten Sora 2 Pro-Workflow.