Si vienes de fal, Replicateo WaveSpeed

No es solo cambiar la URL base

En ninguna de las tres basta con cambiar la URL base y la clave. Cada solicitud también cambia en estos puntos:

• La clave: Authorization: Bearer con una clave que empieza por sk_test_ o sk_live_.
• El id del modelo va en el cuerpo como model, y un solo id cubre texto, primer fotograma y referencias.
• Un encabezado Idempotency-Key en cada solicitud de generación.
• Un límite de precio: max_credits, o un quote_id de POST /v1/quotes.
• El resultado es una tarea: consulta GET /v1/jobs/{id} o recibe nuestro webhook firmado.

fal

La más parecida a la nuestra: la mayoría de los nombres de campo de Seedance son los de fal. Además, renombra image_urls a reference_image_urls, envía duration como número y pasa fal_webhook al cuerpo como webhook_url.

Replicate

Saca los campos de input. Además, renombra image a image_url, reference_images a reference_image_urls y webhook a webhook_url.

WaveSpeed

Además, renombra image a image_url y reference_images a reference_image_urls, y pasa standard_webhook al cuerpo como webhook_url. Lee los resultados de GET /v1/jobs/{id}.

Autenticación

Adónde van las solicitudes y cómo se autentican.

El acceso a la API para desarrolladores requiere aprobación previa: pídelo en el estudio, en Claves de API. La clave se muestra una sola vez. Una clave de desarrollador gasta el saldo de la API para desarrolladores, y la misma clave sirve como encabezado Bearer en el servidor MCP.

Ids de modelo

Los de ellos van en la URL; el nuestro va en el cuerpo como model. Un solo id nuestro cubre texto, primer fotograma y referencias: deciden los campos que envías.

Para agentes de IA

Texto plano para agentes de IA: entradas, valores admitidos, cada precio y un ejemplo de solicitudseedance-2.0-fastseedance-2.0-miniqwen-image-2512-lightningqwen-image-2512qwen-image-edit-2511-lightningqwen-image-edit-2511

Seedance 2.0, campo por campo

Nuestros nombres siguen los de fal cuando fal tiene el campo, y las notas indican dónde difieren. Los campos van en el nivel superior del cuerpo JSON; Replicate los envuelve en input.

Sus campos de Seedance sin equivalente aquí. Si se envían tal cual, se rechazan como campos desconocidos (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 por campo

Nuestro cuerpo de imagen es más pequeño que el suyo: un tamaño y una relación de aspecto en lugar de píxeles libres, una imagen por tarea y sin ajustes del sampler.

Sus campos de Qwen-Image sin equivalente aquí. Si se envían tal cual, se rechazan como campos desconocidos (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

Tareas asíncronas y webhooks

Las cuatro ejecutan las tareas en segundo plano. Así llama cada una a los pasos:

El cuerpo de nuestro webhook es la propia tarea, y la firma es nuestra: el código que verifica sus webhooks rechazará los nuestros. Cómo verificar los nuestros

Idempotencia

Cada solicitud de generación necesita un encabezado Idempotency-Key, de 1 a 255 caracteres ASCII visibles. La misma clave dentro de 24 horas devuelve la misma tarea con HTTP 200, así que un reintento después de un tiempo de espera agotado nunca crea ni cobra una segunda tarea.

Ninguna de las tres documenta una clave de idempotencia para crear tareas (2026-10-22): fal sugiere eliminar duplicados de webhooks por request_id, y WaveSpeed pide enviar una sola vez y buscar la tarea antes de volver a enviarla. Dale a cada tarea una clave y reutilízala en cada reintento.

Lo que no es compatible

Si se envían tal cual, estos fallan o se rechazan aquí:

• Sus bibliotecas cliente (fal_client, replicate, wavespeed) no llaman a /v1. Usa HTTP directo, el documento OpenAPI o el servidor MCP.
• Sus formas de respuesta: aquí una tarea es un Job con outputs[].url, no un resultado de fal, una predicción de Replicate ni un envoltorio data de WaveSpeed.
• Últimos fotogramas: fal end_image_url, Replicate last_frame_image, WaveSpeed last_image.
• Videos y audio de referencia: fal video_urls y audio_urls, Replicate y WaveSpeed reference_videos y reference_audios.
• Una duración o relación automática, las relaciones 4:3, 3:4 y 21:9, y los renders en 1080p o 4K. Aquí las resoluciones más altas son un paso aparte, enhance, con la etiqueta AI Enhanced.
• Un primer fotograma junto con imágenes de referencia. Replicate también lo rechaza.
• Esperar el resultado en una sola llamada (fal.run, Prefer: wait de Replicate, enable_sync_mode de WaveSpeed): aquí cada tarea es asíncrona.
• Varias imágenes por tarea, salida en PNG o WebP, ancho y alto libres, varias imágenes de origen para una edición, LoRA y ajustes del sampler.
• Su verificación de webhooks: nuestras entregas llevan X-Signature, un HMAC-SHA256 con tu secreto whsec_, no la firma ED25519 de fal ni el encabezado webhook-signature.
• Pagar después de usar: los créditos son prepagados, cada tarea tiene un límite y una tarea por encima de max_credits se rechaza, no se cobra.
• Enlaces de salida de larga duración: los nuestros duran 24 horas. Vuelve a leer la tarea para obtener uno nuevo.

Antes y después

La misma solicitud de Seedance 2.0 Fast con un primer fotograma, tal como la documenta cada plataforma, y luego en /v1. El límite de precio sale de nuestro motor de precios.

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

Los precios son los nuestros

Aquí cada tarea se cotiza en créditos antes de ejecutarse (1 US$ = 100 créditos) y nunca cuesta más que su cotización o max_credits.

Lo que cobran fal, Replicate y WaveSpeed está en sus propias páginas. Nuestras páginas de comparación muestran sus precios publicados de Seedance 2.0, cada uno con la fecha en que se consultó.