OpenAPI 接口文档

管理 API Key

使用 REST API 创建图片和视频任务、查询模型能力并读取生成结果。公开接口版本固定为 v1

快速开始

所有 /openapi/v1/* 接口使用 API Key 鉴权。请在请求头中发送 Bearer Token,不要从浏览器前端直接调用。

Base URL
https://open-api.flux-art.ai
Authorization
Bearer fa_live_...
幂等要求:图片和视频生成必须携带 8–128 位 Idempotency-Key,可使用字母、数字、点、下划线、冒号和连字符。超时或 5xx 重试时复用原键。
curl -X POST 'https://open-api.flux-art.ai/openapi/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: image-order-20260714-0001' \
  -d '{
    "model": "gemini-2.5-flash-image",
    "mode": "generate",
    "prompt": "一张柔和日光下的产品照片",
    "count": 1
  }'
创建成功:返回 201 Createddata.statusqueued,表示任务已经成功创建并进入队列,不是错误。保存 data.id,随后按 Location 或任务查询接口轮询结果。

模型列表

模型和参数能力会持续变化。客户端应先读取模型列表,不要写死完整模型集合。

GET/openapi/v1/models

返回图片、视频模型以及每个模型支持的尺寸、比例、时长和分辨率等能力。

curl 'https://open-api.flux-art.ai/openapi/v1/models' \
  -H 'Authorization: Bearer YOUR_API_KEY'

图片生成

一次请求创建一个图片任务,公开接口固定 count=1

POST/openapi/v1/images/generations

常用请求字段

model
必填,图片模型 ID。
mode
必填:文生图使用 generate;提交 image_urls 进行编辑或参考图生成时使用 edit。
prompt
必填,至少 3 个非空白字符。
count
固定为 1。
image_urls
编辑或参考图模式必填,必须为模型可访问的公网 HTTPS URL。
aspect_ratio
可选,图片宽高比。
size / resolution
可选,设置图片尺寸或分辨率。支持模型:size 用于 GPT Image 2、Nano Banana、Seedream、Qwen Image 2.0、Wan Image、Kling Image;resolution 用于 Grok Imagine、Grok Imagine Pro。
curl -X POST 'https://open-api.flux-art.ai/openapi/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: image-edit-20260714-0001' \
  -d '{
    "model": "gemini-2.5-flash-image",
    "mode": "edit",
    "prompt": "保留主体,替换为摄影棚背景",
    "count": 1,
    "image_urls": ["https://cdn.example.com/input.jpg"],
    "aspect_ratio": "16:9"
  }'

视频生成

支持文字生成视频、图片生成视频,以及部分模型的视频编辑能力。

POST/openapi/v1/videos/generations

常用请求字段

model
必填,视频模型 ID。
video_mode
必填,例如 t2v、i2v_first、multimodal_ref 或 v2v_edit;必须命中模型支持的模式。
prompt
必填,至少 3 个非空白字符。
image_urls
可选,首帧、尾帧或参考图。
source_video_url
可选,视频编辑或扩展的源视频。
duration
可选,必须命中模型支持的时长。
resolution
可选,例如 720p
ratio / aspect_ratio
可选,设置视频画面比例。支持模型:ratio 用于 Seedance、HappyHorse;aspect_ratio 用于 Grok Video、Kling Video、HappyHorse。
curl -X POST 'https://open-api.flux-art.ai/openapi/v1/videos/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: video-order-20260714-0001' \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "video_mode": "t2v",
    "prompt": "城市夜景中的缓慢推进镜头",
    "duration": 10,
    "resolution": "720p",
    "ratio": "16:9"
  }'

任务查询

创建新任务返回 201 Created;幂等重放返回原任务和 200 OK。响应头包含 LocationIdempotent-Replayed

  • queued排队中
  • processing生成中
  • succeeded已完成
  • failed失败
  • canceled已取消
GET/openapi/v1/tasks/{task_id}

查询当前账户的一个 OpenAPI 任务。成功后从 output 读取图片或视频地址。

curl 'https://open-api.flux-art.ai/openapi/v1/tasks/TASK_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'
GET/openapi/v1/tasks

使用游标分页查询任务列表,任务读取接口的账户级限流为每分钟 120 次。

limit
每页数量。
cursor
上一页返回的分页游标。
type
imagevideo
status
queuedprocessingsucceededfailedcanceled

错误处理

所有公开接口错误统一包含 error.codemessagerequest_id。联系支持时提供 request id 和 task id,不要提供完整 API Key。

  • 400
    invalid_request / invalid_media_url

    修正参数或素材地址,不要原样重试。

  • 401
    invalid_api_key

    检查密钥是否缺失、已重新生成或已撤销。

  • 402
    insufficient_points / membership_required

    充值点数或升级所需会员。

  • 404
    task_not_found

    核对任务 ID 和所属账户。

  • 409
    idempotency_key_reused

    不同请求更换幂等键;处理中则稍后重试。

  • 422
    validation_error

    根据 details 修正请求字段。

  • 429
    rate_limit / concurrent_limit

    遵循 Retry-After 或等待已有任务完成。

  • 5xx
    internal_error / service_unavailable

    退避重试,并继续使用原幂等键。

模型价格

OpenAPI 与网页端共用当前 Flux Art 账户的算力余额、会员权益和活动折扣。任务创建成功后从同一账户扣除算力;余额不足时返回 402,且不会创建任务。

图片模型

图片任务按张计费;尺寸和质量会影响部分模型的消耗。

GPT Image 2

gpt-image-2
当前计费比例 50%
算力消耗明细
配置算力消耗
low · 1K原价40折扣价20算力 / 张
low · 2K原价80折扣价40算力 / 张
low · 4K原价120折扣价60算力 / 张
medium · 1K原价80折扣价40算力 / 张
medium · 2K原价120折扣价60算力 / 张
medium · 4K原价160折扣价80算力 / 张
high · 1K原价180折扣价90算力 / 张
high · 2K原价360折扣价180算力 / 张
high · 4K原价600折扣价300算力 / 张

Nano Banana 2 Lite

gemini-3.1-flash-lite-image
当前计费比例 50%
算力消耗明细
配置算力消耗
每张图片原价100折扣价50算力 / 张

Nano Banana 2

gemini-3.1-flash-image-preview
当前计费比例 50%
算力消耗明细
配置算力消耗
512原价80折扣价40算力 / 张
1K原价160折扣价80算力 / 张
2K原价200折扣价100算力 / 张
4K原价320折扣价160算力 / 张

Nano Banana

gemini-2.5-flash-image
当前计费比例 50%
算力消耗明细
配置算力消耗
每张图片原价70折扣价35算力 / 张

Nano Banana Pro

gemini-3-pro-image-preview
当前计费比例 50%
算力消耗明细
配置算力消耗
1K原价240折扣价120算力 / 张
2K原价320折扣价160算力 / 张
4K原价400折扣价200算力 / 张

Grok Imagine Image

grok-imagine-image
算力消耗明细
配置算力消耗
每张图片100算力 / 张

Grok Imagine Image Pro

grok-imagine-image-pro
算力消耗明细
配置算力消耗
每张图片250算力 / 张

Seedream 5.0 Pro

doubao-seedream-5-0-pro-260628
算力消耗明细
配置算力消耗
1K120算力 / 张
2K240算力 / 张

Seedream 5.0

doubao-seedream-5-0-260128
算力消耗明细
配置算力消耗
每张图片60算力 / 张

Seedream 4.5

doubao-seedream-4-5-251128
算力消耗明细
配置算力消耗
每张图片60算力 / 张

Wan 2.7 Pro

wan2.7-image-pro
算力消耗明细
配置算力消耗
每张图片250算力 / 张

Wan 2.7

wan2.7-image
算力消耗明细
配置算力消耗
每张图片200算力 / 张

Qwen Image 2.0 Pro

qwen-image-2.0-pro
算力消耗明细
配置算力消耗
每张图片150算力 / 张

Qwen Image 2.0

qwen-image-2.0
算力消耗明细
配置算力消耗
每张图片120算力 / 张

Qwen Image Max

qwen-image-max
算力消耗明细
配置算力消耗
每张图片120算力 / 张

Qwen Image Edit Max

qwen-image-edit-max
算力消耗明细
配置算力消耗
每张图片160算力 / 张

Qwen MT Image

qwen-mt-image
算力消耗明细
配置算力消耗
每张图片150算力 / 张

Z-Image Turbo

z-image-turbo
算力消耗明细
配置算力消耗
每张图片80算力 / 张

Wan 2.6 T2I

wan2.6-t2i
算力消耗明细
配置算力消耗
每张图片150算力 / 张

Wan 2.6 Image

wan2.6-image
算力消耗明细
配置算力消耗
每张图片150算力 / 张

Wan 2.5 T2I

wan2.5-t2i-preview
算力消耗明细
配置算力消耗
每张图片150算力 / 张

Wan 2.5 I2I

wan2.5-i2i-preview
算力消耗明细
配置算力消耗
每张图片120算力 / 张

Wan 2.2 Flash

wan2.2-t2i-flash
算力消耗明细
配置算力消耗
每张图片100算力 / 张

Wan 2.2 Plus

wan2.2-t2i-plus
算力消耗明细
配置算力消耗
每张图片100算力 / 张

Midjourney V7 Imagine

mj_imagine
算力消耗明细
配置算力消耗
每张图片60算力 / 张

Midjourney V7 Blend

mj_blend
算力消耗明细
配置算力消耗
每张图片60算力 / 张

Kling Image O1

kling-image-o1
算力消耗明细
配置算力消耗
1K90算力 / 张
2K90算力 / 张
1K90算力 / 张
2K90算力 / 张

Kling V3 Omni Image

kling-v3-omni-image
算力消耗明细
配置算力消耗
1K90算力 / 张
2K90算力 / 张
4K170算力 / 张
1K90算力 / 张
2K90算力 / 张
4K170算力 / 张

Kling V3 Image

kling-v3-image
算力消耗明细
配置算力消耗
1K90算力 / 张
2K90算力 / 张
1K90算力 / 张
2K90算力 / 张

Kling V2.1 Image

kling-v2-1-image
算力消耗明细
配置算力消耗
1K50算力 / 张
2K50算力 / 张
1K90算力 / 张
2K90算力 / 张
1K170算力 / 张
2K170算力 / 张

Kling V2 New Image

kling-v2-new-image
算力消耗明细
配置算力消耗
1K90算力 / 张

Kling V2 Image

kling-v2-image
算力消耗明细
配置算力消耗
1K50算力 / 张
2K50算力 / 张
1K90算力 / 张
2K90算力 / 张
1K170算力 / 张
2K170算力 / 张

Kling V1.5 Image

kling-v1-5-image
算力消耗明细
配置算力消耗
1K50算力 / 张
1K90算力 / 张

Kling V1 Image

kling-v1-image
算力消耗明细
配置算力消耗
1K20算力 / 张
1K20算力 / 张

视频模型

视频任务按生成秒数计费。下表严格按模型配置和正式计费函数,展示各模型默认 5 秒任务的实际算力消耗;分辨率、音频和视频输入方式会影响最终消耗。

Grok Video

grok-video-3
算力消耗明细
配置算力消耗
基础生成 · 480p · 5 秒500算力 / 次
基础生成 · 720p · 5 秒750算力 / 次

HappyHorse 1.0

happyhorse-1.0
算力消耗明细
配置算力消耗
基础生成 · 720P · 5 秒1,450算力 / 次
基础生成 · 1080P · 5 秒2,250算力 / 次

HappyHorse 1.1

happyhorse-1.1
算力消耗明细
配置算力消耗
基础生成 · 720P · 5 秒1,750算力 / 次
基础生成 · 1080P · 5 秒2,500算力 / 次

Seedance 2.0

doubao-seedance-2-0-260128
算力消耗明细
配置算力消耗
基础生成 · 480p · 5 秒700算力 / 次
基础生成 · 720p · 5 秒1,500算力 / 次
基础生成 · 1080p · 5 秒3,750算力 / 次
基础生成 · 4k · 5 秒7,500算力 / 次
含单个视频输入 · 480p · 5 秒800算力 / 次
含单个视频输入 · 720p · 5 秒1,650算力 / 次
含单个视频输入 · 1080p · 5 秒4,050算力 / 次
含单个视频输入 · 4k · 5 秒8,100算力 / 次
含多个视频输入 · 480p · 5 秒1,700算力 / 次
含多个视频输入 · 720p · 5 秒3,600算力 / 次
含多个视频输入 · 1080p · 5 秒9,000算力 / 次
含多个视频输入 · 4k · 5 秒18,000算力 / 次

单次视频任务的总消耗向上取整至 50 算力

Seedance 2.0 Mini

doubao-seedance-2-0-mini-260615
算力消耗明细
配置算力消耗
基础生成 · 480p · 5 秒550算力 / 次
基础生成 · 720p · 5 秒1,100算力 / 次
含单个视频输入 · 480p · 5 秒3,000算力 / 次
含单个视频输入 · 720p · 5 秒6,000算力 / 次
含多个视频输入 · 480p · 5 秒6,600算力 / 次
含多个视频输入 · 720p · 5 秒13,200算力 / 次

单次视频任务的总消耗向上取整至 50 算力

Seedance 2.0 Fast

doubao-seedance-2-0-fast-260128
算力消耗明细
配置算力消耗
基础生成 · 480p · 5 秒550算力 / 次
基础生成 · 720p · 5 秒1,200算力 / 次
含单个视频输入 · 480p · 5 秒600算力 / 次
含单个视频输入 · 720p · 5 秒1,300算力 / 次
含多个视频输入 · 480p · 5 秒1,350算力 / 次
含多个视频输入 · 720p · 5 秒2,850算力 / 次

单次视频任务的总消耗向上取整至 50 算力

Seedance 1.5 Pro

doubao-seedance-1-5-pro-251215
算力消耗明细
配置算力消耗
基础生成 · 480p · 5 秒150算力 / 次
基础生成 · 720p · 5 秒300算力 / 次
基础生成 · 1080p · 5 秒600算力 / 次
生成音频 · 480p · 5 秒250算力 / 次
生成音频 · 720p · 5 秒550算力 / 次
生成音频 · 1080p · 5 秒1,200算力 / 次

单次视频任务的总消耗向上取整至 50 算力

Seedance 1.0 Pro

doubao-seedance-1-0-pro-250528
算力消耗明细
配置算力消耗
基础生成 · 480p · 5 秒250算力 / 次
基础生成 · 720p · 5 秒500算力 / 次
基础生成 · 1080p · 5 秒1,100算力 / 次

单次视频任务的总消耗向上取整至 50 算力

Seedance 1.0 Pro Fast

doubao-seedance-1-0-pro-fast-251015
算力消耗明细
配置算力消耗
基础生成 · 480p · 5 秒100算力 / 次
基础生成 · 720p · 5 秒150算力 / 次
基础生成 · 1080p · 5 秒350算力 / 次

单次视频任务的总消耗向上取整至 50 算力

Kling V3 Omni

kling-v3-omni
算力消耗明细
配置算力消耗
基础生成 · undefined · 3 秒750算力 / 次
基础生成 · undefined · 3 秒1,020算力 / 次
基础生成 · undefined · 3 秒3,750算力 / 次
生成音频 · undefined · 3 秒1,020算力 / 次
生成音频 · undefined · 3 秒1,260算力 / 次
生成音频 · undefined · 3 秒3,750算力 / 次
含单个视频输入 · undefined · 3 秒1,140算力 / 次
含单个视频输入 · undefined · 3 秒1,500算力 / 次
含单个视频输入 · undefined · 3 秒3,750算力 / 次

Kling Video O1

kling-video-o1
算力消耗明细
配置算力消耗
基础生成 · undefined · 5 秒1,250算力 / 次
基础生成 · undefined · 5 秒1,700算力 / 次
含单个视频输入 · undefined · 5 秒1,900算力 / 次
含单个视频输入 · undefined · 5 秒2,500算力 / 次

Kling V3

kling-v3
算力消耗明细
配置算力消耗
基础生成 · undefined · 3 秒750算力 / 次
基础生成 · undefined · 3 秒1,020算力 / 次
基础生成 · undefined · 3 秒3,750算力 / 次
生成音频 · undefined · 3 秒1,140算力 / 次
生成音频 · undefined · 3 秒1,500算力 / 次
生成音频 · undefined · 3 秒3,750算力 / 次

Kling V2.6

kling-v2-6
算力消耗明细
配置算力消耗
基础生成 · undefined · 5 秒650算力 / 次
基础生成 · undefined · 5 秒1,050算力 / 次
生成音频 · undefined · 5 秒2,100算力 / 次

Kling V2.5 Turbo

kling-v2-5-turbo
算力消耗明细
配置算力消耗
基础生成 · undefined · 5 秒650算力 / 次
基础生成 · undefined · 5 秒1,050算力 / 次

Kling V2.1 Master

kling-v2-1-master
算力消耗明细
配置算力消耗
基础生成 · undefined · 5 秒4,200算力 / 次

Kling V2.1

kling-v2-1
算力消耗明细
配置算力消耗
基础生成 · undefined · 5 秒850算力 / 次
基础生成 · undefined · 5 秒1,500算力 / 次

Kling V2 Master

kling-v2-master
算力消耗明细
配置算力消耗
基础生成 · undefined · 5 秒4,200算力 / 次

Kling V1.6

kling-v1-6
算力消耗明细
配置算力消耗
基础生成 · undefined · 5 秒850算力 / 次
基础生成 · undefined · 5 秒1,500算力 / 次

Kling V1.5

kling-v1-5
算力消耗明细
配置算力消耗
基础生成 · undefined · 5 秒850算力 / 次
基础生成 · undefined · 5 秒1,500算力 / 次

Kling V1

kling-v1
算力消耗明细
配置算力消耗
基础生成 · undefined · 5 秒450算力 / 次
基础生成 · undefined · 5 秒1,500算力 / 次