Migrationsleitfaden

Planen Sie für die Zeit nach Sora 2

Stabil bleiben mit neutralem Vertrag, eigenen Dateien und getesteten Ersatzmodellen.

Eine anbieterneutrale Anfrage
type VideoGenerationRequest = {
  prompt: string;
  imageUrl?: string;
  aspectRatio: "16:9" | "9:16";
  durationSeconds: number;
  quality: "standard" | "high";
  callbackUrl?: string;
};

type VideoGenerationResult = {
  id: string;
  status: "queued" | "running" | "succeeded" | "failed";
  progress: number;
  outputUrl?: string;
  errorCode?: string;
};

interface VideoProvider {
  create(input: VideoGenerationRequest): Promise<{ id: string }>;
  retrieve(id: string): Promise<VideoGenerationResult>;
}

Trennen Sie Produkt und Modell

Normalisieren Sie Eingaben, Status, Fehler und URLs vor anbieterspezifischem Code.

Sora 2 + Stabil + Pro

Wählen Sie die Modellsaite, die Ihren Qualitäts- und Kostenanforderungen entspricht: sora-2, sora-2-stable oder sora-2-pro.

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.

Vorhersehbare Umfragen

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

Empfohlener Integrationsablauf

Migrationsfrist

OpenAI plant Sora 2 und Videos API am 24. September 2026 einzustellen. Testen Sie vorher Ersatz.

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.

Machen Sie den nächsten Modellwechsel zur Routine

Halten Sie Endpunkte stabil und kapseln Sie Anbieter in einem austauschbaren Adapter.