fal、ReplicateまたはWaveSpeedからの移行

ベースURLの置き換えだけでは済みません

3社のどれから移行する場合も、ベースURLとキーを変えるだけでは足りません。すべてのリクエストで、ほかにも次の点が変わります：

• キー：Authorization: Bearerで、sk_test_またはsk_live_で始まるキーを使います。
• モデルIDはボディのmodelに入れます。テキスト、開始フレーム、参照画像を1つのIDでまかないます。
• すべての生成リクエストにIdempotency-Keyヘッダーを付けます。
• 価格の上限：max_credits、またはPOST /v1/quotesで取得したquote_id。
• 結果はジョブとして返ります：GET /v1/jobs/{id}をポーリングするか、当サービスの署名付きWebhookを受信します。

fal

当サービスに最も近い形です：Seedanceのフィールド名の多くはfalのものです。ほかに、image_urlsをreference_image_urlsに名前を変え、durationは数値で送り、fal_webhookはボディのwebhook_urlに移します。

Replicate

フィールドをinputから出してください。ほかに、imageをimage_urlに、reference_imagesをreference_image_urlsに、webhookをwebhook_urlに名前を変えます。

WaveSpeed

ほかに、imageをimage_urlに、reference_imagesをreference_image_urlsに名前を変え、standard_webhookはボディのwebhook_urlに移します。結果はGET /v1/jobs/{id}から読み取ります。

認証

リクエストの送信先と認証の方法。

開発者APIは申請制です。スタジオの「APIキー」から申請してください。キーは1回だけ表示されます。開発者APIキーは開発者API残高を消費し、同じキーをBearerヘッダーとしてMCPサーバーでも使えます。

モデルID

各社のIDはURLに入り、当サービスのIDはボディのmodelに入ります。当サービスの1つのIDで、テキスト、開始フレーム、参照画像をまかなえます：どれになるかは送るフィールドで決まります。

AIエージェント向け

AIエージェント向けのテキスト：入力、指定できる値、設定ごとの価格、リクエスト例seedance-2.0-fastseedance-2.0-miniqwen-image-2512-lightningqwen-image-2512qwen-image-edit-2511-lightningqwen-image-edit-2511

Seedance 2.0をフィールドごとに

falにあるフィールドは、当サービスもfalの名前に合わせています。異なる点は備考に記載しています。フィールドはJSONボディの最上位に置きます。Replicateではinputで包みます。

当サービスに対応するものがない、各社のSeedanceフィールド。そのまま送ると、不明なフィールドとして拒否されます（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をフィールドごとに

当サービスの画像のボディは各社より小さくなっています：自由なピクセル数ではなくサイズとアスペクト比、1ジョブにつき1枚、サンプラーの設定はありません。

当サービスに対応するものがない、各社のQwen-Imageフィールド。そのまま送ると、不明なフィールドとして拒否されます（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

非同期ジョブとWebhook

4つのサービスはいずれも、ジョブをバックグラウンドで実行します。各サービスでのステップの呼び方：

当サービスのWebhookのボディはジョブそのもので、署名も当サービス独自のものです：各社のWebhookを検証するコードでは、当サービスのWebhookは拒否されます。 当サービスのWebhookの検証方法

べき等性

すべての生成リクエストにIdempotency-Keyヘッダー（表示可能なASCII文字で1〜255文字）が必要です。24時間以内に同じキーを送るとHTTP 200で同じジョブが返されるため、タイムアウト後に再試行しても、2つ目のジョブが作成されたり課金されたりすることはありません。

2026-10-22時点で、3社ともジョブ作成用のべき等キーをドキュメントに記載していません：falはrequest_idでWebhookの重複を排除するよう勧めており、WaveSpeedは1回だけ送信し、再送信の前にタスクを探すよう求めています。ジョブごとに1つのキーを決め、再試行のたびに同じキーを使ってください。

互換性のない点

次のものは、そのまま送ると失敗するか拒否されます：

• 各社のクライアントライブラリ（fal_client、replicate、wavespeed）は/v1を呼び出しません。通常のHTTP、OpenAPIドキュメント、またはMCPサーバーを使ってください。
• 各社のレスポンスの形：当サービスのジョブはoutputs[].urlを持つJobで、falのresult、Replicateのprediction、WaveSpeedのdataラッパーではありません。
• 終了フレーム：falのend_image_url、Replicateのlast_frame_image、WaveSpeedのlast_image。
• 参照動画と参照音声：falのvideo_urlsとaudio_urls、ReplicateとWaveSpeedのreference_videosとreference_audios。
• 自動の長さや自動のアスペクト比、4:3、3:4、21:9のアスペクト比、1080pや4Kでのレンダリング。当サービスでは、より高い解像度は別のステップenhanceで行い、AI Enhancedと表示されます。
• 開始フレームと参照画像の併用。Replicateでもこの組み合わせは拒否されます。
• 1回の呼び出しで結果を待つこと（fal.run、ReplicateのPrefer: wait、WaveSpeedのenable_sync_mode）：当サービスのジョブはすべて非同期です。
• 1ジョブで複数の画像、PNGやWebPでの出力、幅と高さの自由な指定、編集での複数の元画像、LoRA、サンプラーの設定。
• 各社のWebhook検証：当サービスの配信にはX-Signatureが付きます。これはwhsec_シークレットによるHMAC-SHA256で、falのED25519署名やwebhook-signatureヘッダーではありません。
• 後払い：クレジットは前払いで、すべてのジョブに上限があり、max_creditsを超えるジョブは拒否され、課金されません。
• 長期間有効な出力リンク：当サービスのリンクは24時間有効です。ジョブを再度取得すると新しいリンクが得られます。

移行前と移行後

開始フレーム付きの同じSeedance 2.0 Fastリクエストを、各プラットフォームのドキュメントどおりに示し、続いて/v1での書き方を示します。価格の上限は当サービスの料金エンジンから算出しています。

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

当サービスの価格

当サービスのジョブはすべて、実行前にクレジットで見積もられ（US$1 = 100クレジット）、見積もりやmax_creditsを超えることはありません。

fal、Replicate、WaveSpeedの料金は各社のページに掲載されています。当サービスの価格比較ページでは、各社が公表しているSeedance 2.0の価格を、それぞれ取得した日付とともに掲載しています。