FLUX 3 API 调用参考

用一个 PopNow API 密钥，就能在自己的代码里调用 FLUX 3。下面列出要填的调用名、这个型号接受的每个输入字段、每次请求花多少积分，以及一段可以直接粘进终端运行的请求。

参数说明直接取自型号的输入 schema，暂时只有英文。

一览

出品方: Black Forest Labs
产出: 视频
起价: 9 积分每秒成片 ($0.09)
调用名: black-forest-labs/flux-3/upscale
black-forest-labs/flux-3/text-to-video
black-forest-labs/flux-3/image-to-video
black-forest-labs/flux-3/video-extend

1 积分 = 0.01 美元。任务受理时先冻结可能的最高费用，完成后按实际用量结算、向上取整到整积分，多冻的退回；失败的任务不扣积分。想在运行前知道确切数字，先调 POST /api/v1/jobs/quote。

视频超清

black-forest-labs/flux-3/upscale

价格

选项	积分 (每秒成片)	美元
`precise`	79.2	$0.792
`creative`	113.76	$1.1376

参数

字段	类型	默认值	取值范围	作用
`video_url`必填	`string (uri)`	—	—	The clip to upscale, an MP4 of up to 20 seconds. Billed by its length, rounded up to whole seconds.
`upscale_mode`可选	`string`	`precise`	precise, creative	precise stays faithful to the source; creative also rebuilds fine detail and costs more.
`upscale_factor`可选	`number`	`2`	1.5 到 3	How many times larger, from 1.5 to 3. The aspect ratio is kept and the factor does not change the price.
`prompt`可选	`string`	—	最多 5000 个字符	Optional, creative mode only: the detail you want added, such as skin texture or fabric weave.

请求示例

这段请求原样就能运行，没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

示例里的 video_url 用的是 PopNow 的示例素材，换成你自己的公开 HTTPS 链接、上传文件或已保存的素材即可。

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-3/upscale",
  "input": {
    "prompt": "Sharpen fine detail and keep the natural look",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "upscale_mode": "precise"
  }
}'

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果，或者在请求里加上 callBackUrl 等通知。

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

生成视频

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

价格

选项	积分 (每秒成片)	美元
`quality = draft, resolution = 1080p`	9	$0.09
`quality = draft, resolution = 720p`	9	$0.09
`quality = standard, resolution = 720p`	25.5	$0.255
`quality = standard, resolution = 1080p`	43.5	$0.435

参数

字段	类型	默认值	取值范围	作用
`prompt`必填	`string`	—	最多 5000 个字符	Describe the subject, action, camera, light and sound for the shot.
`aspect_ratio`可选	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 2:1	Output aspect ratio.
`quality`可选	`string`	`standard`	standard, draft	standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p.
`resolution`可选	`string`	`720p`	720p, 1080p	Output resolution. draft renders at 720p only.
`duration_seconds`可选	`integer`	`5`	5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, … (+2)	Output length in whole seconds, 5 to 20.
`generate_audio`可选	`boolean`	`true`	—	Generate synchronized sound with the video. The price is the same either way.

请求示例

这段请求原样就能运行，没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-3/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "duration_seconds": 5,
    "resolution": "720p",
    "quality": "standard"
  }
}'

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果，或者在请求里加上 callBackUrl 等通知。

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

图生视频

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

价格

选项	积分 (每秒成片)	美元
`quality = draft, resolution = 1080p`	9	$0.09
`quality = draft, resolution = 720p`	9	$0.09
`quality = standard, resolution = 720p`	25.5	$0.255
`quality = standard, resolution = 1080p`	43.5	$0.435

参数

字段	类型	默认值	取值范围	作用
`prompt`必填	`string`	—	最多 5000 个字符	Describe the subject, action, camera, light and sound for the shot.
`image_url`必填	`string (uri)`	—	—	Opening frame. The subject keeps its look from this image.
`last_image_url`可选	`string (uri)`	—	—	Optional closing frame: the clip moves from the opening image to this one.
`aspect_ratio`可选	`string`	—	16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 2:1	Output aspect ratio. Omit it to follow the opening image.
`quality`可选	`string`	`standard`	standard, draft	standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p.
`resolution`可选	`string`	`720p`	720p, 1080p	Output resolution. draft renders at 720p only.
`duration_seconds`可选	`integer`	`5`	5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, … (+2)	Output length in whole seconds, 5 to 20.
`generate_audio`可选	`boolean`	`true`	—	Generate synchronized sound with the video. The price is the same either way.

请求示例

这段请求原样就能运行，没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

示例里的 image_url 用的是 PopNow 的示例素材，换成你自己的公开 HTTPS 链接、上传文件或已保存的素材即可。

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-3/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "720p",
    "quality": "standard"
  }
}'

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果，或者在请求里加上 callBackUrl 等通知。

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

视频续写

black-forest-labs/flux-3/video-extend

价格

选项	积分 (每秒成片)	美元
`quality = draft, resolution = 1080p`	18	$0.18
`quality = draft, resolution = 720p`	18	$0.18
`quality = standard, resolution = 720p`	61.5	$0.615
`quality = standard, resolution = 1080p`	79.5	$0.795

参数

字段	类型	默认值	取值范围	作用
`prompt`必填	`string`	—	最多 5000 个字符	Describe what happens next: the action, camera and sound that continue the clip.
`video_url`必填	`string (uri)`	—	—	The clip to continue, an MP4 of up to 15 seconds. The new segment picks up from its last frame.
`aspect_ratio`可选	`string`	—	16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 2:1	Output aspect ratio. Omit it to keep the shape of the source clip.
`quality`可选	`string`	`standard`	standard, draft	standard renders at the chosen resolution; draft is a fast, lower-cost preview at 720p.
`resolution`可选	`string`	`720p`	720p, 1080p	Output resolution. draft renders at 720p only.
`duration_seconds`可选	`integer`	`5`	5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, … (+2)	Length of the new segment in whole seconds, 5 to 20. The source clip is not included in the result.
`generate_audio`可选	`boolean`	`true`	—	Generate synchronized sound with the video. The price is the same either way.

请求示例

这段请求原样就能运行，没写的字段都用默认值。运行前先把密钥放进环境变量 POPNOW_API_KEY。

示例里的 video_url 用的是 PopNow 的示例素材，换成你自己的公开 HTTPS 链接、上传文件或已保存的素材即可。

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "black-forest-labs/flux-3/video-extend",
  "input": {
    "prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 5,
    "resolution": "720p",
    "quality": "standard"
  }
}'

响应里会立刻带回 taskId。之后用 GET /api/v1/jobs/recordInfo 取结果，或者在请求里加上 callBackUrl 等通知。

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

FLUX 3 API 调用参考

一览

视频超清

价格

参数

请求示例

生成视频

价格

参数

请求示例

图生视频

价格

参数

请求示例

视频续写

价格

参数

请求示例

接下来

本页内容