generate_image

co.creativeclaw/creative-claw · Verify this server

Generate or edit images using AI models. Use this for AI-generated visual assets, including branded social cards, banners, posters, product images, and images guided by a saved theme or reference image. An explicit image-model choice always takes precedence: when the user names GPT Image 2.5, GPT Image 2, Nano Banana, Seedream, or another image model, use generate_image rather than render_html_image. Use render_html_image only when the user explicitly asks to render HTML/CSS, supplies HTML, or requests a deterministic code-based layout. **Two modes:** - **Generate** (no image_url): Create an image from a text prompt. - **Edit** (with image_url): Transform an existing image based on the prompt. The result renders automatically in an inline widget that polls for completion on its own — the user sees the image without any further action from you. Do NOT call check_job just to display or confirm the result; that only adds redundant round-trips. Call check_job ONLY when YOU need the final image URL for a follow-up step (editing it, reusing it as a reference, saving, or posting it). Recommended models (pass as the "model" parameter). Prefer Google Nano Banana 2 — it's the top pick for almost everything: - "image/nano-banana-2" — Google Gemini 3.1 Flash Image. ⭐ DEFAULT & TOP PICK — best all-around balance of quality, intelligence, speed, and cost [generate + edit] - "image/nano-banana-pro" — Google Gemini 3 Pro Image. Best for complex professional assets, precise multilingual typography, multi-reference compositions, and demanding edits [generate + edit] - "image/seedream-5-pro" — ByteDance Seedream 5 Pro via Pika. Flagship product/marketing generation and precise edits using up to 10 references; 1K/2K output [generate + edit] - "image/gpt-image-2.5-flare" — OpenAI GPT Image 2.5 Flare. Fast, high-quality everyday generation and editing [generate + edit] - "image/gpt-image-2.5-sunburst" — OpenAI GPT Image 2.5 Sunburst. Precision-focused instruction following, text rendering, transparency, and controlled editing [generate + edit] Default to image/nano-banana-2 as the cost-efficient choice for most work. Use image/gpt-image-2.5-flare for fast OpenAI image work, image/gpt-image-2.5-sunburst for precision-focused generation and tightly controlled edits, image/nano-banana-pro for complex professional assets, or image/seedream-5-pro for premium commercial imagery. Use list_models to discover other available models only when the user asks or the brief requires a capability these models do not cover. Use get_model_params with the selected model ID before passing model-specific parameters. Chaining rule: if a downstream step depends on this image, you MUST call check_job with the returned job ID until status=completed, then pass the returned permanent image URL to the downstream tool. A queued or in_progress job ID is not a usable media input. Tips: - Use the `size` field for output dimensions. Supported values: "1:1" (1080x1080), "4:5" (1080x1350, IG portrait), "5:4" (1350x1080), "9:16" (1080x1920, story/reel), "16:9" (1920x1080, wide). These are normalized for the recommended image models. - In ChatGPT, call import_chatgpt_media for files already pasted, attached, or generated in the conversation. Call import_media only when the user needs the interactive upload picker. Use the durable Creative Claw URL returned by either tool. - width/height are still accepted for backwards compatibility but `size` is preferred — different models silently disagree on which dimension param they read, and `size` normalizes for you. - Set seed for reproducible results - For editing, strength controls how much to change: 0.0 = barely alter, 1.0 = completely reimagine (default 0.75) - Models marked [edit only] require image_url. Models marked [generate only] cannot edit. - Prompt rewriting is off by default. Preserve the user's prompt as written unless they ask for model-specific optimization; then set agentic_prompting=true. - Use get_model_params to discover model-specific parameters, then pass them via the "extras" field - extras.image_urls provides additional style/character reference images — NOT for compositing. Every URL must be public/directly fetchable or returned by import_media/import_chatgpt_media. The source image should always be passed via image_url. If you pass extras.image_urls without image_url, the first URL is automatically used as the source image. - GPT Image 2.5 accepts up to 16 reference images. Keep individual references below the provider upload limit; compress oversized references or use a Nano Banana model when needed.