Vindo do fal, do Replicateou do WaveSpeed

Não é só trocar a URL base

Em nenhuma das três basta trocar a URL base e a chave. Toda requisição também muda nestes pontos:

• A chave: Authorization: Bearer com uma chave que começa com sk_test_ ou sk_live_.
• O ID do modelo vai no corpo como model, e um só ID cobre texto, um primeiro quadro e referências.
• Um cabeçalho Idempotency-Key em toda requisição de geração.
• Um limite de preço: max_credits ou um quote_id de POST /v1/quotes.
• O resultado é uma tarefa: consulte GET /v1/jobs/{id} ou receba nosso webhook assinado.

fal

O mais parecido com o nosso: a maioria dos nomes de campo do Seedance vem do fal. Também renomeie image_urls para reference_image_urls, envie duration como número e mova fal_webhook para o corpo como webhook_url.

Replicate

Tire os campos de dentro de input. Também renomeie image para image_url, reference_images para reference_image_urls e webhook para webhook_url.

WaveSpeed

Também renomeie image para image_url e reference_images para reference_image_urls, e mova standard_webhook para o corpo como webhook_url. Leia os resultados em GET /v1/jobs/{id}.

Autenticação

Para onde vão as requisições e como são assinadas.

O acesso à API para desenvolvedores é por solicitação: peça no estúdio, em Chaves de API. A chave é exibida uma única vez. Uma chave de desenvolvedor usa o saldo da API para desenvolvedores, e a mesma chave funciona como cabeçalho Bearer no servidor MCP.

IDs de modelo

Os deles vão na URL; o nosso vai no corpo como model. Um dos nossos IDs cobre texto, um primeiro quadro e referências: os campos que você envia decidem.

Para agentes de IA

Texto simples para agentes de IA: entradas, valores aceitos, cada preço e um exemplo de requisiçãoseedance-2.0-fastseedance-2.0-miniqwen-image-2512-lightningqwen-image-2512qwen-image-edit-2511-lightningqwen-image-edit-2511

Seedance 2.0, campo a campo

Nossos nomes seguem os do fal quando o fal tem o campo, e as observações dizem onde diferem. Os campos ficam no nível superior do corpo JSON; o Replicate os coloca dentro de input.

Campos do Seedance deles sem equivalente aqui. Enviados como estão, são recusados como campos desconhecidos (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 a campo

Nosso corpo de imagem é menor que o deles: um tamanho e uma proporção em vez de pixels livres, uma imagem por tarefa e nenhuma configuração de sampler.

Campos do Qwen-Image deles sem equivalente aqui. Enviados como estão, são recusados como campos desconhecidos (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

Tarefas assíncronas e webhooks

As quatro executam tarefas em segundo plano. Como cada uma chama as etapas:

O corpo do nosso webhook é a própria tarefa, e a assinatura é nossa: um código que verifica os webhooks deles vai recusar os nossos. Como verificar os nossos

Idempotência

Toda requisição de geração exige um cabeçalho Idempotency-Key, de 1 a 255 caracteres ASCII visíveis. A mesma chave dentro de 24 horas retorna a mesma tarefa com HTTP 200, então uma nova tentativa após um timeout nunca cria nem cobra uma segunda tarefa.

Nenhuma das três documenta uma chave de idempotência para criar uma tarefa (em 2026-10-22): o fal sugere eliminar webhooks duplicados pelo request_id, e o WaveSpeed pede que você envie uma vez e procure a tarefa antes de reenviar. Dê uma chave a cada tarefa e reutilize-a em toda nova tentativa.

O que não é compatível

Enviados como estão, estes itens falham ou são recusados aqui:

• As bibliotecas de cliente deles (fal_client, replicate, wavespeed) não chamam o /v1. Use HTTP puro, o documento OpenAPI ou o servidor MCP.
• Os formatos de resposta deles: aqui uma tarefa é um Job com outputs[].url, não um resultado do fal, uma prediction do Replicate nem um wrapper data do WaveSpeed.
• Últimos quadros: fal end_image_url, Replicate last_frame_image, WaveSpeed last_image.
• Vídeos e áudios de referência: fal video_urls e audio_urls, Replicate e WaveSpeed reference_videos e reference_audios.
• Duração ou proporção automática, as proporções 4:3, 3:4 e 21:9 e gerações em 1080p ou 4K. Aqui, resoluções maiores são uma etapa separada, enhance, com o selo AI Enhanced.
• Um primeiro quadro junto com imagens de referência. O Replicate também recusa isso.
• Esperar o resultado em uma chamada (fal.run, Prefer: wait do Replicate, enable_sync_mode do WaveSpeed): aqui toda tarefa é assíncrona.
• Várias imagens por tarefa, saída em PNG ou WebP, largura e altura livres, várias imagens de origem em uma edição, LoRAs e configurações de sampler.
• A verificação de webhook deles: nossas entregas trazem X-Signature, um HMAC-SHA256 com o seu segredo whsec_, e não a assinatura ED25519 do fal nem o cabeçalho webhook-signature.
• Pagar depois do uso: os créditos são pré-pagos, toda tarefa tem um limite, e uma tarefa acima de max_credits é recusada, não cobrada.
• Links de resultado duradouros: os nossos valem por 24 horas. Consulte a tarefa de novo para obter um novo.

Antes e depois

A mesma requisição ao Seedance 2.0 Fast com um primeiro quadro, como cada plataforma a documenta, e depois no /v1. O limite de preço vem do nosso motor de preços.

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

Os preços são nossos

Toda tarefa aqui é cotada em créditos antes de rodar (US$ 1 = 100 créditos) e nunca custa mais que a cotação ou o max_credits.

O que o fal, o Replicate e o WaveSpeed cobram está nas páginas deles. Nossas páginas de comparação listam os preços do Seedance 2.0 publicados por eles, cada um com a data em que foi consultado.