Generate image
generate_imageSubmit an image generation request through Rainbrand’s public API. Use a supported image model returned by list_models and follow its published input schema from get_model. Default to openai/gpt-image-2.5-sunburst for image generation and editing, including work with reference images, unless the user asks otherwise. Create or use a task-specific Brief for the brand identified by brand_session_id, wait for completion, and inspect it. For supported models, pass brief_id alongside the model input; Rainbrand supplies guidance and references while the prompt remains authoritative for content and exact copy. Without brief_id, include relevant brand guidance and references in the model input. Retrieve and inspect outputs with get_generation, then request a Review when useful.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"brand_session_id": "<brand_session_id>",
"model": "<model>",
"input": "<input>"
},
"name": "generate_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | Yes | Arguments for the selected model, using the field names and reference formats published by get_model. | |
| model | Yes | Model to run. Choose an ID from list_models whose output type matches the generation tool being called. | |
| brief_id | No | Completed Brief to use for this generation. Rainbrand adds its guidance before your prompt and its visual assets after any references you provide. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Omit it or pass "unknown" if you are not certain; the tool runs the same either way. Recorded only for the server developer's analytics. | |
| idempotency_key | No | Retry key for recovering the original generation after an uncertain response. Reuse it with identical arguments. Without a key, repeating the request starts another generation. | |
| brand_session_id | Yes | Brand session ID from list_brands for the brand this generation belongs to. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Generation ID. Pass it as id to get_generation. | |
| status | Yes | Current generation status. | |
| message_for_assistant | No | Context, explanations, or actionable guidance for the calling assistant. Hosts may display it, but it is not copy that must be shown to the user verbatim. |