从 fal、Replicate或 WaveSpeed 迁移过来

不只是换个接口地址

三家都一样，只换接口地址和 Key 是不够的。每个请求还要做这些改动：

• Key：Authorization: Bearer，Key 以 sk_test_ 或 sk_live_ 开头。
• 型号 ID 放在请求体的 model 里，文字、首帧和参考图共用一个 ID。
• 每个生成请求都带 Idempotency-Key 请求头。
• 价格上限：max_credits，或 POST /v1/quotes 返回的 quote_id。
• 结果是一个任务：轮询 GET /v1/jobs/{id}，或接收本站带签名的回调。

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 Keys 页面申请。Key 只显示一次。开发者 API Key 花的是开发者 API 余额，同一个 Key 也可以作为 Bearer 请求头用在 MCP 服务上。

型号 ID

三家的 ID 写在 URL 里；本站的写在请求体的 model 里。本站一个 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 逐个字段对照

本站的图片请求体比三家的精简：用尺寸和画幅代替自由设定的像素，一个任务一张图，没有采样器设置。

三家有、本站没有对应项的 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

异步任务和回调

四家都在后台运行任务。各家对每一步的叫法：

本站的回调内容就是任务本身，签名也是本站自己的：校验三家回调的代码会拒绝本站的回调。 怎么校验本站的回调

幂等

每个生成请求都要带 Idempotency-Key 请求头，1 至 255 个可见 ASCII 字符。24 小时内用同一个键，返回同一个任务和 HTTP 200，所以超时后重试不会多建任务，也不会多扣费。

截至 2026-10-22，三家的文档都没有为创建任务提供幂等键：fal 建议按 request_id 给回调去重，WaveSpeed 要求只提交一次，重新提交前先查找任务。每个任务给一个键，每次重试都沿用它。

不兼容的部分

以下内容原样发送，在本站会失败或被拒绝：

• 三家的客户端库（fal_client、replicate、wavespeed）不会调用 /v1。请用普通 HTTP、OpenAPI 文档或 MCP 服务。
• 三家的返回结构：本站的任务是带 outputs[].url 的 Job，不是 fal 的结果、Replicate 的预测，也不是 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 也拒绝这种组合。
• 一次调用等待结果（fal.run、Replicate 的 Prefer: wait、WaveSpeed 的 enable_sync_mode）：本站每个任务都是异步的。
• 一个任务多张图、PNG 或 WebP 输出、自由设定宽高、改图时用多张原图、LoRA 和采样器设置。
• 三家的回调校验方式：本站的投递带 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
  }'

本站自己的价格

本站每个任务执行前先用积分报价（1 美元 = 100 积分），花费不会超过报价或 max_credits。

fal、Replicate 和 WaveSpeed 的收费见它们自己的页面。本站的比价页列出了它们公布的 Seedance 2.0 价格，每个都注明了读取日期。