orq:image_generation tool lets a text model create an image during a response. The tool entry selects the image model and rendering options. The calling model supplies only the image prompt.
This tool is available on POST /v3/router/responses only. Chat Completions returns 400 for a request that includes it.
Quick start
The examples use the client configuration from the Server tools overview.status, model, and image_url to the calling model. Orq.ai stores the generated image in workspace storage when uploads are available and adds image_path as the durable storage reference. In that case image_url is a presigned link that expires after 7 days, so persist image_path rather than the URL. When storage is unavailable, image_url is a provider-hosted URL and image_path is absent.
Configuration
Rendering options are model-dependent. Unsupported values return an error from the selected image provider.
Cost and usage
The image model call is billed at the selected model’s standard rate. Each tool call appears atusage.server_tool_use.image_generation_calls.