Documentation API

Référence API Seedance

Documentation API complète pour intégrer Seedance Video AI dans vos applications. Générez des vidéos de haute qualité à partir de prompts texte et d'images.

API REST

Réponses JSON

Génération vidéo

Authentification

L'API Seedance utilise l'authentification par Bearer Token. Incluez votre token API dans l'en-tête Authorization :

Authorization: Bearer your-api-token-here

Note de sécurité : N'exposez jamais votre token API dans le code côté client ou les dépôts publics.

URL de base

Toutes les requêtes API doivent être envoyées à :

https://seedanceapi.org/v1

Points de terminaison API

POST

Générer une vidéo

/generate

Générez des vidéos de haute qualité à partir de prompts texte et d'images à l'aide de modèles IA.

Corps de la requête

Texte vers vidéo (T2V)

{
  "prompt": "cardi b bends over to pick up coins",
  "mode": "text",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1
}

Image vers vidéo (I2V)

{
  "prompt": "kissing",
  "mode": "img2img",
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 5,
  "framespersecond": 24,
  "seed": -1,
  "image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
}

Paramètres

Paramètre	Type	Description
prompt	chaîne	Description textuelle de la vidéo à générer
mode	chaîne	Mode de génération : "text" pour T2V ou "img2img" pour I2V
image_url	chaîne?	URL de l'image d'entrée (requis pour le mode img2img)
resolution	chaîne	Résolution vidéo : "480p", "720p" ou "1080p"
ratio	chaîne	Rapport d'aspect vidéo (par défaut : "adaptive")
duration	entier	Durée de la vidéo en secondes (par défaut : 5)
framespersecond	entier	Images par seconde (par défaut : 24)
seed	entier	Graine aléatoire pour des résultats reproductibles (par défaut : -1)

Réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_123456789"
  }
}

endpoints.generate.curl

Texte vers vidéo (T2V):

curl -X POST https://seedanceapi.org/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "cardi b bends over to pick up coins",
    "mode": "text",
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "seed": -1
  }'

Image vers vidéo (I2V):

curl -X POST https://seedanceapi.org/v1/generate \
  -H "Authorization: Bearer your-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "kissing",
    "mode": "img2img",
    "resolution": "480p",
    "ratio": "adaptive",
    "duration": 5,
    "framespersecond": 24,
    "seed": -1,
    "image_url": "https://tempfile.redpandaai.co/kieai/284/images/user-uploads/image (2).png"
  }'

GET

Obtenir le statut de la tâche

/status?task_id=xxxx

Vérifiez le statut d'une tâche de génération vidéo en cours ou terminée.

Paramètres

Paramètre	Type	Description
task_id	chaîne	ID de tâche retourné par le point de terminaison de génération

Réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "consumed_credits": 10,
    "created_at": "2024-01-01T00:00:00Z",
    "status": "completed",
    "task_id": "task_123456789",
    "user_request": {
      "prompt": "A beautiful landscape with flowing water",
      "model": "seedance-video-v1",
      "duration": 5
    },
    "user_response": {
      "video_url": "https://cdn.seedance.com/generated/video.mp4",
      "last_frame_url": "https://cdn.seedance.com/generated/last_frame.jpg"
    },
    "provider_status": "success",
    "model": "seedance-video-v1"
  }
}

endpoints.generate.curl

curl -X GET "https://seedanceapi.org/v1/status?task_id=task_123456789" \
  -H "Authorization: Bearer your-api-token"

Gestion des erreurs

L'API Seedance retourne des codes de statut HTTP standard et des messages d'erreur :

Codes de statut HTTP

200OK

400Bad Request

401Unauthorized

429Rate Limited

500Server Error

Format de réponse d'erreur

{
  "code": 400,
  "message": "Invalid request: The prompt parameter is required",
  "error": "INVALID_REQUEST"
}

Bonne pratique : Gérez toujours les erreurs avec élégance et vérifiez les codes de statut HTTP avant de traiter le corps de la réponse.

Limites de taux

100

requêtes/minute

Plan gratuit

1000

requêtes/minute

Plan Pro

5000

requêtes/minute

Entreprise

En-têtes de limite de taux : Chaque réponse inclut les en-têtes X-RateLimit-Remaining et X-RateLimit-Reset pour suivre votre utilisation actuelle.

Prêt à commencer ?

Obtenez votre clé API et commencez à créer des vidéos incroyables avec Seedance

Commencer Retour à l'accueil