MCP-инструмент · generate_image

Генерация изображений прямо в диалоге с AI-агентом

Опишите кадр словами — агент вызовет generate_image, дождётся результата и покажет картинку прямо в чате. Можно передать референсы для редактирования (image-to-image).

generate_image — инструмент MCP-сервера Clipia для генерации изображения из текста или редактирования по референсам. Агент (Claude, ChatGPT, Cursor) вызывает его прямо в диалоге: задаёте промпт, при необходимости — соотношение сторон, разрешение и до четырёх референс-изображений. Инструмент ждёт результат до 25 секунд и обычно сразу возвращает готовую картинку вместе с компактным превью, чтобы агент «видел» результат и мог его докрутить.

Параметры инструмента

ПараметрТипОбяз.Описание
promptstringдаОписание кадра (RU или EN)
modelstringSlug модели; по умолчанию подбирается агентом
aspect_ratiostringНапример 1:1, 16:9, 9:16
resolutionstring1k / 2k / 4k
num_imagesint (1–4)Сколько вариантов сгенерировать
image_urlsstring[] (≤4)HTTPS-референсы → режим image-to-image
include_previewboolВернуть inline-превью (по умолчанию да)

Пример запроса (MCP tools/call)

{
  "name": "generate_image",
  "arguments": {
    "prompt": "тёмный неоновый постер кофейни, крупный план чашки, пар",
    "aspect_ratio": "9:16",
    "resolution": "2k"
  }
}

Пример ответа

{
  "request_id": "f1c3...­9ab",
  "status": "COMPLETED",
  "model": "nano-banana-2",
  "cost_credits": 1,
  "output": {
    "images": [{
      "url": "https://media.clipia.ai/.../preview.webp",
      "original_url": "https://media.clipia.ai/.../original.png"
    }]
  }
}

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

Передайте image_urls — и тот же инструмент работает в режиме image-to-image: замена фона, стилизация, правки.

Превью прямо в чате

Агент получает компактное превью и может оценить кадр и сразу попросить правку — vision-цикл без переключения вкладок.

Песочница без списаний

С ключом clipia_test_* инструмент отдаёт мгновенный mock — отладьте интеграцию без расхода кредитов.

Подключить за минуту

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer clipia_live_XXXX"

Для claude.ai и ChatGPT ключ не нужен — вход по аккаунту. Ключ создаётся в настройках Clipia.

Стоимость

Стоимость в кредитах возвращается в каждом ответе (cost_credits) — без скрытой MCP-наценки, тот же баланс, что на сайте.

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

Да, prompt принимает русский и английский текст.

Передайте до 4 HTTPS-ссылок в image_urls — включится режим image-to-image.

Цена в кредитах указана в каждом ответе (поле cost_credits) и зависит от модели и разрешения.