chat
Send prompts to one or more AI models using parallel chat, consensus refinement, or sequential roundtable modes. Include files and images, and resume conversations with a continuation ID.
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, weakest to strongest: "none" (reasoning off, where the model allows it), "minimal", "low", "medium" (balanced), "high", "xhigh", "max". Passed through by name when the model accepts it, otherwise clamped to the nearest tier it does. Default: "medium" |