Fal 队列任务

接口行为

仅支持登记的 Fal 视频路径：Seedance、Kling、Vidu、Veo、MiniMax。创建返回 status_url 和 response_url，客户端相对于网关根地址解析，使用创建时同一 XHub 密钥查询。不能在创建路径后直接拼接 /requests/。

查询队列

GET 前缀 + {request_id} 获取结果，GET 前缀 + {request_id}/status 获取状态。Fast/Mini 共用版本队列。同一路径有多个公开模型别名时，创建正文添加 model 选择，网关转发前删除该字段。

重试与结算

取消未实现，cancel_url 置空。创建网络错误或 5xx 不自动重放，避免重复付费任务；429 按路由策略处理。Webhook 透传不触发结算，需查询成功终态及实测用量。具体创建模式、字段及计价变体以部署端点详情为准，不提供任意 Fal 通配代理。

接口与认证

POST /queue/fal-ai/kling-video/v2.5-turbo/pro/text-to-video

使用 XHub API 密钥：Authorization: Bearer 。不要把供应商密钥当作网关密钥。

Base URL 使用调试台显示的网关根地址，不额外追加 /v1；实际请求使用上面的完整接口路径。

请求参数

请求示例

curl "$XHUB_BASE_URL/queue/fal-ai/kling-video/v2.5-turbo/pro/text-to-video" \
  -H "Authorization: Bearer $XHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A lighthouse at sunrise.","duration":"5"}'

成功响应

{
  "request_id": "request-example"
}

错误与排查

按模型系列接入

• Seedance
• Kling
• Vidu
• Veo 3.1
• MiniMax H3 Max