Umstieg von fal, Replicateoder WaveSpeed

Nicht nur eine neue Basis-URL

Bei keiner der drei reicht es, die Basis-URL und den Schlüssel zu ändern. Jede Anfrage ändert sich außerdem so:

• Der Schlüssel: Authorization: Bearer mit einem Schlüssel, der mit sk_test_ oder sk_live_ beginnt.
• Die Modell-ID steht im Body als model, und eine ID deckt Text, ein Startbild und Referenzen ab.
• Ein Idempotency-Key-Header bei jeder Generierungsanfrage.
• Eine Preisobergrenze: max_credits oder eine quote_id von POST /v1/quotes.
• Das Ergebnis ist ein Auftrag: Frag GET /v1/jobs/{id} ab oder empfange unseren signierten Webhook.

fal

Am nächsten an unserer API: Die meisten Seedance-Feldnamen stammen von fal. Benenne außerdem image_urls in reference_image_urls um, sende duration als Zahl und verschiebe fal_webhook als webhook_url in den Body.

Replicate

Nimm die Felder aus input heraus. Benenne außerdem image in image_url, reference_images in reference_image_urls und webhook in webhook_url um.

WaveSpeed

Benenne außerdem image in image_url und reference_images in reference_image_urls um und verschiebe standard_webhook als webhook_url in den Body. Lies Ergebnisse über GET /v1/jobs/{id}.

Authentifizierung

Wohin Anfragen gehen und wie sie signiert werden.

Zugang zur Entwickler-API gibt es auf Antrag: Beantrage ihn im Studio unter API-Schlüssel. Der Schlüssel wird einmal angezeigt. Ein Entwicklerschlüssel verbraucht das Entwickler-API-Guthaben, und derselbe Schlüssel funktioniert als Bearer-Header am MCP-Server.

Modell-IDs

Bei den anderen steht die ID in der URL, bei uns im Body als model. Eine unserer IDs deckt Text, ein Startbild und Referenzen ab: Die Felder, die du sendest, entscheiden.

Für KI-Agenten

Klartext für KI-Agenten: Eingaben, zulässige Werte, jeder Preis und ein Anfragebeispielseedance-2.0-fastseedance-2.0-miniqwen-image-2512-lightningqwen-image-2512qwen-image-edit-2511-lightningqwen-image-edit-2511

Seedance 2.0, Feld für Feld

Unsere Namen folgen fal, wo fal das Feld hat, und die Hinweise sagen, wo sie abweichen. Die Felder stehen auf der obersten Ebene des JSON-Bodys; Replicate verpackt sie in input.

Seedance-Felder der anderen ohne Gegenstück bei uns. Unverändert gesendet, werden sie als unbekannte Felder abgelehnt (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, Feld für Feld

Unser Bild-Body ist kleiner als ihrer: eine Größe und ein Seitenverhältnis statt freier Pixelmaße, ein Bild pro Auftrag und keine Sampler-Einstellungen.

Qwen-Image-Felder der anderen ohne Gegenstück bei uns. Unverändert gesendet, werden sie als unbekannte Felder abgelehnt (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

Asynchrone Aufträge und Webhooks

Alle vier führen Aufträge im Hintergrund aus. So nennt jede Plattform die Schritte:

Unser Webhook-Body ist der Auftrag selbst, und die Signatur ist unsere eigene: Code, der deren Webhooks prüft, lehnt unsere ab. So prüfst du unsere

Idempotenz

Jede Generierungsanfrage braucht einen Idempotency-Key-Header mit 1 bis 255 sichtbaren ASCII-Zeichen. Derselbe Schlüssel innerhalb von 24 Stunden liefert denselben Auftrag mit HTTP 200, also erzeugt oder berechnet eine Wiederholung nach einem Timeout nie einen zweiten Auftrag.

Keine der drei dokumentiert einen Idempotenzschlüssel für das Erstellen eines Auftrags (Stand 2026-10-22): fal empfiehlt, Webhooks anhand von request_id zu deduplizieren, und WaveSpeed bittet darum, einmal einzureichen und vor einem erneuten Einreichen nach dem Task zu suchen. Gib jedem Auftrag einen Schlüssel und verwende ihn bei jeder Wiederholung erneut.

Was nicht kompatibel ist

Unverändert gesendet, schlagen diese hier fehl oder werden abgelehnt:

• Die Client-Bibliotheken der drei (fal_client, replicate, wavespeed) rufen /v1 nicht auf. Nutze einfaches HTTP, das OpenAPI-Dokument oder den MCP-Server.
• Die Antwortformate der drei: Ein Auftrag ist hier ein Job mit outputs[].url, kein fal-Ergebnis, keine Replicate-Prediction und kein WaveSpeed-Wrapper data.
• Endbilder: fal end_image_url, Replicate last_frame_image, WaveSpeed last_image.
• Referenzvideos und Referenzaudio: fal video_urls und audio_urls, Replicate und WaveSpeed reference_videos und reference_audios.
• Eine automatische Länge oder ein automatisches Seitenverhältnis, die Seitenverhältnisse 4:3, 3:4 und 21:9 sowie Generierungen in 1080p oder 4K. Höhere Auflösungen sind hier ein separater Schritt, enhance, gekennzeichnet als AI Enhanced.
• Ein Startbild zusammen mit Referenzbildern. Auch Replicate lehnt das ab.
• In einem Aufruf auf das Ergebnis warten (fal.run, Prefer: wait bei Replicate, enable_sync_mode bei WaveSpeed): Jeder Auftrag läuft hier asynchron.
• Mehrere Bilder pro Auftrag, Ausgabe als PNG oder WebP, freie Breite und Höhe, mehrere Ausgangsbilder für eine Bearbeitung, LoRAs und Sampler-Einstellungen.
• Die Webhook-Prüfung der drei: Unsere Zustellungen tragen X-Signature, einen HMAC-SHA256 mit deinem whsec_-Secret, nicht die ED25519-Signatur von fal oder den webhook-signature-Header.
• Bezahlen nach Nutzung: Credits sind im Voraus bezahlt, jeder Auftrag hat eine Obergrenze, und ein Auftrag über max_credits wird abgelehnt, nicht berechnet.
• Langlebige Ausgabe-Links: Unsere gelten 24 Stunden. Ruf den Auftrag erneut ab, um einen frischen zu bekommen.

Vorher und nachher

Dieselbe Anfrage an Seedance 2.0 Fast mit Startbild, wie jede Plattform sie dokumentiert, dann über /v1. Die Preisobergrenze stammt aus unserer Preis-Engine.

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

Es sind unsere Preise

Jeder Auftrag bekommt hier vor dem Start ein Preisangebot in Credits (1 US$ = 100 Credits) und kostet nie mehr als sein Preisangebot oder max_credits.

Was fal, Replicate und WaveSpeed berechnen, steht auf deren eigenen Seiten. Unsere Vergleichsseiten listen ihre veröffentlichten Preise für Seedance 2.0 auf, jeweils mit dem Datum, an dem sie abgelesen wurden.