FIBO Gen 1.5 Text to Image API

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

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

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

FIBO Gen 1.5：写一句描述就能生成写实图片，材质和光影细腻，画面里的文字也能准确呈现，支持 9 种比例。

生产建议

生产环境建议

生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
产物 URL 有有效期，拿到结果后请及时转存到自己的存储。

适用场景

产品与包装

瓶身、标签、包装上的文字和材质都写实清晰。

promptaspect_ratio

人像与生活方式

自然光人像和生活场景，肤色质感真实。

prompt

可复现的迭代

固定 seed 对比不同提示词的效果。

seed

请求参数

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": "fibo-gen-1.5/text-to-image",
  "input": {
    "prompt": "Luxury product photo of an amber glass perfume bottle on wet black marble, gold cap, soft rim light, droplets on the glass, the label reads '\''NOIR 07'\'' in elegant serif letters",
    "aspect_ratio": "4:5",
    "seed": 2026
  }
}'

import requests, json

# 业务参数对象，字段随模型而定（见对应模型页）
payload = json.loads(r'''
{
  "model": "fibo-gen-1.5/text-to-image",
  "input": {
    "prompt": "Luxury product photo of an amber glass perfume bottle on wet black marble, gold cap, soft rim light, droplets on the glass, the label reads 'NOIR 07' in elegant serif letters",
    "aspect_ratio": "4:5",
    "seed": 2026
  }
}
''')

# 提交异步任务，成功立即返回 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": "fibo-gen-1.5/text-to-image",
  "input": {
    "prompt": "Luxury product photo of an amber glass perfume bottle on wet black marble, gold cap, soft rim light, droplets on the glass, the label reads 'NOIR 07' in elegant serif letters",
    "aspect_ratio": "4:5",
    "seed": 2026
  }
}),
});
console.log(await resp.json()); // 成功返回 { code, message, data: { taskId } }

model string 必填

固定填 fibo-gen-1.5/text-to-image。

示例 fibo-gen-1.5/text-to-image

input object 必填

业务参数对象。

prompt string 必填

图片描述，1–10000 个字符。

aspect_ratio enum 可选

画面比例。

默认 1:1 可选值: 1:12:33:23:44:34:55:49:1616:9

seed integer 可选

随机种子。相同种子和描述会得到相同图片，换一个种子即可得到新结果。

默认 5555

callback object 可选

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

url string 必填

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

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

when enum 可选

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

默认 final 可选值: final

用例示例

香水产品照

瓶身水珠、金属瓶盖和标签文字 NOIR 07 都清晰准确。

请求体

{
  "model": "fibo-gen-1.5/text-to-image",
  "input": {
    "prompt": "Luxury product photo of an amber glass perfume bottle on wet black marble, gold cap, soft rim light, droplets on the glass, the label reads 'NOIR 07' in elegant serif letters",
    "aspect_ratio": "4:5",
    "seed": 2026
  }
}

获取结果

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

常见问题

FIBO Gen 1.5 适合做什么？

适合写实产品图、人像、美食、建筑和带文字的招牌、包装等需要真实质感的图片。

支持哪些画面比例？

aspect_ratio 可选 1:1（默认）、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9。

输出多大？

每次返回 1 张约 100 万像素的 PNG 图片，具体宽高随比例变化，例如 1:1 为 1024 × 1024。

为什么同一句描述每次结果都一样？

seed 默认是 5555，相同种子和描述会得到相同图片。换一个 seed 就能得到不同结果。

画面文字准确吗？

短文字和标题通常能准确呈现。把文字用引号写进提示词并说明位置，效果更稳定。