TikdekTikdek
Livraison asynchrone

Des tâches vidéo fiables avec statuts et webhooks

Utilisez le suivi pour les clients simples ou les webhooks pour une livraison automatique.

Générer une clé APILire les documents
Créer une tâche avec un webhook
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" }]
}

Un cycle de vie, deux modes de livraison

Conservez chaque ID et traitez succeeded et failed comme seuls états finaux.

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.

20 demandes simultanées

Traitez jusqu'à 20 tâches de génération vidéo simultanément. Contactez-nous pour des limites plus élevées.

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.

Flux d'intégration recommandé

Règles de livraison du webhook

Répondez vite en 2xx, traitez les événements de façon idempotente et gardez le suivi en secours.

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.

Livrez une génération asynchrone robuste

Commencez par le suivi puis ajoutez les webhooks sans changer le contrat.

Accédez à la console APIVoir les prix