FLUX.3 Image
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | flux-3-image |
|---|---|
| 类型 | 图片生成与编辑 |
| 接口 | POST /v1/tasks |
| 价格 | 实时价格 |
使用 FLUX.3 Image API 把文字构想与参考素材转成细节丰富的图片，适合商品陈列、空间提案与视觉创作。在线试用生成和编辑，查看不同画幅的作品、实时价格、完整参数与异步接入示例。
请求参数
model string 必填 固定填写 flux-3-image。
input object 必填 图片创作参数。
prompt string 必填 描述画面，或写清参考图中要修改与保留的内容，最多 5000 字符
image_urls string[] 可选 提供 1–10 张公开 HTTP(S) 图片 URL，在提示词中说明各张图片的作用。
resolution enum 可选 选择图片的像素档位，具体宽高随画幅变化
aspect_ratio enum 可选 选择输出图片宽高比；auto 让提示词与参考素材参与构图。固定版位请明确选择比例。
safety_tolerance integer 可选 内容安全宽容度为 0–4，0 最严格
grounding boolean 可选 允许在生成前搜索网页与图片，补充视觉信息
callback object 可选 任务完成或失败时接收通知的配置。
url string 必填 接收任务终态通知的 HTTPS 地址。
when enum 可选 在任务进入终态时通知。
用例示例
陶土模型、黄铜灯具与纸张形成克制的设计桌面，侧光让体块与材质更容易观察。
{
"model": "flux-3-image",
"input": {
"prompt": "A refined still life photograph of a miniature terracotta architectural model on ivory paper, a warm brass desk lamp, a sprig of olive leaves and a charcoal pencil, precise shadows and soft late-afternoon sunlight, restrained design-magazine composition, no text."
}
}获取结果
- 保存提交响应 data.taskId。
- 使用 GET /v1/tasks/{taskId} 查询任务，直到 data.status 为 success 或 failed。
- 成功后读取 data.output 中每张图片的 URL；在 expireAt 前保存需要长期使用的文件。
常见问题
一个入口可以生成和编辑吗？
可以。没有参考图时从文字生成，提供 1–10 张参考图时围绕已有素材编辑。先根据创作目标准备文字或图片即可。
五档分辨率应该怎么选？
先用 768 或 1K 讨论方向；需要更多细节时考虑 1.5K 或 2K，需要较大图片与裁切空间时考虑 4K。档位不是固定边长，请核对返回图片的宽高。
参考图怎样分配作用？
按顺序说明哪张提供主体、哪张提供环境、哪张只提供配色或风格，同时指出不要带入的元素。
每次会生成多少张图片？
每次任务返回一张图片。需要另一个方向时调整描述并提交独立任务。
能选择下载文件的格式吗？
当前入口不提供文件格式选择。按返回文件处理；需要其他格式时，下载后可在图片工具中转换。
搜索辅助应该什么时候开启？
希望在生成前补充网页或图片的视觉上下文时可以开启。已经有明确素材和封闭创作方向时，可以关闭后围绕自己的描述和参考图创作。
怎样保存需要长期使用的图片？
生成的图片链接有有效期。需要长期使用时，请及时下载保存，或在创建任务时选择永久存储。已经生成的图片也可以按存储管理页面的说明转存。
可以在生成后继续修改吗？
可以下载并保存结果，再把它作为新任务的参考图。每次任务独立处理，请重新说明要保留的内容和这一步要改变的部分。
怎样让图片里的标题更容易检查？
用引号写清短标题，说明主标题和副标题的位置、大小关系与留白。使用前逐字核对，必要时在设计工具中完成最终排版。
自动画幅适合什么情况？
不需要固定版位时可以使用自动画幅。已经确定横幅、竖版海报或方形卡片时，明确选择比例，并检查下载图片的实际宽高。
生成前在哪里查看费用？
选择参数后查看 Playground 的预估费用和实时价格。完成后可在任务记录中查看生成结果与对应消费。
为什么同一描述不一定得到同一张图？
生成结果可能在构图和细节上变化。需要沿用一个已经选定的主体或版式时，用结果图片作为参考，并明确列出保留要求。