Mistral AI integration

What it does

Mistral AI builds open and commercial models with European data residency. Connect a Mistral account and your workflows can generate replies and structured JSON, read images, turn PDFs and scans into Markdown with Mistral OCR, transcribe calls with Voxtral, moderate content, run the agents you built in Mistral's Agent Builder, keep an agent's document library in sync, and queue large jobs through the discounted Batch API. Every model field is a picker filtered to the models that can do the job, drawn from the connected account's live roster, so nobody has to remember a model name.

Connect a Mistral AI account

Mistral authenticates with a single API key.

1. Sign in at console.mistral.ai. The free Experiment plan needs no card, only a one-time phone verification.
2. Open API Keys, click Create new key, and copy the value. Mistral shows it once, but you can create a replacement at any time.
3. In TaskJuice, add a Mistral AI node to a workflow, open its connection picker, and paste the key.

A key reaches everything in its Mistral workspace, so create a separate workspace and key per client when you need to keep their files, agents and libraries apart.

Triggers

Mistral publishes no webhooks, so the one trigger checks on a schedule.

• mistral/batch-job-finished: fires when a batch job reaches the status you choose (Succeeded, Failed, Timed out or Cancelled). Jobs already in that status when you publish are skipped. Each activation carries the newly finished jobs in items; add a Loop to handle each one, and Download File with the job's output_file to read its results.

Actions

Generate

• mistral/create-chat-completion: generate a reply from a chat model, with JSON mode, structured output and tool calling.
• mistral/analyze-image: describe an image, read text from it, or answer a question about it, from a file or an image URL.
• mistral/create-fim-completion: fill in code between a prefix and a suffix with Codestral.
• mistral/create-embedding: turn text into embedding vectors for search and retrieval.

Documents and audio

• mistral/ocr-document: convert a PDF, image, Word or PowerPoint file into Markdown page by page, and optionally extract structured fields with an annotation schema.
• mistral/create-transcription: transcribe a recording, with optional speaker labels and timestamps.

Moderation

• mistral/moderate-text: classify text against Mistral's policy categories.
• mistral/moderate-chat: classify the last message of a conversation in context.

Agents and conversations

• mistral/run-agent: send messages to one of your Mistral agents and get its reply.
• mistral/start-conversation: start a stored conversation with an agent, or with a model plus built-in tools such as web search.
• mistral/continue-conversation: add the next message to a stored conversation.
• mistral/list-agents and mistral/get-agent: look up your agents and their configuration.

Libraries

• mistral/list-libraries, mistral/create-library and mistral/delete-library: manage the document libraries your agents search.
• mistral/upload-library-document: add a document to a library, for example whenever a file lands in a client's shared drive.
• mistral/list-library-documents, mistral/get-library-document and mistral/delete-library-document: check processing status and prune documents.

Files and batch jobs

• mistral/upload-file, mistral/list-files, mistral/get-file, mistral/get-file-signed-url, mistral/download-file and mistral/delete-file: manage files used for OCR and batch jobs.
• mistral/create-batch-job: queue many requests as one job at a lower price, inline or from an uploaded JSONL file.
• mistral/list-batch-jobs, mistral/get-batch-job and mistral/cancel-batch-job: track and control batch jobs.

Models

• mistral/list-models and mistral/get-model: see which models the account can use and what each can do.

Known limitations

Inline files are capped at 10 MB. Analyze Image and Extract Text from Document send a file from an earlier step inline. For larger documents, pass a public URL instead.

Free-plan rate limits are low. The Experiment plan allows only a few requests per second and signals throttling with 429, which TaskJuice retries. Upgrading the Mistral workspace to a paid plan lifts the limits with no change in TaskJuice.

Batch Job Finished checks the newest 100 jobs in a status. If more than 100 jobs reach the same status between two checks, the oldest of them are not reported. Shorten the poll interval for very high batch volume.

Model IDs change. Mistral retires dated model versions on a published schedule. Model fields are pickers bound to the live roster for this reason, so prefer picking a -latest model over typing a fixed ID.