generate image
generate_imageCreate one independent billable Studio task. For user-attached or local media in a host with native APIXO attachments, use reference_files with file_bindings. ChatGPT and native Codex connectors use this route. Pass the host-provided attachment or the absolute local path when the connector accepts paths. If the native attachment fails, ask the user to reattach it or supply a usable URL. Do not rehost a failed native attachment without an explicit user request. Put existing media URLs supplied or selected by the user in input. Choose the attachment route by capability. Use reference_files when the client provides native APIXO attachments, including ChatGPT and compatible Codex connectors. Otherwise, for user-selected files accessible to the client, automatically use upload_reference and the APIXO uploader when the client can run Node.js 22+ and reach APIXO. This applies to Claude Code, Cursor, Grok Bot, WorkBuddy, and other clients that meet those conditions. A request to use the selected files in APIXO is sufficient to start the upload; honor the client's execution permissions. Read the model schema and identify each destination URL field before uploading. Submit only confirmed URLs in the user's order. If file access or execution is unavailable, explain the limitation and ask for a usable direct link. Keep upload grants out of replies and show reference URLs only on request. Read list_models.defaults for the default model of this tool, then get_model_schema for the complete schema. generate_task requires model; shortcuts may omit it. Explicit model selects that public task model. Set the documented mode in input; no mode, model fields, defaults or voice choices are inferred or injected. Flat model parameters and legacy reference_images/reference_audio are not accepted. Backend validation is authoritative. Use session_title for a new topic, session_id to continue, and session_id plus base_run_id for a version. Preserve returned model/task_id/session_id/run_id/media_type. Never automatically resubmit or change model/session after rejection or an unconfirmed submission. In user-facing replies, omit technical identifiers by default, including user/profile IDs, task_id, session_id, run_id, base_run_id, voice_id, and file IDs. Retain the exact returned identifiers for tool arguments, task queries, session continuation, version appends, and voice reuse; never redact, regenerate, or guess these references. Show an identifier only when the user explicitly asks for it or a specific troubleshooting step requires that exact value, and show only the reference needed. Prefer plain-language status, model names, result previews/download links, and Studio links built from the returned session_id. This changes reply presentation only; tool result fields remain available for the workflow.
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": {
"input": "<input>"
},
"name": "generate_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | Yes | Follow get_model_schema.schema for the original model parameters, including nested objects and arrays. For files bound through reference_files, leave the bound URL fields absent from input. Use direct media URL fields for existing links supplied or selected by the user. Do not mix media URLs with reference_files. Routing, identity and session overrides are not model inputs. | |
| model | No | Omit to use this tool's default from list_models.defaults. Supply a canonical ID or exact slug to select another task model; read its complete schema first. | |
| session_id | No | Use a returned or user-provided Studio session ID to add related work to that project. Never guess a session ID. | |
| base_run_id | No | To revise a specific work, pass its returned run_id and the same session_id. Omit to create an independent work in the project. | |
| file_bindings | No | Use paths declared in schema.mcp.attachments. Replace [] with an explicit input array index, e.g. elements[0].image_urls; provide parent objects and their metadata in input. Bind every file once using zero-based file_indices in intended order. Never overwrite direct URLs or guess fields or ordering. | |
| session_title | No | Required for a new Studio topic: 1-255 characters after trimming. Ignored when session_id is provided. | |
| reference_files | No | Use this field for attached or local media when the host provides native APIXO attachment support. Use the host-provided files or absolute local paths when the connector accepts them, in the intended order. Use file_bindings to select model fields. Do not re-upload a failed native attachment without the user's explicit request. file_id is metadata. Use temporary download URLs only for this call and pass only known file metadata. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | Yes | ||
| model | Yes | ||
| state | Yes | ||
| run_id | No | ||
| task_id | Yes | ||
| progress | Yes | ||
| voice_id | Yes | ||
| created_at | Yes | ||
| media_type | Yes | ||
| session_id | No | ||
| completed_at | Yes | ||
| preview_urls | Yes | ||
| text_outputs | No | ||
| download_urls | Yes |