Run a Wiro model
run_modelRun any AI model on Wiro for generation, editing, or analysis across image, video, text, audio, and 3D. Provide the model slug and parameters to execute a task and return its output.
Instructions
Run any AI model on Wiro. Supports image, video, text, audio, 3D, and more. Call get_model_schema first. With wait=true this performs a bounded wait; when the response contains nextAction.tool = "wait_for_task", call that tool with the exact arguments returned. Do not resubmit the original request. A completed tool-call turn instead returns a run_model continuation template; execute its calls, fill its toolOutputs, and invoke it once. When the task completes, present every returned media resource in the user-facing response instead of reporting only task metadata.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | If true, poll until completion and return the result. If false, return the task identifiers immediately. | |
| model | Yes | Model slug in "owner/model" format, e.g. "openai/sora-2", "google/nano-banana-pro" | |
| params | Yes | Model-specific parameters as key-value pairs. Use get_model_schema to discover available parameters. Pass json and json-array parameters as structured JSON values in this same object. Continue a completed turn with previousTaskToken: add toolOutputs rows with call_id and output for tool results, or provide exactly one new prompt or non-empty messages value for a stateful next turn. For file parameters (fileinput, multifileinput, combinefileinput), pass URLs directly — no upload needed. For combinefileinput, pass an array of URLs. | |
| timeout_seconds | No | Maximum seconds to wait when wait=true. The 45-second default is safe for clients with a 60-second tool timeout. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | ||
| error | No | ||
| state | Yes | ||
| outputs | Yes | ||
| response | No | ||
| nextAction | No |