TikdekTikdek
Asynchrone Zustellung

Zuverlässige Video-Tasks mit Status und Webhooks

Polling für einfache Clients, Webhooks für automatische Zustellung, ein gemeinsamer Lebenszyklus.

API-Schlüssel generierenLesen Sie Dokumente
Task mit Webhook erstellen
curl -X POST https://sora2-api.com/api/v1/video/sora-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A tracking shot through a quiet night market",
    "aspectRatio": "16:9",
    "webHook": "https://api.example.com/webhooks/video",
    "isPublic": false
  }'

# Your webhook receives a terminal payload:
{
  "id": "task_123",
  "status": "succeeded",
  "progress": 100,
  "results": [{ "url": "https://storage.example/video.mp4" }]
}

Ein Lebenszyklus, zwei Zustellwege

Speichern Sie jede Task-ID und behandeln Sie succeeded und failed als Endzustände.

Vorhersehbare Umfragen

Erstellen Sie eine Aufgabe und fragen Sie dann den Prüfergebnis-Endpunkt ab, um Status und Fortschritt ohne SSE synchron zu halten.

20 gleichzeitige Anfragen

Verarbeiten Sie bis zu 20 Videogenerierungsaufgaben gleichzeitig. Kontaktieren Sie uns für höhere Limits.

Transparente Abrechnung

Jeder Anruf kostet 100 Credits für 10s Sora-2/Sora-2-Stable, 150 Credits für 15s Sora-2/Sora-2-Stable oder 150 Credits für Sora-2-Pro, mit automatischer Rückerstattung, wenn eine Generation fehlschlägt.

Empfohlener Integrationsablauf

Webhook-Zustellregeln

Schnell mit 2xx antworten, idempotent verarbeiten und Polling als Wiederherstellung behalten.

Erstellen Sie die Aufgabe

Senden Sie die Tikdek-Anfrage mit Ihrer Eingabeaufforderung und speichern Sie dann die zurückgegebene Task-ID.

Verfolgen Sie den Fortschritt

Rufen Sie den Prüfergebnis-Endpunkt auf, bis der Status „Erfolgreich“ oder „Fehlgeschlagen“ lautet.

Liefern Sie das Video

Verwenden Sie die speichergestützten URLs in result_url/result_urls, um das generierte Video bereitzustellen oder herunterzuladen.

Häufig gestellte Fragen

Wie authentifiziere ich meine Anfragen?

Erstellen Sie einen API-Schlüssel in der Konsole und fügen Sie ihn dann als Autorisierung ein: Bearer YOUR_API_KEY. Schlüssel können jederzeit gedreht werden.

Wie soll ich Ergebnisse abfragen?

Speichern Sie nach dem Aufruf von create die Task-ID. Rufen Sie /api/video-generations/check-result alle 3–5 Sekunden auf, bis der Status erfolgreich oder fehlgeschlagen ist, und verwenden Sie dann result_url/result_urls.

Wie erfolgt die Anerkennung von Fehlschlägen?

Wir erstatten Credits automatisch zurück, wenn eine Aufgabe fehlschlägt, und geben „refund_trans_no“ plus „credits_refunded=true“ in der Prüfergebnis-Nutzlast für Prüfprotokolle zurück.

Robuste asynchrone Generierung liefern

Starten Sie mit Polling und ergänzen Sie Webhooks ohne Vertragsänderung.

Gehen Sie zur API-KonsolePreise anzeigen