Skip to main content
The 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.
The tool returns 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 at usage.server_tool_use.image_generation_calls.