Muse Image

Muse Image — модель изображений от Meta Superintelligence Labs. Один запрос создаёт одно изображение из промпта или из промпта и до 9 референсных изображений в одном из семи соотношений сторон. Отправьте запрос, сохраните возвращённый идентификатор задачи и получите готовое изображение из задачи. Референсные изображения передаются как URL.

ID моделей

Актуальные цены — на странице модели.

Краткий пример

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-image",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "aspect_ratio": "1:1"
  }'

Конечная точка

POST https://api.seedrouter.ai/v1/images/generations

В ответе приходит задача ({"id": "task_...", "status": "processing"}), а не готовое изображение. Результат получайте опросом GET /v1/tasks/{task_id}. Храните API-ключи в серверном коде. Референсы передаются в том же запросе через image_urls; /v1/images/edits для этой модели не используется.

Параметры

Поля вне этого списка удаляются перед передачей запроса; они не вызывают ошибку и не меняют результат. Настроек разрешения, seed, негативного промпта, маски или формата вывода нет. callback_url недоступен; вместо этого опрашивайте задачу.

Референсные изображения

Передайте до 9 изображений в image_urls и укажите в prompt, что сохранить и что изменить. Muse Image использует их как референсы для нового изображения; если пропустить aspect_ratio, результат следует их форме.

{
  "model": "muse-image",
  "prompt": "Keep this exact jacket; show it folded in a flat lay of hiking gear on pine boards, soft morning light.",
  "image_urls": ["https://example.com/jacket.png"],
  "aspect_ratio": "9:16"
}

Медиавходы

Каждый референс — это публичный URL по HTTP(S). Data URI в base64 не принимаются: загрузите файл в собственное хранилище и передайте его URL. Используйте изображения PNG, JPEG или WebP; суммарный размер исходных файлов всех референсов не должен превышать 11 МБ. Набор, превышающий этот предел, завершится ошибкой после приёма запроса и не оплачивается.

Факторы стоимости

Актуальные тарифы смотрите в разделе цен модели. У Muse Image единая цена за изображение:

cost = price per image × 1

Запросы только с текстом и с референсами при любом соотношении сторон стоят одинаково. Зарезервированная при приёме задачи сумма равна списанной. Итоговые списания смотрите в истории использования своей учётной записи. Неуспешные задачи не тарифицируются.

Схема вывода

При отправке возвращается задача:

{"id": "task_...", "model": "muse-image", "status": "processing", "created_at": 1789689600}

Получение задачи

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Опрашивайте каждые 10–20 секунд, пока status не станет completed или failed. Сетевой тайм-аут во время опроса не означает, что генерация завершилась сбоем: сохраните идентификатор задачи и продолжите проверку. Не создавайте другую задачу, чтобы узнать ход выполнения.

Выполненная задача

{
  "id": "task_...",
  "model": "muse-image",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689680,
  "output": {
    "created": 0,
    "data": [
      { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.webp" }
    ]
  }
}

Изображение приходит в WebP, собственном формате модели; настройки формата вывода нет. Размер в пикселях задаёт модель. В наших тестах запрос только с текстом дал 1600 × 1600, 16:9 — 2048 × 1152, 3:4 — 1344 × 1792, а 9:16 — 1152 × 2048 примерно через 50–180 секунд после отправки.

Ошибки

Запросы, отклонённые до создания задачи, возвращают HTTP-ошибку вместе с объектом error и не тарифицируются. Задача, которая завершилась сбоем уже после приёма, при запросе возвращает HTTP 200 с status: "failed" и объектом error.

Коды, HTTP-статусы и рекомендации по повторным попыткам приведены в общем каталоге ошибок.

{
  "id": "task_...",
  "model": "muse-image",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Если тайм-аут произошёл при самой отправке, сначала проверьте свои задачи и только потом отправляйте повторно: первый запрос мог быть уже принят.

Советы

• Указывайте объект, место, свет и кадрирование; Muse Image точно следует конкретному заданию.
• С референсами точно указывайте, что должно остаться неизменным, например цвет или форма товара.
• Пропустите aspect_ratio, чтобы сохранить форму референса; задайте его для кадрирования под канал.
• Добавьте no text, no logos, чтобы в кадре не появлялись выдуманные знаки.

Связанные материалы

• Playground и цены Muse Image
• Справочник API Muse Video
• Скачать OpenAPI
• Markdown для копирования