MCP tool · generate_image

Generate images right inside the AI-agent chat

Describe the shot in words — the agent calls generate_image, waits for the result, and shows the image right in the chat. You can pass references for editing (image-to-image).

generate_image is a tool of the Clipia MCP server for generating an image from text or editing by references. The agent (Claude, ChatGPT, Cursor) calls it right in the conversation: you give a prompt and optionally aspect ratio, resolution, and up to four reference images. The tool waits for the result for up to 25 seconds and usually returns the ready image together with a compact preview, so the agent can «see» the result and refine it.

Parámetros de la herramienta

ParámetroTipoOblig.Descripción
promptstringsíDescription of the shot (RU or EN)
modelstring—Model slug; defaults to the agent’s pick
aspect_ratiostring—e.g. 1:1, 16:9, 9:16
resolutionstring—1k / 2k / 4k
num_imagesint (1–4)—How many variants to generate
image_urlsstring[] (≤4)—HTTPS references → image-to-image mode
include_previewbool—Return an inline preview (default yes)

Ejemplo de solicitud (MCP tools/call)

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

Ejemplo de respuesta

{
  "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"
    }]
  }
}

Reference-based editing

Pass image_urls and the same tool works in image-to-image mode: background swap, styling, edits.

Preview right in the chat

The agent gets a compact preview and can assess the shot and request an edit at once — a vision loop with no tab switching.

No-charge sandbox

With a clipia_test_* key the tool returns an instant mock — debug the integration without spending credits.

Conecte en un minuto

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

Para claude.ai y ChatGPT no se necesita clave: inicie sesión con su cuenta. Cree una clave en la configuración de Clipia.

Precios

The credit cost is returned in every response (cost_credits) — no hidden MCP markup, the same balance as on the site.

Preguntas frecuentes

Yes, prompt accepts Russian and English text.

Pass up to 4 HTTPS links in image_urls — image-to-image mode turns on.

The credit cost is in every response (cost_credits) and depends on the model and resolution.

Obtener una clave de APITodas las herramientas MCP

Escenarios relacionados: Generate video right inside the AI-agent chat · 5000+ ready prompts right in the chat