FIBO Gen 1.5 Text to Image API

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

Image, video, and audio models are called through theUnified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model name	fibo-gen-1.5/text-to-image
Type	Image generation (text-to-image)
Endpoint	POST /v1/tasks
Pricing	See HiAPI Pricing

FIBO Gen 1.5: Describe a scene and get a photoreal image with fine materials and lighting, accurate in-image text and 9 aspect ratios.

Production guidance

For production, pass callback.url at the top level of the request body so HiAPI can notify your service when the task reaches a terminal state.
GET /v1/tasks/:id is better for local debugging, low-volume jobs, or fallback reconciliation if a callback is missed.
Result URLs expire — copy the output to your own storage once the task succeeds.

Best suited for

Products & packaging

Labels, packaging text and materials stay crisp and realistic.

promptaspect_ratio

Portraits & lifestyle

Natural-light portraits and lifestyle scenes with real skin texture.

prompt

Reproducible iteration

Keep the seed fixed to compare prompt changes.

seed

Request parameters

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

# Create an async task — returns taskId immediately (generation runs async)
# Replace YOUR_API_KEY with your account 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

# Business params — fields vary by model (see the model page)
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
  }
}
''')

# Create an async task — returns taskId immediately (generation runs async)
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # Returns { code, message, data: { taskId } }

// Create an async task — returns taskId immediately (generation runs async)
// Replace YOUR_API_KEY with your account 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()); // Returns { code, message, data: { taskId } }

model string required

Fixed value fibo-gen-1.5/text-to-image.

example fibo-gen-1.5/text-to-image

input object required

Business parameters.

prompt string required

Image description, 1–10000 characters.

aspect_ratio enum optional

Output aspect ratio.

default 1:1 enum: 1:12:33:23:44:34:55:49:1616:9

seed integer optional

Random seed. The same seed and prompt give the same image; change it for a new result.

default 5555

callback object optional

Optional callback configuration. When set, HiAPI notifies your service when the task reaches a terminal state.

url string required

Required when callback is set; HTTPS URL that receives terminal task notifications.

example https://your-domain.com/hiapi/callback

when enum optional

Callback trigger timing. Use final.

default final enum: final

Example requests

Perfume product shot

Droplets, the metal cap and the NOIR 07 label all come out crisp and correct.

Request body

{
  "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
  }
}

Getting the result

The response returns a taskId immediately without waiting for generation to finish.
In production, prefer waiting for callback.url to receive the terminal notification. For local debugging, poll GET /v1/tasks/:id.
When status=success, download the image from output[].url.
When status=fail, fix the request based on the returned error instead of retrying the same invalid payload.

FAQ

What is FIBO Gen 1.5 good for?

Photoreal product shots, portraits, food, architecture, and signs or packaging with text.

Which aspect ratios are supported?

aspect_ratio accepts 1:1 (default), 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16 and 16:9.

How large is the output?

One PNG of about 1 megapixel per request; width and height follow the ratio, for example 1024 × 1024 at 1:1.

Why does the same prompt give the same image?

seed defaults to 5555, and the same seed and prompt reproduce the same image. Change the seed for a different result.

Is in-image text accurate?

Short text and headlines usually render correctly. Quote the words and describe placement for steadier results.