FLUX 3

为静态图片赋予 20 秒动作与声音，并用关键帧精准控制。

black-forest-labs/flux-3-video/image-to-video

能力

最适合

•电影感文生视频镜头
•社交媒体短片与广告
•连贯的多镜头片段
•视觉开发与风格探索

不适合

•逐帧精确转描
•长篇视频渲染
•像素级精确合成
•准确呈现画面文字

身份验证

API 密钥标头

Uika API 使用 API 密钥来验证请求。将您的密钥发送到 X-API 密钥标题。API 密钥必须保密，不要暴露在浏览器或其他客户端代码中。请从服务端调用 API。登录后的试玩使用控制台会话，不会发送你的 API 密钥。

标题

X-API-Key: YOUR_API_KEY

端点

异步·轮询结果

发布https://api.dev.pika.art/v1/media/black-forest-labs/flux-3-video/image-to-video生成端点

获取https://api.dev.pika.art/v1/media/jobs/{request_id}民意调查直至完成

获取https://api.dev.pika.art/v1/media/jobs/{request_id}/content输出 URL，适用于仅保留 id 的客户端

删除https://api.dev.pika.art/v1/media/jobs/{request_id}删除存储的媒体并提示

REST 接入

标准 HTTPS

视频通过上方 REST 接口生成。API 使用 HTTPS 传输标准 JSON，可搭配任意 HTTP 客户端，无需厂商专用 SDK。

生成

POST /v1/media/black-forest-labs/flux-3-video/image-to-video

请求

curl -X POST https://api.dev.pika.art/v1/media/black-forest-labs/flux-3-video/image-to-video \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "soft wind moving the cherry that is on the surface. camera dolly in and then push out and orbit around the cherries.",
  "resolution": "1080p",
  "duration": 10,
  "aspect_ratio": "auto",
  "draft": false,
  "generate_audio": true,
  "keyframes": [
    {
      "image_url": "https://cdn.pika.art/v2/media/uploads/a7112d4d-62ed-4a11-8dee-74e89c2ec037/20fe9e3799d942d5bbc1f50766994305.png"
    }
  ]
}'

返回数据

{
  "id": "media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0",
  "status": "queued"
}

请求正文

提示词字符串需要

描述你想生成的视频。

分辨率枚举

输出分辨率。

持续时间枚举默认：自动

视频长度以整秒 (5-20) 为单位，或“自动”让模型选择。

aspect_ratioenum

输出画面比例。

草稿布尔值默认： false

生成更便宜的 720p 草稿预览，而不是全质量渲染。

generate_audio布尔值默认： true

是否生成同步音频。

object[]1 – 10需要

关键帧图像：一个开始帧、要插入的多个帧或带时间戳的帧（在每个条目上设置 at_s）。

接受的值

分辨率
aspect_ratio

返回一个工作对象状态，不是最终输出。存储响应中的 ID 并轮询作业直至完成。

民意调查状态

获取/v1/media/jobs/{request_id}

请求

curl https://api.dev.pika.art/v1/media/jobs/{request_id} \
  -H "X-API-Key: YOUR_API_KEY"

返回数据

{
  "id": "media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0",
  "status": "running"
}

按 ID 轮询作业，直到达到最终状态：已完成或失败。已完成的作业在输出中携带其下载 URL，并且 GET /v1/media/jobs/{request_id}/content 返回与 { "url" } 对于只保留 ID 的客户端。

DELETE /v1/media/jobs/{request_id} 删除作业的存储介质以及提交时捕获的请求（提示和参数）。然后作业报告 deleted_at 并且没有输出，内容端点回答410。

作业对象

id字符串

作业的唯一标识符。

状态枚举

作业的状态。其中之一：

对象

生成输出。工作完成后立即出现。

错误字符串

如果作业失败，则失败的原因。

deleted_atnumber

当您删除作业的存储媒体时，以纪元秒为单位。在此之前为空，一旦设置后输出为空。

用法对象

提供者为作业报告的单位，例如 video_output_tokens 或 image_output_tokens。一旦作业终止就存在，仅携带作业报告的单位，并且当没有报告任何内容时为空。

对象

工作收费。工作结束后在场；提交响应和 webhooks 上为 null。

错误

在通话中共享

错误使用传统的 HTTP 状态代码以及形状的 JSON 主体 {"message": "..."}. 参数校验失败时返回 422 并带有一条命名有问题字段的消息。作业行存在后提交拒绝（余额、速率限制）返回失败的作业信封 — 分支 error.code.

状态	当	身体
401 未经授权	API 密钥丢失或无效。	{"message":"Invalid API key"}
403 禁止	非活动密钥被拒绝 {"message"} 身体。作业行存在并返回失败的作业信封后，组织余额或后付费周期限制无法覆盖的提交将被拒绝。 GET /billing/balance 将两者分开： 200 表示密钥处于活动状态，因此拒绝的是余额或循环限制。	{"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"insufficient_balance","message":"Insufficient org balance"}}
404 未找到	您的组织中不存在具有该 ID 的作业，或者媒体路径名称未知的供应商/型号/功能。	{"message":"media job not found"}
409冲突	在作业完成之前请求结果，或者将 Idempotency-Key 标头与不同的正文重用。	{"message":"media job is not ready"}
422 无法处理的实体	请求正文验证失败：枚举值无效、缺少必填字段、类型错误或 JSON 格式错误。 JSON 消息命名有问题的字段。无法定价的架构有效参数组合在创建作业后失败，并返回失败的作业信封和错误代码 invalid_input.	{"message":"duration: Input should be less than or equal to 15"}
429 请求太多	您已达到每分钟或每天的请求限制，或者您组织的作业队列已满。作为失败的作业信封返回。如果存在 Retry-After 标头，请等待那么长时间，然后使用新的 Idempotency-Key 重试。	{"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"rate_limited","message":"rate limit exceeded: rpm"}}
503服务不可用	模型导轨或后端依赖项暂时不可用。作为失败的作业信封退回；使用退避和新的幂等密钥重试。	{"id":"media_8f3a2c91-5b7d-4e0a-9c26-31d4f2a8e6b0","status":"failed","error":{"code":"provider_unavailable","message":"media dispatch unavailable"}}

FLUX 3

能力

身份验证

端点

REST 接入

生成

民意调查状态

错误

加入俱乐部