Clé API Seedance : obtenir, configurer et tester

01Créer une clé API OmniaKey

Connectez-vous, ouvrez API Keys et créez une clé pour votre application. Vérifiez son quota, son expiration et ses restrictions de modèles. Ajoutez du solde avant de lancer des requêtes de génération.

02Définir la clé et l'URL de l'API

Exécutez les commandes dans votre terminal et remplacez l'espace réservé par votre clé. Gardez la clé sur votre serveur ou dans un gestionnaire de secrets. Ne la placez jamais dans du code côté navigateur ni dans un dépôt public.

export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Vérifier l'authentification

Demandez la liste des modèles sans lancer de tâche de génération. Une réponse réussie est du JSON avec un tableau data. Cela vérifie l'accès de la clé, sans garantir que chaque modèle est activé pour votre compte.

curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Utiliser le format de requête du modèle

Sélectionnez un modèle sur la page de la famille, copiez son identifiant API et suivez la documentation API correspondante. L'authentification seule ne vérifie pas vos paramètres de génération.

La génération d'images et de vidéos utilise POST /v1/media/tasks. Conservez la même Idempotency-Key lors d'un nouvel envoi de la même soumission, enregistrez l'ID de tâche renvoyé et interrogez GET /v1/media/tasks/{id} pour le résultat.

Exemple de requête de génération (facturée)

Cette requête utilise le solde de votre compte. Vérifiez d'abord le tarif du modèle choisi. L'exemple suit le format de requête documenté ; votre compte doit toujours avoir accès au modèle.

curl --fail-with-body 'https://api.omniakey.com/v1/media/tasks' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-first-request-001" \
  -d '{
  "model": "dreamina-seedance-2-5-260628",
  "type": "video",
  "operation": "text_to_video",
  "input": {
    "prompt": "A paper boat on a quiet lake at sunset."
  },
  "parameters": {
    "duration": 5,
    "resolution": "720P",
    "ratio": "16:9"
  }
}'

Interroger la tâche média

Remplacez YOUR_TASK_ID par l'identifiant renvoyé par la requête de création. Interrogez jusqu'à ce que la tâche atteigne un état final. Pour une tâche réussie, téléchargez les URL dans assets avant leur expiration. N'utilisez une nouvelle clé d'idempotence que pour une nouvelle tâche.

curl --fail-with-body "https://api.omniakey.com/v1/media/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"