chat
Talk to one or more AI models in parallel, consensus, or roundtable modes. Supports files, images, and multi-turn threads.
Instructions
UNIFIED CHAT — talk to one or more AI models. mode "chat" (default): 1..N models answer independently in parallel. mode "consensus": ≥2 models answer, then refine after seeing each other. mode "roundtable": models answer sequentially, each building on the running transcript. Supports files, images, and continuation_id for multi-turn threads (you may switch modes on resume). Use model "auto" for automatic selection. IMPORTANT: use the "files" parameter to share code/file content instead of pasting into the prompt.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Execution mode. "chat" (default): independent parallel answers. "consensus": ≥2 models answer then refine via cross-feedback. "roundtable": sequential turn-based dialogue in the given model order. Default: "chat". | |
| async | No | Execute in the background. When true, returns a continuation_id immediately and processes the request asynchronously; poll with check_status. Default: false | |
| files | No | File paths to include as context (absolute or relative). Supports line ranges: file.txt{10:50}, file.txt{100:}. Example: ["./src/utils/auth.js{50:100}", "./config.json"]. IMPORTANT: Always use this parameter to share file content instead of copying code into the prompt. | |
| export | No | Export the conversation to disk. Creates a folder named for the continuation_id with numbered request/response files and metadata. Default: false | |
| images | No | Image paths for visual context (absolute or relative paths, or base64 data). Example: ["C:\Users\username\diagram.png", "./screenshot.jpg", "data:image/jpeg;base64,/9j/4AAQ..."] | |
| models | No | Models to use. Examples: ["auto"] (recommended), ["codex"], ["codex", "gemini", "claude"]. In mode "chat" each model answers independently; in "consensus" they refine after seeing each other; in "roundtable" they speak in the given ORDER, each seeing the transcript. Default: ["auto"]. | |
| prompt | Yes | Your question, topic, or task with relevant context. More detail enables better responses. Example: "How should I structure the authentication module for this Express.js API?" | |
| continuation_id | No | Continuation ID for a persistent multi-turn thread. Auto-generated in the first response; pass it back to continue. You MAY change the mode or models on a resuming turn. | |
| reasoning_effort | No | Reasoning depth for thinking models. Examples: "none" (no reasoning, fastest - GPT-5.1+ only), "minimal", "low", "medium" (balanced), "high", "max". Default: "medium" |