Опишите кадр словами — агент вызовет generate_image, дождётся результата и покажет картинку прямо в чате. Можно передать референсы для редактирования (image-to-image).
generate_image — инструмент MCP-сервера Clipia для генерации изображения из текста или редактирования по референсам. Агент (Claude, ChatGPT, Cursor) вызывает его прямо в диалоге: задаёте промпт, при необходимости — соотношение сторон, разрешение и до четырёх референс-изображений. Инструмент ждёт результат до 25 секунд и обычно сразу возвращает готовую картинку вместе с компактным превью, чтобы агент «видел» результат и мог его докрутить.
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
prompt | string | да | Описание кадра (RU или EN) |
model | string | — | Slug модели; по умолчанию подбирается агентом |
aspect_ratio | string | — | Например 1:1, 16:9, 9:16 |
resolution | string | — | 1k / 2k / 4k |
num_images | int (1–4) | — | Сколько вариантов сгенерировать |
image_urls | string[] (≤4) | — | HTTPS-референсы → режим image-to-image |
include_preview | bool | — | Вернуть inline-превью (по умолчанию да) |
{
"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://api.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) и зависит от модели и разрешения.