Tikdek

Construit sur l'API Sora 2

Expédiez des expériences texte-vidéo soutenues par OpenAI Sora 2 et Sora Pro. Authentifiez-vous avec des clés API, interrogez l'état des tâches et diffusez les vidéos finales en quelques minutes.

Pourquoi les équipes s'appuient sur l'API Sora 2

Offrez des flux de travail de génération vidéo résilients avec des interrogations prévisibles, 20 requêtes simultanées et des téléchargements de stockage automatiques.

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.

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.

Authentification et URL de base

Tous les points de terminaison résident sous https://sora2-api.com/api. Fournissez la clé API créée dans la console via l'en-tête Authorization.

  • Envoyez l'en-tête Authorization: Bearer YOUR_API_KEY à chaque demande.
  • Utilisez Content-Type : application/json lors de la publication de charges utiles.
  • Chaque demande de génération déduit des crédits en fonction du modèle et de la durée : sora-2/sora-2-stable 10s (100) ou 15s (150), sora-2-pro (150) ; Les travaux ayant échoué sont automatiquement remboursés.

Points de terminaison principaux

Commencez par créer une tâche de génération, puis interrogez ou écoutez le résultat.

Créer une vidéo Sora 2

Lancez une tâche de génération Sora 2 ou Sora Pro avec des invites de texte en vidéo ou d'image en vidéo en option.

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

Paramètres de charge utile

  • model: Obligatoire. Utilisez "sora-2", "sora-2-stable" ou "sora-2-pro".
  • prompt: Obligatoire. Description en langage naturel de la scène que vous souhaitez que Sora crée.
  • imageData: Facultatif (recommandé). URL de données Base64 avec le préfixe « data:image/*;base64 » pour le mode image vers vidéo.
  • url: Optional. Legacy reference image URL; still supported but lower priority than imageData.
  • aspectRatio: Facultatif. Valeurs prises en charge : "9:16" (par défaut) ou "16:9".
  • isPublic: Facultatif. S'il faut afficher la vidéo publiquement ; la valeur par défaut est vraie.
  • remixTargetId: Facultatif (VIP uniquement). PID vidéo cible pour les fonctionnalités de continuation/remix.
  • characters: Facultatif (VIP uniquement). Tableau de contrôle des caractères ; chaque élément comprend une URL et des horodatages.

Remarques

  • Les réponses reviennent immédiatement avec un taskId ; interrogez le résultat de la vérification jusqu'à ce que l'état soit réussi ou échoué.

Exemple de demande

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-pro",
    "prompt": "A cinematic shot of a futuristic city at sunset, captured in 4K.",
    "imageData": "data:image/png;base64,iVBORw0KGgoAAA...",
    "aspectRatio": "9:16",
    "isPublic": true
  }'

Exemple de réponse

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

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

Interrogez le dernier statut d'une tâche de génération pour suivre la progression et récupérer les résultats.

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

Paramètres de charge utile

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

Remarques

  • Le point de terminaison vérifie que la tâche appartient à votre compte avant de renvoyer les données.
  • Les tâches ayant échoué renvoient automatiquement des crédits et exposent les métadonnées de remboursement dans la réponse.

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": {
    "status": "running",
    "progress": 35,
    "result_url": "https://your-domain.com/storage/videos/xxx.mp4",
    "result_urls": [
      "https://your-domain.com/storage/videos/xxx.mp4"
    ],
    "failure_reason": "",
    "error_message": null,
    "credits_refunded": false,
    "refund_trans_no": null,
    "result_pid": "s_xxx",
    "result_pids": [
      "s_xxx"
    ],
    "metadata": {
      "remixTargetId": "s_prev",
      "characters": [
        {
          "url": "https://.../hero.mp4",
          "timestamps": "0,3"
        }
      ]
    }
  }
}

Obtenez des crédits utilisateur et le statut VIP

Recherchez les crédits disponibles de l'utilisateur actuel et son statut d'adhésion VIP.

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

Remarques

  • Nécessite une session de connexion valide ou un jeton API pour accéder aux informations utilisateur.
  • Renvoie les champs de statut left_credits, is_recharged, is_pro 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_recharged": true,
    "is_pro": true,
    "is_vip": false
  }
}

1. Créez la tâche

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

2. 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é.

3. 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.

Ressources utiles

Lancez-vous avec Tikdek aujourd'hui

Créez votre clé API et commencez à générer des vidéos cinématographiques d'IA en quelques minutes.