appnz-provider-mistral

name	appnz-provider-mistral
description	Use this skill when the user asks to use Mistral AI, provider mistral, or any mistral model through app.nz; covers model selection when present, BYOK setup, OpenAI-compatible routing, provider-specific endpoints, aliases, and debugging gateway headers.

Mistral AI on app.nz

Route Mistral AI through app.nz with one app.nz key. Use this skill when a user asks for Mistral AI, mistral, one of its model ids, aliases, product integrations, or BYOK setup for this provider.

Workflow

1. Use /api/gateway/models?provider=mistral to confirm the current public model list if exact availability matters.
2. Call app.nz at https://app.nz/v1 with Authorization: Bearer pk_live_...; do not call https://api.mistral.ai directly unless the user explicitly asks to bypass app.nz.
3. Store a user-owned upstream key with POST /api/gateway/provider-keys using provider mistral when BYOK is required. The upstream secret is never returned by app.nz.
4. Prefer a model matching the task modality. If unsure, start with mistral-large-latest or app/auto.
5. Read X-Gateway-Provider and X-Gateway-Model response headers when debugging routing.

BYOK

curl -sX POST https://app.nz/api/gateway/provider-keys \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"provider":"mistral","api_key":"REDACTED_UPSTREAM_KEY"}'

Chat Example

curl -s https://app.nz/v1/chat/completions \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"model":"mistral-large-latest","messages":[{"role":"user","content":"Give me one practical idea."}]}'

Models

Model	Modality	Aliases	Caps
codestral-embed	embeddings	codestral-embedding	-
codestral-latest	chat	codestral	stream, tools
devstral-medium-latest	chat	devstral-medium, devstral	stream, tools
devstral-small-latest	chat	devstral-small	stream, tools, vision
magistral-medium-latest	chat	magistral-medium, magistral	stream, tools, vision
magistral-small-latest	chat	magistral-small	stream, tools, vision
ministral-14b-latest	chat	ministral-14b	stream, tools, vision
ministral-3b-latest	chat	ministral-3b	stream, tools, vision
ministral-8b-latest	chat	ministral-8b, ministral	stream, tools, vision
mistral-embed	embeddings	mistral-embedding	-
mistral-large-latest	chat	mistral-large, mistral-large-3	stream, tools, vision
mistral-medium-latest	chat	mistral-medium, mistral-medium-3	stream, tools, vision
mistral-small-latest	chat	mistral-small	stream, tools, vision
open-mistral-nemo	chat	mistral-nemo, nemo	stream, tools
pixtral-large-latest	chat	pixtral-large, pixtral	stream, tools, vision