Vous venez de fal, Replicateou WaveSpeed

Pas un simple changement d’URL de base

Changer l’URL de base et la clé ne suffit sur aucune des trois. Chaque requête change aussi sur ces points :

• La clé : Authorization: Bearer avec une clé qui commence par sk_test_ ou sk_live_.
• L’identifiant du modèle va dans le corps, sous model, et un seul identifiant couvre le texte, une première image et des références.
• Un en-tête Idempotency-Key sur chaque requête de génération.
• Un plafond de prix : max_credits, ou un quote_id obtenu avec POST /v1/quotes.
• Le résultat est une tâche : interrogez GET /v1/jobs/{id} ou recevez notre webhook signé.

fal

Le plus proche de notre API : la plupart des noms de champs Seedance sont ceux de fal. Renommez aussi image_urls en reference_image_urls, envoyez duration sous forme de nombre, et déplacez fal_webhook dans le corps, sous webhook_url.

Replicate

Sortez les champs de input. Renommez aussi image en image_url, reference_images en reference_image_urls et webhook en webhook_url.

WaveSpeed

Renommez aussi image en image_url et reference_images en reference_image_urls, et déplacez standard_webhook dans le corps, sous webhook_url. Lisez les résultats avec GET /v1/jobs/{id}.

Authentification

Où vont les requêtes et comment elles sont signées.

L’accès à l’API développeur se fait sur demande : demandez-le dans le studio, sous Clés API. La clé n’est affichée qu’une fois. Une clé développeur dépense le solde de l’API développeur, et la même clé fonctionne comme en-tête Bearer sur le serveur MCP.

Identifiants de modèle

Les leurs vont dans l’URL ; le nôtre va dans le corps, sous model. Un seul de nos identifiants couvre le texte, une première image et des références : ce sont les champs envoyés qui décident.

Pour les agents IA

Texte brut pour les agents IA : entrées, valeurs admises, chaque prix et un exemple de requêteseedance-2.0-fastseedance-2.0-miniqwen-image-2512-lightningqwen-image-2512qwen-image-edit-2511-lightningqwen-image-edit-2511

Seedance 2.0, champ par champ

Nos noms suivent ceux de fal quand fal a le champ, et les remarques indiquent les différences. Les champs se trouvent au premier niveau du corps JSON ; Replicate les enveloppe dans input.

Leurs champs Seedance sans équivalent ici. Envoyés tels quels, ils sont refusés comme champs inconnus (400 invalid_request).

fal

end_image_urlvideo_urlsaudio_urlsbitrate_modecodec

Replicate

last_frame_imagereference_videosreference_audios

WaveSpeed

last_imagereference_videosreference_audiosenable_web_search

Qwen-Image, champ par champ

Notre corps de requête d’image est plus réduit que le leur : une taille et un format d’image au lieu de pixels libres, une image par tâche, et aucun réglage d’échantillonneur.

Leurs champs Qwen-Image sans équivalent ici. Envoyés tels quels, ils sont refusés comme champs inconnus (400 invalid_request).

fal

negative_promptnum_inference_stepsguidance_scalenum_imagesoutput_formataccelerationenable_safety_checkersync_modeloras

Replicate

negative_promptstrengthwidthheightguidancenum_inference_stepsgo_fastoutput_formatoutput_qualitydisable_safety_checkerlora_weightslora_scale

WaveSpeed

widthheightoutput_formatenable_base64_outputenable_sync_mode

Tâches asynchrones et webhooks

Les quatre exécutent les tâches en arrière-plan. Comment chacun nomme les étapes :

Le corps de notre webhook est la tâche elle-même, et la signature est la nôtre : un code qui vérifie leurs webhooks refusera les nôtres. Comment vérifier les nôtres

Idempotence

Chaque requête de génération exige un en-tête Idempotency-Key de 1 à 255 caractères ASCII visibles. La même clé dans les 24 heures renvoie la même tâche avec HTTP 200 : une nouvelle tentative après un délai dépassé ne crée ni ne facture jamais une seconde tâche.

Aucune des trois ne documente de clé d’idempotence pour créer une tâche (2026-10-22) : fal suggère de dédoublonner les webhooks par request_id, et WaveSpeed demande de soumettre une seule fois et de rechercher la tâche avant de la soumettre à nouveau. Donnez à chaque tâche une clé et réutilisez-la à chaque nouvelle tentative.

Ce qui n’est pas compatible

Envoyés tels quels, ces éléments échouent ou sont refusés ici :

• Leurs bibliothèques clientes (fal_client, replicate, wavespeed) n’appellent pas /v1. Utilisez du HTTP simple, le document OpenAPI ou le serveur MCP.
• Leurs formats de réponse : ici, une tâche est un Job avec outputs[].url, pas un résultat fal, une prédiction Replicate ni une enveloppe data WaveSpeed.
• Les dernières images : fal end_image_url, Replicate last_frame_image, WaveSpeed last_image.
• Les vidéos et l’audio de référence : fal video_urls et audio_urls, Replicate et WaveSpeed reference_videos et reference_audios.
• Une durée ou un format automatique, les formats 4:3, 3:4 et 21:9, et les rendus 1080p ou 4K. Ici, les résolutions supérieures sont une étape distincte, enhance, étiquetée AI Enhanced.
• Une première image avec des images de référence. Replicate refuse aussi cette combinaison.
• Attendre le résultat en un seul appel (fal.run, Prefer: wait chez Replicate, enable_sync_mode chez WaveSpeed) : ici, chaque tâche est asynchrone.
• Plusieurs images par tâche, une sortie PNG ou WebP, une largeur et une hauteur libres, plusieurs images sources pour une retouche, les LoRA et les réglages d’échantillonneur.
• Leur vérification des webhooks : nos livraisons portent X-Signature, un HMAC-SHA256 avec votre secret whsec_, pas la signature ED25519 de fal ni l’en-tête webhook-signature.
• Le paiement après usage : les crédits sont prépayés, chaque tâche a un plafond, et une tâche au-delà de max_credits est refusée, pas facturée.
• Les liens de sortie durables : les nôtres durent 24 heures. Relisez la tâche pour en obtenir un nouveau.

Avant et après

La même requête Seedance 2.0 Fast avec une première image, telle que chaque plateforme la documente, puis sur /v1. Le plafond de prix vient de notre moteur de prix.

curl -X POST https://queue.fal.run/bytedance/seedance-2.0/fast/image-to-video \
  -H "Authorization: Key $FAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Slow dolly-in on a ceramic mug on a wooden table, morning window light",
    "image_url": "https://example.com/first-frame.jpg",
    "duration": "5",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

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": "Slow dolly-in on a ceramic mug on a wooden table, morning window light",
    "image_url": "https://example.com/first-frame.jpg",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "max_credits": 34
  }'

Les prix sont les nôtres

Chaque tâche fait l’objet d’un devis en crédits avant d’être lancée (1 $ US = 100 crédits) et ne coûte jamais plus que son devis ou max_credits.

Ce que facturent fal, Replicate et WaveSpeed figure sur leurs propres pages. Nos pages de comparaison indiquent leurs prix publiés pour Seedance 2.0, chacun avec la date à laquelle il a été relevé.