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

TL;DR

• Muse Image 1.0 — это модель изображений от Meta, выпущенная 27 августа 2026 года; в HiAPI у неё два эндпоинта: muse-image-1.0/text-to-image (текст в изображение) и muse-image-1.0/image-to-image (редактирование изображения, 1–10 референсов). Откройте страницу модели, чтобы попробовать онлайн.
• Оба эндпоинта стоят $0.015 за изображение. Около 2,5 млн пикселей на изображение, разрешение задавать не нужно.
• Самый быстрый способ: POST /v1/tasks с prompt и aspect_ratio, опрашивайте до статуса success, скачайте output[0].url. Проверять нужно оба статуса ошибки: fail и failed.

Что умеет Muse Image?

• Сначала планирует, потом рисует. Meta рассказывает, что Muse Image сначала продумывает изображение, а затем рисует. На практике такие требования к композиции, как «generous negative space», и короткие брендовые надписи вроде «DAWN», действительно попадают на изображение.
• Иллюстрации, постеры, продуктовые визуалы — $0.015 за изображение, подходит для больших объёмов контента.
• По умолчанию крупное изображение: около 2,5 млн пикселей на изображение, например, 3:2 — примерно 1920×1280, 1:1 — примерно 1600×1600.
• 8-е место в рейтинге text-to-image на Artificial Analysis.

Одно описание, один готовый результат, 3:4:

Editorial paper-cut illustration of a coral fox curled beneath a midnight-blue
tree, scattered warm stars, layered tactile paper edges, clear silhouette and
generous negative space, quiet book-cover composition, no text.

Сгенерировать с этим промптом → (3:4)

muse-image-1.0/text-to-image, 3:4, $0.015.

Два способа начать

Онлайн-попробовать (без кода):

1. Откройте страницу text-to-image или страницу image-to-image, войдите (новым пользователям при регистрации дают 200 кредитов).
2. Вставьте промпт, выберите соотношение сторон. Для редактирования нужно загрузить 1–10 изображений.
3. Нажмите «сгенерировать» и скачайте результат.

Вызов API:

1. Создайте API Key в консоли.
2. POST /v1/tasks, в поле имени модели укажите один из двух эндпоинтов.
3. Опрашивайте GET /v1/tasks/{taskId} или принимайте callback, сохраните output[0].url.

curl: получаем первое изображение

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image-1.0/text-to-image",
    "input": {
      "prompt": "Editorial paper-cut illustration of a coral fox curled beneath a midnight-blue tree, warm stars, generous negative space, no text",
      "aspect_ratio": "3:4",
      "output_format": "png"
    }
  }'

В ответе будет data.taskId. Опрашивайте GET /v1/tasks/{taskId}, когда status станет success, скачайте output[0].url.

Python: сначала генерация, потом редактирование

# pip install requests; export HIAPI_KEY=ваш Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def run(model, timeout_s=300, **inp):
    # при повторной отправке того же запроса используйте тот же Idempotency-Key — спишется только один раз
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] in ("fail", "failed"):
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# text-to-image, шапка 16:9 ($0.015)
header = run("muse-image-1.0/text-to-image",
             prompt="A sophisticated editorial illustration of a terracotta desert observatory under an oversized pale moon, winding turquoise river, no text",
             aspect_ratio="16:9", output_format="png")

# превращаем предыдущее изображение в ночной пейзаж ($0.015)
night = run("muse-image-1.0/image-to-image",
            prompt="Turn the illustration into night: deep indigo sky, silver crescent moon, warm amber windows. Keep the buildings and river.",
            image_urls=[header], aspect_ratio="16:9", output_format="png")

with open("night.png", "wb") as f:
    f.write(requests.get(night).content)

Ссылка на первое изображение ещё действительна и доступна публично, поэтому её можно сразу передать как референс. Изображения, которые нужно сохранить надолго, сначала скачайте.

Редактирование по референсам

В muse-image-1.0/image-to-image обязательно передавать image_urls (1–10 изображений). Дайте каждому изображению свою задачу: ниже изображение 1 даёт主体 кита, изображение 2 — только макет, весь старый текст заменяется.

Design a polished illustrated travel poster using the indigo whale and warm
stars from Image 1 as the central artwork. Borrow the cream paper, forest-green
framing and clean heading hierarchy from Image 2. Replace all old poster text
with a single large heading SEABOUND at the top and the smaller line STORIES
UNDER THE STARS below. Keep the whale recognizable, use balanced spacing and
delicate layered paper detail.

Открыть страницу image-to-image с этим промптом → (загрузите свои два изображения)

muse-image-1.0/image-to-image, два референса, $0.015.

Заголовок и подзаголовок совпадают дословно, но Muse добавил внизу лишнюю строку мелкого текста, которую не просили. Когда текст должен быть точным, добавьте в конец промпта «no other text».

Шпаргалка по параметрам

Поле	Значения	Описание
prompt	строка, обязательно, до 5000 символов	Опишите изображение или чётко укажите, что нужно изменить и что сохранить
image_urls	1–10 публичных ссылок	Обязательно для эндпоинта image-to-image; для text-to-image не нужно
aspect_ratio	1:1 4:3 3:4 16:9 9:16 3:2 2:3 21:9 9:21	Необязательно; если не указано, модель определяет композицию по содержимому
output_format	jpeg / png / webp, по умолчанию webp	Все три по одной цене

Поля resolution нет. Около 2,5 млн пикселей на изображение, ширина и высота зависят от соотношения сторон.

Что учесть перед запуском в продакшен

• Для фиксированных мест размещения обязательно указывайте aspect_ratio. Если не указать, модель определит сама — для исследования это нормально, но для баннера уже нет.
• Проверяйте и fail, и failed. В документации указан failed, но проверять оба надёжнее.
• Используйте callback вместо опроса: на уровне input добавьте "callback": {"url": "https://your-app.example.com/hiapi/callback"} и дедуплицируйте по taskId.
• Сразу сохраняйте результат. У output[0].url есть срок действия, скачивайте вовремя или выбирайте постоянное хранение при создании задачи.
• Передавайте заголовок Idempotency-Key: при повторной попытке с тем же Key задача создастся только один раз.

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

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

1. Если нужно несколько вариантов, отправляйте отдельные задачи.

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

Нет, Muse Image фиксирован примерно на 2,5 млн пикселей. Для 4K выберите FLUX.3 Image или Nano Banana 2.1.

Можно использовать image-to-image без референсов?

Нет, для image-to-image обязательно передавать 1–10 изображений. Если начинаете с текста, используйте muse-image-1.0/text-to-image.

Списываются ли деньги при неудачной генерации?

Нет. Оплата только за успешно сгенерированное изображение.

Цены см. в цены Muse Image API, больше промптов — в примерах промптов Muse Image, сравнение на одинаковых промптах — в Muse Image vs Nano Banana 2.1. Также можно сразу перейти на страницу модели и сгенерировать эту бумажную лису.