What it does
This tool lets an agent call a nativecreate_image function. Fetch Hive executes the function server-side against the image generation service, which avoids remote MCP timeout limits for long-running image jobs. The API used depends on the agent’s primary provider:
- OpenAI agents — routes to OpenAI’s image generation API (
gpt-image-2). Fetch Hive forces agent image size and quality toautoto control hosted LLM credit usage. - xAI agents — routes to Grok Imagine (
grok-imagine-image-quality). OpenAI-only options (size, quality, background, etc.) are ignored. - Gemini agents — routes hosted requests to Gemini 2.5 Flash Image through Vertex AI. Personal/BYOK Gemini image generation is not supported yet. OpenAI-only options are ignored.
- Other personal agents — route image generation through the workspace OpenAI provider key.
- Hosted — images are billed against your workspace’s hosted LLM credit balance (no API key required).
- Personal — your workspace’s own provider key is used and charged directly. OpenAI and xAI agents use their matching provider key; other personal agent providers use the workspace OpenAI key for images. Gemini personal image generation is not supported yet.
Adding the tool to an agent
- Open an agent in the editor.
- Click the button with the tooltip Add MCP Tool or Sub Agent.
- In MCP Tools, click Image Generation.
Configuration
| Option | Description |
|---|---|
| Billing | hosted uses Fetch Hive managed provider credentials and hosted LLM wallet checks; personal uses your workspace provider key and skips hosted-wallet precheck |
Available options (exposed to the agent)
The agent controls these parameters when calling the tool:| Parameter | Description | Default |
|---|---|---|
prompt | Text description of the desired image | Required |
n | Number of images to generate (1–10) | 1 |
size | 1024x1024, 1536x1024, 1024x1536, or auto | auto |
quality | high, medium, or low | medium |
output_format | png, jpeg, or webp | png |
background | transparent, opaque, or auto | auto |
moderation | low or auto | auto |
Output
Each generated image is uploaded to R2 storage and returned as an asset record with a permanent public URL. The agent receives the URL(s) and may include them in its response. Before calling the image provider, Fetch Hive checks whether your account has reached its plan storage limit. If the limit is reached, the tool returns an error instead of generating new images.Billing
- OpenAI (
gpt-image-2): token-based billing. Input image tokens, input text tokens, and output tokens are recorded in the completion and appear in your usage dashboard. - xAI (Grok Imagine): per-image billing at a fixed rate per image generated. Token fields are set to 0.
- Gemini (
gemini-2.5-flash-image): hosted token billing through Vertex AI. Personal/BYOK Gemini image generation is not supported yet. Input tokens and generated-image output tokens are recorded in the completion for hosted billing.
Use cases
- Generate product mockups or illustration drafts from a prompt.
- Create supporting visuals during a longer research or writing task.
- Combine with Vector Search and SERP to produce richly illustrated reports.
Notes
- Image Generation works with all supported LLM providers (OpenAI, Anthropic, xAI, Gemini). Context and credentials travel in a short-lived JWT from Fetch Hive to the image service.
- For personal agents whose LLM provider is not OpenAI or xAI, configure an OpenAI provider key before enabling Image Generation. Gemini personal image generation is not supported yet.
- Agent image generation is executed by Fetch Hive after the model emits
create_image, so long-running generations are not limited by provider remote MCP timeouts. - For generating images from a workflow step (not an agent), see the Image Generation workflow step.
- To add or remove tools from an agent, see Creating and Configuring.