Tâches asynchrones et webhooks
Chaque génération renvoie aussitôt un 202 et un identifiant de tâche. Interrogez la tâche ou recevez des webhooks signés à chaque changement d’état.
API Seedance 2.0facturée à la seconde
Une seule clé pour Seedance 2.0 Mini et Fast. Demandez d’abord un devis, envoyez avec une clé d’idempotence, et recevez un webhook quand la tâche est terminée.
Les vraies générations ne sont pas encore ouvertes
Laissez votre e-mail et nous vous écrirons une seule fois, à leur ouverture.
L’accès à l’API développeur se fait sur demande.
curl https://api.pershot.app/v1/videos/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0-fast",
"prompt": "Perfume mist in hard side light. Slow push-in, black background, grain.",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"max_credits": 34
}'{
"id": "job_01J9ZK4T8W",
"object": "job",
"kind": "video",
"status": "queued",
"money_status": "reserved",
"queue_position": 2,
"requested_model": "seedance-2.0-fast",
"credits_quoted": 34,
"credits_charged": null
}Tarifs à la secondeselon la résolution
Facturé à la seconde de vidéo. Une tâche qui lit une vidéo facture aussi ses secondes d’entrée, à un tarif plus bas.
| Modèle | 480p | 720p |
|---|---|---|
| Seedance 2.0 MiniEntrée texte ou image | 0,020 $/s≈ 500 s pour 10 $ | 0,042 $/s≈ 238 s pour 10 $ |
| Seedance 2.0 MiniAvec vidéo en entrée | 0,012 $/s≈ 833 s pour 10 $ | 0,025 $/s≈ 400 s pour 10 $ |
| Seedance 2.0 FastEntrée texte ou image | 0,031 $/s≈ 322 s pour 10 $ | 0,067 $/s≈ 149 s pour 10 $ |
| Seedance 2.0 FastAvec vidéo en entrée | 0,019 $/s≈ 526 s pour 10 $ | 0,040 $/s≈ 250 s pour 10 $ |
Ce que chaque appelapporte
Un plafond sur chaque appel
Envoyez un quote_id ou un plafond max_credits. Nous ne facturons jamais au-delà, et une requête Auto sans plafond est refusée.
Des nouvelles tentatives jamais facturées deux fois
Le même Idempotency-Key dans les 24 heures renvoie la même tâche : une nouvelle tentative après un délai dépassé est donc sans risque.
Une utilisation que vous pouvez rapprocher
Utilisation par jour, par clé et par modèle, en JSON ou en CSV. Les prix viennent de la grille tarifaire de l’API développeur, jamais d’une clé.
Vous venezde fal ou Replicate ?
Les noms de champs reprennent les entrées Seedance courantes quand elles existent. L’accès se fait sur demande, pour automatiser votre propre travail. Ce qui change :
- Point d’accès
- POST https://api.pershot.app/v1/videos/generations, puis GET https://api.pershot.app/v1/jobs/job_… avec l’identifiant renvoyé pour obtenir le résultat.
- Authentification
- Authorization: Bearer avec une clé qui commence par sk_test_ ou sk_live_.
- Idempotence
- Un en-tête Idempotency-Key sur chaque requête de génération.
- Plafond de prix
- Un plafond max_credits, ou un quote_id obtenu avec POST /v1/quotes.
- Audio
- generate_audio true ou false ; le prix est le même.
- ID utilisateur
- Pour les comptes développeur approuvés (sur demande) : marquez une requête avec votre propre identifiant utilisateur dans le champ facultatif end_user_id, et l’utilisation l’affiche.
Aussi dans Claude et Codex
Connectez-vous via MCP : cela dépense votre solde création, comme dans le studio, avec une vérification du prix avant toute dépense. Ce solde est distinct du solde de l’API développeur.
Questionssur l’API
Les clés API sont-elles payantes ?
Non. Les clés sont gratuites, et l’accès se fait sur demande : demandez-le dans le studio. Chaque appel est payé sur votre solde d’API développeur, distinct du solde création.
Comment un appel est-il facturé ?
À la seconde facturée : 0,067 $ en 720p sur Fast, 0,020 $ en 480p sur Mini. Les secondes de vidéo en entrée comptent aussi, à un tarif plus bas.
Les tâches échouées sont-elles facturées ?
Non. Les crédits réservés sont remboursés quand une tâche ne produit aucune vidéo (elle échoue ou le contenu est refusé) ou qu’un contrôle de sécurité bloque le résultat, et la tâche indique pourquoi. Une tâche qui livre une vidéo est facturée.
Quelles sont les limites ?
60 requêtes par minute et par clé. Le compte API développeur exécute 3 tâches à la fois par défaut, davantage sur demande. Un abonnement relève la limite du compte création, pas celle-ci, et des clés supplémentaires n’ajoutent pas de capacité.
Quand puis-je l’utiliser ?
Les vraies générations Seedance ne sont pas encore ouvertes. Laissez votre e-mail sur la page d’un modèle et nous vous écrirons une seule fois, à leur ouverture.