Guide de migration

Préparez l'après Sora 2

Stabilisez votre produit avec un contrat neutre, vos propres fichiers et des modèles de secours testés.

Une requête neutre côté fournisseur
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>;
}

Séparez votre produit du modèle

Normalisez entrées, statuts, erreurs et URLs avant le code propre au fournisseur.

Sora 2 + Stable + Pro

Choisissez la chaîne de modèle qui correspond à vos besoins en matière de qualité et de coût : sora-2, sora-2-stable ou sora-2-pro.

Facturation transparente

Chaque appel coûte 100 crédits pour 10s sora-2/sora-2-stable, 150 crédits pour 15s sora-2/sora-2-stable, ou 150 crédits pour sora-2-pro, avec remboursements automatiques en cas d'échec d'une génération.

Sondage prévisible

Créez une tâche, puis interrogez le point de terminaison du résultat de la vérification pour maintenir le statut et la progression synchronisés sans SSE.

Flux d'intégration recommandé

Échéance de migration

OpenAI prévoit l'arrêt de Sora 2 et de Videos API le 24 septembre 2026. Testez un secours avant.

Créez la tâche

Envoyez la requête Tikdek avec votre invite, puis stockez le taskId renvoyé.

Suivez les progrès

Appelez le point de terminaison du résultat de la vérification jusqu'à ce que l'état devienne réussi ou échoué.

Livrez la vidéo

Utilisez les URL sauvegardées sur le stockage dans result_url/result_urls pour diffuser ou télécharger la vidéo générée.

Questions fréquemment posées

Comment authentifier mes demandes ?

Créez une clé API dans la console, puis incluez-la comme Autorisation : Bearer YOUR_API_KEY. Les clés peuvent être tournées à tout moment.

Comment dois-je interroger les résultats ?

Après avoir appelé create, stockez le taskId. Appelez /api/video-generations/check-result toutes les 3 à 5 secondes jusqu'à ce que le statut soit réussi ou échoué, puis utilisez result_url/result_urls.

Comment sont gérés les crédits en cas d’échec ?

Nous remboursons automatiquement les crédits lorsqu'une tâche échoue et renvoyons remboursé_trans_no plus credits_refunded=true dans la charge utile du résultat de la vérification pour les pistes d'audit.

Rendez le prochain changement de modèle ordinaire

Gardez des endpoints stables et placez le fournisseur dans un adaptateur remplaçable.