Tikdek Video API

Intégrer Sora 2 Pro via l'API

Créez des tâches de texte, d'image ou de storyboard vidéo avec /api/v1/video/sora-pro, puis interrogez le statut et fournissez les résultats avec check-result.

Tout ce dont vous avez besoin pour la livraison de Sora 2 Pro

Une API couvre Sora 2, Sora 2 Pro et les workflows de storyboard avec une facturation claire et des sondages prévisibles.

Sept modèles pris en charge

Choisissez parmi les variantes texte/image Sora 2, texte/image Sora 2 Stable et Sora 2 Pro texte/image/storyboard.

Crédits échelonnés

Les crédits évoluent en fonction de la durée et de la qualité, y compris standard/élevé pour Sora 2 Pro.

Livraison basée sur les tâches

Créez une tâche, interrogez le résultat de la vérification et envoyez le result_url final.

Authentification et URL de base

Tous les points de terminaison sont servis à partir de https://sora2-api.com. Envoyez la clé API depuis la console dans l’en-tête Autorisation.

  • Incluez l'autorisation : Bearer YOUR_API_KEY à chaque demande.
  • Utilisez Content-Type : application/json pour les charges utiles JSON.
  • Les réponses incluent le code/message/données ; check-result peut renvoyer 4xx/5xx, alors validez également le statut HTTP.

Crédits et facturation

La facturation varie selon le modèle, la durée et le niveau de qualité.

  • Texte/image Sora 2 : 10s = 100 crédits, 15s = 150 crédits.
  • Sora 2 Texte/image stable : 10s = 100 crédits, 15s = 150 crédits.
  • Texte/image Sora 2 Pro : 10s = 375, 15s = 675.
  • Story-board Sora 2 Pro : 10 s = 375, 15 s = 675, 25 s = 875.
  • Les prix ci-dessus sont définitifs ; les frais sont arrondis.

Points de terminaison principaux

Commencez par créer une tâche de génération, puis interrogez ou vérifiez votre solde créditeur.

Créer une vidéo Sora 2 Pro

Soumettez des tâches de texte, d'image ou de storyboard, déduisez immédiatement les crédits et recevez l'ID de tâche.

Méthode: POSTChemin: /api/v1/video/sora-pro

Paramètres de charge utile

  • modèle : obligatoire. Utilisez l'une des chaînes de modèle prises en charge ci-dessus.
  • invite : obligatoire, sauf pour le storyboard. Décrivez la scène que vous souhaitez générer.
  • imageData : requis pour la conversion d'image en vidéo. URL de données Base64 avec le préfixe "data:image/*;base64,".
  • imageUrl : facultatif. URL de l'image publique si vous préférez ne pas envoyer en base64.
  • aspectRatio : facultatif. "paysage" ou "portrait" (paysage par défaut).
  • nFrames : facultatif. "10"/"15"/"25" (25 est un storyboard uniquement).
  • taille : facultatif (texte/image Pro). « standard » ou « élevé ».
  • RemoveWatermark : facultatif (texte/image). Supprimer l'indicateur de filigrane, vrai par défaut.
  • plans : requis pour le storyboard. Tableau de plans avec scène et durée.
  • isPublic : facultatif. Si le résultat est public, vrai par défaut.

Remarques

  • Modèles pris en charge : sora-2-text-to-video, sora-2-image-to-video, sora-2-text-to-video-stable, sora-2-image-to-video-stable, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-storyboard.
  • Les crédits sont déduits lors de la soumission ; Les travaux ayant échoué sont automatiquement remboursés.
  • Le mode Storyboard nécessite le tableau de plans.

Structure des plans

Requis pour les demandes de storyboard ; chaque élément définit une scène et une durée.

[
  { "scene": "Un café cosy au lever du soleil, une lumière chaude.", "duration": 7.5 }
]
  • scène : Description du plan.
  • durée : secondes (prend en charge les décimales comme 7,5).

Exemple de demande

curl -X POST https://sora2-api.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": "Un travelling cinématographique à travers un marché de rue éclairé au néon au crépuscule.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

Exemple de réponse

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890",
    "taskId": "task_1234567890"
  }
}

Vérifier le résultat de la génération

Interrogez l’état de la tâche et synchronisez les résultats.

Méthode: POSTChemin: /api/video-generations/check-result

Paramètres de charge utile

  • ID de tâche : obligatoire. L'identifiant renvoyé lors de la création de la tâche de génération.

Remarques

  • Renvoie le statut, la progression et result_url lorsqu'ils sont disponibles.
  • Peut renvoyer 4xx/5xx pour la validation, l'autorisation ou les cas introuvables.

Exemple de demande

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

Exemple de réponse

{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_1234567890",
    "status": "running",
    "progress": 0,
    "result_url": ""
  }
}

Obtenez des crédits utilisateur

Récupérez les crédits restants et le statut VIP.

Méthode: POSTChemin: /api/get-user-credits

Remarques

  • Nécessite une clé API ou une session valide.
  • Renvoie les champs left_credits et is_vip.

Exemple de demande

curl -X POST https://sora2-api.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Exemple de réponse

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_vip": true
  }
}

1. Créez la tâche

Envoyez /api/v1/video/sora-pro avec votre charge utile, puis stockez le taskId.

2. Suivez les progrès

Sondez /api/video-genrations/check-result jusqu'à ce que le statut soit réussi ou échoué.

3. Livrez la vidéo

Utilisez result_url/result_urls pour distribuer ou stocker la vidéo générée.

Questions fréquemment posées

Quels modèles sont pris en charge ?

Utilisez sora-2-text-to-video ou sora-2-image-to-video ; Sora 2 Pro ajoute des variantes de texte, d'image et de storyboard.

Quelles valeurs nFrames prend-il en charge ?

Utilisez « 10 » ou « 15 » pour tous les modes ; "25" est uniquement destiné au storyboard. Le texte/image Pro prend en charge la taille standard ou élevée.

Pourquoi le résultat du contrôle peut-il renvoyer 4xx/5xx ?

Le point de terminaison valide la propriété et la saisie, de sorte que les tâches invalides ou non autorisées peuvent renvoyer 4xx/5xx à côté du code/message.

Ressources utiles

Lancement avec l'Tikdek Video API

Créez votre clé API et commencez à générer des vidéos Sora 2 Pro en quelques minutes.