FLUX.1 Schnell API

POST /v1/tasks

所有模型都通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称	flux-schnell/text-to-image
类型	图像生成（文生图）
接口	POST /v1/tasks
价格	见 HiAPI 定价

FLUX.1 Schnell 是 Black Forest Labs 开源的 12B 极速文生图模型：1-4 步推理秒级出图，位于 HiAPI 全平台最低价档，Apache 2.0 许可可直接商用，专为大批量生成与快速迭代场景打造。

生产建议

生产环境建议

生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

大批量素材生成

1-4 步推理配合全平台最低价档，把单张成本和延迟都压到最低，适合电商素材、内容库填充等一次生成成百上千张的任务。

num_inference_steps

快速迭代与草图预览

秒级返回让"改词—出图—再改"的循环几乎无等待：先用 schnell 探索构图与风格，选定方向后再交给更高质量的模型精修出成品。

promptseed

低延迟高吞吐服务

少步数蒸馏架构天然适合实时预览、应用内配图等在线场景，同等预算下可支撑更高的每秒请求量。

成本敏感的商用项目

Apache 2.0 许可覆盖个人、科研与商业用途，配合最低价档计费，适合预算有限但需要合规商用的产品原型与初创项目。

请求参数

POST https://api.hiapi.ai/v1/tasks

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
# 把 YOUR_API_KEY 换成你的账号 API Key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-schnell/text-to-image",
  "input": {
    "prompt": "cyberpunk night market street, glowing neon signs, rain reflections, moody cinematic atmosphere",
    "aspect_ratio": "16:9",
    "num_inference_steps": 4
  }
}'

import requests, json

# 业务参数对象，字段随模型而定（见对应模型页）
payload = json.loads(r'''
{
  "model": "flux-schnell/text-to-image",
  "input": {
    "prompt": "cyberpunk night market street, glowing neon signs, rain reflections, moody cinematic atmosphere",
    "aspect_ratio": "16:9",
    "num_inference_steps": 4
  }
}
''')

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # 成功返回 { code, message, data: { taskId } }

// 提交异步任务，成功立即返回 taskId（不等待生成完成）
// 把 YOUR_API_KEY 换成你的账号 API Key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "flux-schnell/text-to-image",
  "input": {
    "prompt": "cyberpunk night market street, glowing neon signs, rain reflections, moody cinematic atmosphere",
    "aspect_ratio": "16:9",
    "num_inference_steps": 4
  }
}),
});
console.log(await resp.json()); // 成功返回 { code, message, data: { taskId } }

model string 必填

固定填 flux-schnell/text-to-image。

示例 flux-schnell/text-to-image

input object 必填

业务参数对象；FLUX.1 Schnell 的模型专属配置都放在这里。

prompt string 必填

图像生成提示词。上游 T5 编码器约 256 token 上限，过长提示词会被截断，建议精炼表达。

aspect_ratio enum 可选

输出画幅比例，覆盖方图 / 横图 / 竖图五档预设。

默认 4:3 可选值: 1:14:33:416:99:16

num_inference_steps integer 可选

去噪步数（1-12）。官方推荐 1-4 步（默认 4），更高步数收益有限。

默认 4

guidance_scale number 可选

schnell 为 timestep-distilled 蒸馏模型，官方参考实现不使用 guidance；此参数为上游兼容参数，通常保持默认即可。

默认 3.5

output_format enum 可选

输出图片格式。

默认 jpeg 可选值: jpegpng

seed integer 可选

随机种子；固定后可复现同一生成结果。

enable_safety_checker boolean 可选

是否开启内容安全检查，默认开启。

默认 true

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback

when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

1 步极速草图预览

构图探索阶段把步数降到 1，用最快速度、最低成本刷草图；选定方向后再提高步数或换更高质量模型出成品。

请求体

{
  "model": "flux-schnell/text-to-image",
  "input": {
    "prompt": "serene Japanese garden with cherry blossoms, koi pond, wooden bridge, soft morning light, highly detailed",
    "aspect_ratio": "4:3",
    "num_inference_steps": 1
  }
}

固定 seed 复现与对比

迭代提示词措辞时固定 seed，每次改动都能和稳定基线对比；批量流水线里也便于复现单张结果。

请求体

{
  "model": "flux-schnell/text-to-image",
  "input": {
    "prompt": "a majestic red fox on a misty cliff at golden hour, cinematic lighting, photorealistic, depth of field",
    "aspect_ratio": "3:4",
    "num_inference_steps": 4,
    "seed": 42
  }
}

获取结果

提交成功后立即返回 taskId（不等待生成完成）。
生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
status=success 后，从返回的 output[].url 下载生成的图片。
如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

FLUX.1 Schnell 怎么计费？

按图计费，schnell 位于 HiAPI 全平台最低价档，画幅比例不影响单价。实时价格以定价页为准。查看实时价格

为什么调 guidance_scale 感觉没有效果？

schnell 是 timestep-distilled（时间步蒸馏）模型，官方参考实现不使用 guidance（diffusers 中要求该值为 0）。接口里的 guidance_scale 是上游兼容参数，通常保持默认即可；想让结果更贴合预期，优先精炼提示词。

推理步数应该设多少？

官方推荐 1-4 步（默认 4），模型本身就是为少步数采样蒸馏的。HiAPI 最高放宽到 12 步，但更高步数收益有限；草图预览阶段可以直接降到 1-2 步换取更快返回。

生成的图片可以商用吗？

FLUX.1 Schnell 权重以 Apache 2.0 许可发布，允许个人、科研与商业用途，生成结果可用于商业项目。内容本身仍需符合相关法律与平台使用政策。