Se arrivi da fal, Replicateo WaveSpeed

Non basta cambiare l'URL di base

Cambiare l'URL di base e la chiave non basta su nessuna delle tre. Ogni richiesta cambia anche in questi punti:

• La chiave: Authorization: Bearer con una chiave che inizia con sk_test_ o sk_live_.
• L'id del modello va nel corpo come model, e un solo id copre testo, primo fotogramma e riferimenti.
• Un header Idempotency-Key in ogni richiesta di generazione.
• Un tetto di prezzo: max_credits, oppure un quote_id da POST /v1/quotes.
• Il risultato è un lavoro: interroga GET /v1/jobs/{id} o ricevi il nostro webhook firmato.

fal

La più simile alla nostra API: la maggior parte dei nomi dei campi di Seedance sono quelli di fal. Rinomina anche image_urls in reference_image_urls, invia duration come numero e sposta fal_webhook nel corpo come webhook_url.

Replicate

Togli i campi da input. Rinomina anche image in image_url, reference_images in reference_image_urls e webhook in webhook_url.

WaveSpeed

Rinomina anche image in image_url e reference_images in reference_image_urls, e sposta standard_webhook nel corpo come webhook_url. Leggi i risultati da GET /v1/jobs/{id}.

Autenticazione

Dove vanno le richieste e come vengono firmate.

L'accesso all'API per sviluppatori è su richiesta: chiedilo nello studio, in Chiavi API. La chiave viene mostrata una sola volta. Una chiave sviluppatore spende il saldo API sviluppatori, e la stessa chiave funziona come header Bearer sul server MCP.

Id dei modelli

I loro vanno nell'URL; il nostro va nel corpo come model. Un nostro id copre testo, primo fotogramma e riferimenti: decidono i campi che invii.

Per gli agenti IA

Testo semplice per gli agenti IA: input, valori ammessi, ogni prezzo e un esempio di richiestaseedance-2.0-fastseedance-2.0-miniqwen-image-2512-lightningqwen-image-2512qwen-image-edit-2511-lightningqwen-image-edit-2511

Seedance 2.0, campo per campo

I nostri nomi seguono quelli di fal quando fal ha il campo, e le note indicano dove differiscono. I campi stanno al primo livello del corpo JSON; Replicate li racchiude in input.

I loro campi di Seedance senza un corrispettivo qui. Se li invii così come sono, vengono rifiutati come campi sconosciuti (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, campo per campo

Il nostro corpo per le immagini è più ridotto del loro: dimensione e proporzioni invece di pixel liberi, un'immagine per lavoro e nessuna impostazione del sampler.

I loro campi di Qwen-Image senza un corrispettivo qui. Se li invii così come sono, vengono rifiutati come campi sconosciuti (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

Lavori asincroni e webhook

Tutte e quattro eseguono i lavori in background. Come ognuna chiama i passaggi:

Il corpo del nostro webhook è il lavoro stesso, e la firma è la nostra: il codice che verifica i loro webhook rifiuterà i nostri. Come verificare i nostri

Idempotenza

Ogni richiesta di generazione richiede un header Idempotency-Key, da 1 a 255 caratteri ASCII visibili. La stessa chiave entro 24 ore restituisce lo stesso lavoro con HTTP 200, quindi un nuovo tentativo dopo un timeout non crea né addebita mai un secondo lavoro.

Nessuna delle tre documenta una chiave di idempotenza per creare un lavoro (2026-10-22): fal suggerisce di eliminare i webhook duplicati in base a request_id, e WaveSpeed chiede di inviare una sola volta e di cercare il task prima di reinviarlo. Dai a ogni lavoro una chiave e riusala a ogni nuovo tentativo.

Cosa non è compatibile

Se li invii così come sono, questi elementi non funzionano o vengono rifiutati qui:

• Le loro librerie client (fal_client, replicate, wavespeed) non chiamano /v1. Usa HTTP semplice, il documento OpenAPI o il server MCP.
• Le loro strutture di risposta: qui un lavoro è un Job con outputs[].url, non un risultato di fal, una previsione di Replicate o un wrapper data di WaveSpeed.
• Ultimi fotogrammi: fal end_image_url, Replicate last_frame_image, WaveSpeed last_image.
• Video e audio di riferimento: fal video_urls e audio_urls, Replicate e WaveSpeed reference_videos e reference_audios.
• Durata o proporzioni automatiche, le proporzioni 4:3, 3:4 e 21:9, e i rendering a 1080p o 4K. Qui le risoluzioni più alte sono un passaggio separato, enhance, etichettato AI Enhanced.
• Un primo fotogramma insieme a immagini di riferimento. Anche Replicate lo rifiuta.
• Attendere il risultato in una sola chiamata (fal.run, Prefer: wait di Replicate, enable_sync_mode di WaveSpeed): qui ogni lavoro è asincrono.
• Più immagini per lavoro, output PNG o WebP, larghezza e altezza libere, più immagini di partenza per una modifica, LoRA e impostazioni del sampler.
• La loro verifica dei webhook: le nostre consegne portano X-Signature, un HMAC-SHA256 con il tuo segreto whsec_, non la firma ED25519 di fal né l'header webhook-signature.
• Pagare dopo l'uso: i crediti sono prepagati, ogni lavoro ha un tetto, e un lavoro sopra max_credits viene rifiutato, non addebitato.
• Link ai risultati di lunga durata: i nostri durano 24 ore. Richiedi di nuovo il lavoro per averne uno nuovo.

Prima e dopo

La stessa richiesta a Seedance 2.0 Fast con un primo fotogramma, come la documenta ogni piattaforma, poi su /v1. Il tetto di prezzo viene dal nostro motore dei prezzi.

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
  }'

I prezzi sono i nostri

Ogni lavoro ha un preventivo in crediti prima dell'esecuzione (1 US$ = 100 crediti) e non costa mai più del suo preventivo o di max_credits.

Quanto fanno pagare fal, Replicate e WaveSpeed è indicato sulle loro pagine. Le nostre pagine di confronto riportano i loro prezzi pubblicati per Seedance 2.0, ognuno con la data in cui è stato letto.