Как пользоваться Krea 3 API? Первое изображение за 5 минут

TL;DR

• Krea 3 (krea-3/text-to-image) — модель текст-в-изображение: одно описание даёт реалистичную фотографию, иллюстрацию или концепт-арт; перед генерацией она понимает и расширяет промпт, два варианта berry (приоритет качества, по умолчанию) / jam (приоритет скорости) переключаются по одной цене. Откройте страницу модели, чтобы попробовать; новым пользователям при регистрации дают 200 кредитов.
• Цена за штуку: Krea 3 — $0.036; в том же семействе есть более экономичная Krea 2 Medium Turbo (krea-2-medium-turbo) — $0.0215 (полная таблица цен на странице цен).
• Вызов идёт через интерфейс HiAPI /v1/tasks: отправьте задачу и получите taskId, затем запросите результат, а после успеха скачайте изображение из output[0].url.

Что она умеет

• Полная картина даже по одному промпту: перед генерацией модель выполняет рассуждение и расширение, так что даже a lighthouse дополнится временем суток, светом и композицией; если написать конкретно — будет следовать вашему описанию.
• Два варианта berry / jam под одним ID: переключаются через variant, параметры и цена полностью одинаковы; при одном seed у них разные композиция и цветовая гамма, можно запустить оба и выбрать как два варианта.
• 6 предустановленных размеров до 1K: квадратные, вертикальные и горизонтальные — всего 6 (от 1024×1024 до 1024×576), вывод в PNG или JPEG.
• Умеет и постеры с текстом заголовка: текст заключите в кавычки, короткие заголовки обычно точны.

Ниже — реальный результат berry:

Studio product photograph of a frosted glass perfume bottle with a brushed brass cap standing on a block of travertine, hard afternoon sunlight casting a long palm-leaf shadow across a warm beige wall, crisp reflections, high-end editorial look

(По-русски: студийная предметная фотография: флакон духов из матового стекла с крышкой из брашированной латуни стоит на блоке травертина, жёсткий послеполуденный свет отбрасывает длинную тень пальмового листа на тёплую бежевую стену, чёткие отражения, фактура высококлассного журнала. Размер — по умолчанию square_hd.)

krea-3/text-to-image, berry, square_hd, 1024×1024, $0.036.

Сгенерировать с этим промптом →

Как выбрать между двумя моделями

	krea-3/text-to-image (Krea 3)	krea-2-medium-turbo (Krea 2 Medium Turbo)
За штуку	$0.036	$0.0215
Размеры	6 предустановок (максимум 1024×1024), пользовательские не поддерживаются	aspect_ratio, 8 пропорций, включая кинематографическую 2.35:1
Особые параметры	variant (berry/jam), reasoning_level (рассуждение и расширение), negative_prompt (только berry)	creativity, 4 уровня (raw/low/medium/high)
Обработка промпта	Перед генерацией рассуждение и расширение, полная картина даже по короткой фразе	Генерирует по исходному тексту, насколько подробно написано — настолько подробно и выйдет
Подходит	Финальная генерация, быстрый поиск по коротким промптам, постеры с текстом	Пакетная генерация, широкоформатные композиции, повседневное производство с ограниченным бюджетом

Модели можно использовать вместе: Krea 2 — черновик для определения направления, Krea 3 — финальная версия; черновик плюс финал — $0.0575. Как подбирать промпты под сценарии, смотрите в сборнике промптов.

Два пути к началу работы

В браузере, 3 шага: откройте страницу модели → вставьте промпт, выберите размер → нажмите «Сгенерировать», одно изображение — $0.036.

Через API, 3 шага: POST /v1/tasks отправить → получить taskId → GET /v1/tasks/<taskId>, дождаться success и скачать.

curl: первое изображение

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-001" \
  -d '{
  "model": "krea-3/text-to-image",
  "input": {
    "prompt": "Studio product photograph of a frosted glass perfume bottle with a brushed brass cap standing on a block of travertine, hard afternoon sunlight casting a long palm-leaf shadow across a warm beige wall, crisp reflections, high-end editorial look",
    "image_size": "square_hd",
    "variant": "berry",
    "reasoning_level": "medium"
  }
}'

Чтобы переключиться на Krea 2 Medium Turbo, измените только model и поля input:

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": "Futuristic city skyline at dusk, neon reflections on wet streets, cinematic widescreen",
    "aspect_ratio": "2.35:1",
    "creativity": "low"
  }
}'

taskId в ответе — это идентификатор для запроса результата.

Python: отправка, опрос, скачивание

import time, uuid, requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "model": "krea-3/text-to-image",
    "input": {
        "prompt": "Studio product photograph of a frosted glass perfume bottle with a brushed brass cap standing on a block of travertine, hard afternoon sunlight casting a long palm-leaf shadow across a warm beige wall, crisp reflections, high-end editorial look",
        "image_size": "square_hd",
        "variant": "berry",
        "reasoning_level": "medium",
    },
}

# Отправка: с Idempotency-Key сетевые повторы не создадут дублирующую задачу
resp = requests.post(
    BASE,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json=payload,
    timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["taskId"]

# Опрос: queued -> handling -> archiving -> success / fail
while True:
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    print(task["status"])
    if task["status"] in ("success", "fail"):
        break
    time.sleep(3)

if task["status"] == "success":
    image_url = task["output"][0]["url"]   # временный адрес, скачайте и сохраните как можно скорее
    img = requests.get(image_url, timeout=60)
    with open("output_image", "wb") as f:  # расширение — по фактическому формату из ответа
        f.write(img.content)
    print("saved")

Таблица параметров (krea-3/text-to-image)

Поле	Обязательно	Значения	Описание
prompt	Да	1–5000 символов	Описание изображения; чем конкретнее, тем точнее следует описанию
image_size	Нет	square_hd / square / portrait_4_3 / portrait_16_9 / landscape_4_3 / landscape_16_9, по умолчанию square_hd	Предустановка размера, максимум 1024×1024; auto и пользовательские ширина/высота не поддерживаются
variant	Нет	berry / jam, по умолчанию berry	berry — приоритет качества, jam — приоритет скорости; цена одинаковая
reasoning_level	Нет	low / medium, по умолчанию medium	Степень рассуждения и расширения промпта; для коротких промптов — medium, для конкретных — low
negative_prompt	Нет	≤1024 символов	Нежелательное содержимое; действует только для berry
output_format	Нет	png / jpeg, по умолчанию png	Формат вывода
seed	Нет	целое число 0–2147483647	Воспроизводимость в пределах варианта; berry и jam взаимно не воспроизводятся

У Krea 2 Medium Turbo поля другие: prompt (обязательно), aspect_ratio (8 вариантов, по умолчанию 1:1), creativity (raw/low/medium/high, по умолчанию low), seed. Поле вне таблицы в теле запроса сразу даёт 400.

Ошибки, которые вы встретите (текст интерфейса)

Что вы сделали	Ответ
Передали auto в image_size	400 invalid input: image_size: value must be one of 'square_hd', 'square', 'portrait_4_3', 'portrait_16_9', 'landscape_4_3', 'landscape_16_9'
Передали поле вне таблицы (например, num_images)	400 invalid input: <root>: additional properties 'num_images' not allowed
prompt пустой	400 invalid input: prompt: minLength: got 0, want 1
Опечатка в variant	400 invalid input: variant: value must be one of 'berry', 'jam'
Недостаточно средств	402 insufficient account balance; top up and retry

Запросы, не прошедшие валидацию параметров, не списывают средства. Повторная отправка с тем же Idempotency-Key возвращает 409 (в обработке) или 422 (параметры не совпадают), попробуйте с новым key.

Перед запуском в продакшен

• Callback: передайте на верхнем уровне тела запроса "callback": {"url": "https://..."}, и задача в конечном состоянии уведомит ваш сервис — опрос не нужен.
• Своевременно переносите: output[0].url — временный адрес, сразу скачивайте и сохраняйте в своё хранилище.
• Только 6 размеров: для кинематографической 2.35:1 или других пропорций используйте aspect_ratio у Krea 2 Medium Turbo.
• seed воспроизводится только в пределах варианта: berry и jam с одним seed дадут разные изображения; для серий фиксируйте variant + seed.

Частые вопросы

Можно ли получить изображение по короткому промпту?

Да. Модель выполняет рассуждение и расширение, и даже фразы a lighthouse достаточно для полной картины; если хотите управлять деталями — пишите промпт конкретнее.

berry и jam отличаются только скоростью?

Не только. При одном seed у них разные композиция и цветовая гамма при сопоставимом качестве; запускайте оба как два варианта и выбирайте.

Действует ли negative_prompt на оба варианта?

Только на berry; при передаче jam он не действует.

Сколько изображений за раз?

За раз только 1. Для нескольких отправляйте больше задач или перезапускайте с другим seed.

Сколько изображений на $10?

Krea 3 — $0.036 за штуку, примерно 277 штук. Новым пользователям при регистрации дают 200 кредитов (1 доллар = 2 000 кредитов).

Дальше: возьмите промпт с флаконом духов и попробуйте на странице модели, а затем подбирайте шаблоны под сценарии из сборника промптов.