Krea 2 Medium Turbo 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	krea-2-medium-turbo
Type	Image generation (text-to-image)
Endpoint	POST /v1/tasks
Pricing	See HiAPI Pricing

Krea 2 Medium Turbo: fast text-to-image with 8 aspect ratios including 2.35:1 widescreen, four creativity levels and reproducible seeds.

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

Concepts & fast iteration

Fast output for repeated prompt tweaks.

promptcreativity

Cinematic & banners

2.35:1 widescreen for cinematic framing and banners.

aspect_ratio

Reproducible iteration

Fix the seed to compare prompt and creativity changes.

seedcreativity

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": "krea-2-medium-turbo",
  "input": {
    "prompt": "Cinematic wide shot of a lone lighthouse on a rocky coast at blue hour, warm light in the lantern room, waves breaking on the rocks, light mist over the sea",
    "aspect_ratio": "2.35:1",
    "creativity": "low"
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "krea-2-medium-turbo",
  "input": {
    "prompt": "Cinematic wide shot of a lone lighthouse on a rocky coast at blue hour, warm light in the lantern room, waves breaking on the rocks, light mist over the sea",
    "aspect_ratio": "2.35:1",
    "creativity": "low"
  }
}
''')

# 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": "krea-2-medium-turbo",
  "input": {
    "prompt": "Cinematic wide shot of a lone lighthouse on a rocky coast at blue hour, warm light in the lantern room, waves breaking on the rocks, light mist over the sea",
    "aspect_ratio": "2.35:1",
    "creativity": "low"
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

Fixed value krea-2-medium-turbo.

example krea-2-medium-turbo

input object required

Business parameters.

prompt string required

Image description, 1–5000 characters.

aspect_ratio enum optional

Output aspect ratio, including 2.35:1 widescreen.

default 1:1 enum: 1:14:33:216:92.35:14:52:39:16

creativity enum optional

How loosely the prompt is interpreted: lower stays closer, higher is more creative and may drift.

default low enum: rawlowmediumhigh

seed integer optional

Optional random seed. Random when omitted; fix it with the other inputs to reproduce a result.

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

Widescreen lighthouse

A 2.35:1 cinematic frame with the default low creativity.

Request body

{
  "model": "krea-2-medium-turbo",
  "input": {
    "prompt": "Cinematic wide shot of a lone lighthouse on a rocky coast at blue hour, warm light in the lantern room, waves breaking on the rocks, light mist over the sea",
    "aspect_ratio": "2.35:1",
    "creativity": "low"
  }
}

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 Krea 2 Medium Turbo good for?

It turns a text description into a high-fidelity image very quickly, which suits work that needs fast iteration on prompts, such as concept sketches, social visuals and cinematic frames.

Which aspect ratios are supported?

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

What is the 2.35:1 ratio for?

2.35:1 is a common widescreen cinema ratio, suited to cinematic scenes, website banners and video covers that need an extra-wide frame.

What does creativity do?

creativity controls how loosely the prompt is interpreted: raw, low, medium or high. Lower values stay closer to the prompt; higher values are more creative and may drift from it.

What is the default creativity?

On HiAPI it defaults to low, which keeps results close to the prompt. Switch to medium or high for more variation.

How do I use seed?

seed is an optional integer. Leave it out for a random result each time; keep the seed and other inputs fixed to reproduce a result and compare prompt or creativity changes.

How many images per request?

One image per request; submit several tasks for more.

Is there a prompt length limit?

prompt is required and must be 1–5000 characters.

Do I need a reference image?

No. This is a pure text-to-image model driven by the prompt alone. Style reference images, preset styles and moodboards are not offered at this time.

How is it billed?

Billing is per output image, one image per request. See the live price on this page for the current rate.

How do I get the result?

POST /v1/tasks returns a taskId right away. In production set callback.url to receive the completion notice; while debugging poll GET /v1/tasks/:id, then download the image URL from output once the task succeeds.

Is there content safety screening?

Yes. Safety screening is on for every generation, and requests that break content rules may fail.