文生图
提交 prompt、模型、尺寸与宽高比，适合封面、商品图、营销素材、插画和批量内容生产。
POST /images/generationsAI 视频生成 API
一个 API，接入主流生成模型
通过一套服务端 API 调用多种图片与视频生成模型，快速接入产品和自动化流程。
面向了解 HTTP、JSON 和服务端密钥管理的开发者。完整模型与参数以 GET /openapi/v1/models 返回为准。
同一套任务协议，覆盖多种模型
- GPT Image 2
- Nano Banana 2
- Nano Banana Pro
- Seedream 5.0
- Qwen Image 2.0
- Midjourney V7 Imagine
- Seedance 2.0
- Grok Video 3
生成能力
从静态图片到动态视频
不把 provider 的差异直接暴露给业务层。你的产品只需要选择模型、提交参数，再按统一任务状态读取结果。
图生图与编辑
通过公网 HTTPS 参考图完成换背景、风格迁移、局部修改、多图参考或角色一致性工作流。
mode: edit文生视频与图生视频
根据模型能力提交文本、首帧、参考视频或音频，生成横版或竖版视频，并通过任务 ID 获取结果。
POST /videos/generations一次真实请求
GPT Image 2 也走统一任务接口
如果你正在搜索 gpt image2 api 或 GPT-Image-2 API，Flux Art 中对应的模型 ID 是 gpt-image-2。它不是 OpenAI SDK 的无缝替换，但可以和其他站内图片、视频模型共用认证、幂等和任务查询逻辑。
- 认证
Authorization: Bearer fa_live_...- 幂等
- 每个新任务使用新的
Idempotency-Key - 返回
- 先返回任务 ID，完成后再读取图片 URL
curl -X POST \
'https://open-api.flux-art.ai/openapi/v1/images/generations' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Idempotency-Key: 4e4be4c5-4c59-48ef-893b-f9419af9f8e8' \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-image-2",
"mode": "generate",
"prompt": "A clean product photograph of a ceramic lamp",
"size": "1K",
"aspect_ratio": "16:9"
}'
# 201 Created
{
"data": {
"id": d2b22844-...",
"status": queued",
"model": gpt-image-2"
}
}接入流程
三个步骤完成服务端接入
首版采用异步任务和轮询，适合 Web 服务、后台任务、脚本与自动化平台。
创建并保存 API Key
完整密钥只显示一次。把它放进服务端 Secret 管理系统或环境变量，不要写入浏览器代码、Git 仓库和日志。
提交一个生成任务
根据
/openapi/v1/models选择模型与参数，为每个新任务生成唯一幂等键，再调用图片或视频端点。轮询并保存结果
保存任务 ID，按建议间隔查询状态。任务成功后读取图片或视频 URL，并及时转存到自己的存储系统。
账户与任务规则
API 与网页端使用同一套业务规则
OpenAPI 复用 Flux Art 已有的模型校验、动态定价、provider 路由、积分扣除和失败退款逻辑，不维护第二套隐藏规则。
- 会员、积分和价格一致
- API 不提供独立额度，也不能绕过视频会员门槛或免费用户图片日限额。
- 网页任务与 API 任务共享并发
- 网页正在生成的任务会占用 API 并发，反过来也一样；超过并发不会扣费。
- 失败沿用幂等退款
- provider 最终失败时按现有规则退款，可通过
usage.points_refunded核对。 - 查询范围与网页历史隔离
- API Key 只能查询当前账户通过 OpenAPI 创建的任务，不会读取网页端的私人提示词历史。
适用场景
适合需要自动生成内容的产品
如果只是偶尔手动生成，直接使用 Flux Art 网页会更简单；当生成能力需要进入业务流程时，再使用 API。
内容生产工具
让用户在你的产品中生成封面、插图、商品图、广告素材或短视频，并由你控制交互和业务流程。
批量工作流
把生成任务接入 CMS、商品库、社交媒体排期或内部运营脚本，减少重复的网页操作。
系统集成
在网站、App 后端、机器人或自动化平台中使用统一模型目录、任务状态和错误处理方式。
常见问题
Flux Art API 常见问题
了解支持的模型、适用场景、账户计费、密钥安全和第一次接入。
Flux Art API 是 Flux Art 面向产品和自动化工作流提供的模型调用服务。你可以通过一个 API Key 调用多种 AI 图片与视频模型，不需要分别维护多套账号和接入方式。
它适合需要把 AI 图片或视频能力接入网站、应用、内部工具和内容工作流的团队。常见场景包括电商产品图、营销素材、批量内容生成、视频创作和自动化处理。
可以。Flux Art API 已接入 GPT Image 2、Nano Banana、Grok、Seedance 等图片与视频模型。具体可用模型和参数以接口文档及实时模型列表为准。
不需要。Flux Art 负责统一接入已经支持的模型，你只需要管理自己的 Flux Art 账户和 API Key。
可以。同一个有效的 API Key 可以调用账户当前有权限使用的图片和视频模型，不需要为每个模型分别创建密钥。
两者共享同一个账户体系、算力余额和模型能力。网页版适合直接创作，API 更适合接入产品、批量生成内容和建立自动化工作流。
目前 API Key 面向付费会员开放。免费用户点击创建时会看到升级方案，升级后即可在同一账户中创建和管理 API Key。
API 与网页版共享账户算力、会员权益和活动折扣。不同模型和生成设置的消耗可能不同，实际扣费以任务响应中的 usage 为准；符合退款规则的最终失败任务会返还相应算力。
生成时间取决于模型、任务类型、输出规格和当前队列。提交成功后会立即返回任务 ID，你可以继续处理其他工作，并通过任务 ID 查询生成进度和结果。
可以，支持参考图的模型能够接收可公开访问的 HTTPS 图片地址。模型对图片数量、格式和尺寸的要求可能不同，建议在调用前查看对应模型说明。
API Key 应只保存在服务端环境变量或专用 Secret 管理系统中。不要把密钥写入浏览器代码、公开仓库、App 安装包、普通日志或聊天记录。
通常不需要。Flux Art API 使用统一的认证和任务流程，更换模型时主要调整模型标识和对应参数。不同模型支持的尺寸、参考图和生成选项可能有所区别。
生成内容可用于电商、广告、社交媒体和产品设计等商业场景，但仍需遵守 Flux Art 服务条款、模型适用规则以及商标、肖像和版权等第三方权利要求。
登录 Flux Art 并开通相应会员后，进入 API Key 管理页创建密钥，然后打开接口文档。建议先查询实时模型列表，再提交一个图片任务，最后使用返回的任务 ID 查询结果。
先确认模型能力，再开始接入
创建 API Key 后，先调用模型列表接口做参数校验，然后用一个真实任务跑通提交、轮询、结果保存和失败重试。