Generate a chat completion using a Mistral model.

When to use:

• Drafting French (or any European-language) content where Mistral shines.

• Codestral for code-specific generation/review.

• Ministral for cheap / low-latency classification.

Returns structured content with the assistant text and token usage. Does NOT stream — use mistral_chat_stream for long outputs with progress updates.

Fill-in-the-middle code completion with Codestral.

Given prompt (code preceding the cursor) and suffix (code after the cursor), Codestral writes the middle. Use for editor autocomplete scenarios, code-patching agents, or structured refactors where you know the target boundaries.

Default stop tokens: [] — let the model decide. Override with stop if needed.

Chat completion with multimodal input: text + image_url parts.

Requires a vision-capable model. Accepted:

• pixtral-large-latest

• pixtral-12b-latest

• mistral-large-latest

• mistral-medium-latest

• mistral-small-latest

Each message's content is either a plain string (pure text) or an array of parts { type: 'text', text } / { type: 'image_url', imageUrl }. The image URL can be an https URL or a data: URI base64 payload.

Returns the assistant text + token usage. For non-visual requests, prefer mistral_chat.

Run Mistral OCR on a PDF or image, returning structured markdown per page.

Input document is one of:

• { type: "document_url", documentUrl: "https://...pdf" }

• { type: "image_url", imageUrl: "https://..." | "data:image/..." }

• { type: "file", fileId: "" }

Options:

• pages: array of 0-indexed page numbers or string like "0-5,7".

• tableFormat: 'markdown' (default) or 'html'.

• extractHeader / extractFooter: include page header/footer when present.

• includeImageBase64: embed extracted image bytes as base64 in the response.

• document_annotation_format: JSON schema for whole-document structured extraction.

• bbox_annotation_format: JSON schema for extracted image / bbox annotations.

• confidence_scores_granularity: 'page' or 'word'.

Returns pages[].markdown plus optional pages[].hyperlinks, header, footer, images bounding boxes, annotations, confidence scores, and dimensions.

Transcribe an audio file to text using Mistral Voxtral.

Accepted models:

• voxtral-mini-latest

• voxtral-small-latest

Audio source is one of:

• { type: "file_url", fileUrl: "https://..." } (public URL)

• { type: "file", fileId: "" }

Options:

• language: ISO-639-1 hint (e.g. 'fr', 'en'). Boosts accuracy when known.

• temperature: sampling temperature.

• diarize: return per-speaker segments (default false).

• timestampGranularities: ['segment'] to return per-segment timestamps.

• contextBias: list of phrases/terms that should bias the decoder.

Returns plain text, detected language, optional segments[], and token usage.

Start a Mistral Workflow execution.

workflowIdentifier is the workflow name or ID (visible in mistral://workflows). input is a free-form JSON object matching the workflow's input schema.

Modes:

• waitForResult=false (default): returns immediately with execution_id and RUNNING status. Poll workflow_status to track completion.

• waitForResult=true: blocks until the workflow finishes and returns the result inline. Use timeoutSeconds (default 30) to cap the wait.

Use deploymentName to target a specific deployment slot when multiple are configured.

Get the current state and result of a workflow execution.

Statuses: RUNNING | COMPLETED | FAILED | CANCELED | TERMINATED | CONTINUED_AS_NEW | TIMED_OUT | RETRYING_AFTER_ERROR

Poll until status is COMPLETED (or terminal) when waitForResult was false. result is populated once the workflow reaches a terminal state.

Send a signal to or run a query against a running workflow execution.

action=signal: fire-and-forget event; the workflow reacts asynchronously.

• name: signal name defined in the workflow.

• input: optional payload matching the signal's schema.

action=query: synchronous read of internal workflow state.

• name: query handler name defined in the workflow.

• input: optional parameters for the query.

• Returns query_name + result inline.

action=update: synchronous request to modify workflow state mid-execution.

• name: update handler name defined in the workflow.

• input: optional payload for the update.

• Returns update_name + result inline.