appnz-chat-completions

name	appnz-chat-completions
description	Use this skill for app.nz OpenAI-compatible chat completions, streaming, tool-calling, auto-routing, model fallback, and using app/auto or provider-specific chat models through /v1/chat/completions.

app.nz Chat Completions

Use POST /v1/chat/completions on app.nz. Authenticate with an app.nz bearer key unless the endpoint is explicitly public.

Workflow

1. Choose app/auto or a modality-specific auto model when possible.
2. For exact provider routing, call GET /api/gateway/resolve?model=MODEL.
3. For provider-owned billing, store BYOK first with /api/gateway/provider-keys.
4. Run the request and inspect X-Gateway-Provider and X-Gateway-Model for routed upstream details.
5. Check /api/usage when the user asks about spend.

Example

curl -sX POST https://app.nz/v1/chat/completions \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"model":"app/auto","messages":[{"role":"user","content":"Write a haiku about latency."}],"stream":false}'

Relevant Models

Model	Modality	Aliases	Caps
claude-fable-5	chat	fable-5	stream, tools, vision
claude-fable-latest	chat	claude-fable, fable-latest, fable, anthropic-fable-latest	stream, tools, vision
claude-haiku-4-5-20251001	chat	claude-haiku, haiku	stream, tools, vision
claude-opus-4-1-20250805	chat	opus-4.1	stream, tools, vision
claude-opus-4-20250514	chat	opus-4.0	stream, tools, vision
claude-opus-4-5-20251101	chat	opus-4.5	stream, tools, vision
claude-opus-4-6	chat	opus-4.6	stream, tools, vision
claude-opus-4-7	chat	opus-4.7	stream, tools, vision
claude-opus-4-8	chat	opus-4.8	stream, tools, vision
claude-opus-latest	chat	claude-opus, opus-latest, opus, anthropic-opus-latest	stream, tools, vision
claude-sonnet-4-20250514	chat	sonnet-4.0	stream, tools, vision
claude-sonnet-4-5-20250929	chat	sonnet-4.5	stream, tools, vision
claude-sonnet-4-6	chat	sonnet-4.6	stream, tools, vision
claude-sonnet-latest	chat	claude-sonnet, sonnet-latest, sonnet	stream, tools, vision
codestral-latest	chat	codestral	stream, tools
codex-mini-latest	chat	codex-mini	stream, tools, vision
composer-2.5	chat	cursor-composer-2.5, composer-2.5@cursor, composer-2-5, composer-2.5-standard	stream
composer-2.5-fast	chat	cursor-composer-2.5-fast, composer-2.5-fast@cursor, composer-2-5-fast	stream
deepseek-chat	chat	deepseek	stream, tools
deepseek-reasoner	chat	-	stream, tools
deepseek-v4-flash	chat	deepseek-flash, deepseek-v4	stream, tools
deepseek-v4-pro	chat	deepseek-pro, deepseek-v4-reasoning	stream, tools
devstral-medium-latest	chat	devstral-medium, devstral	stream, tools
devstral-small-latest	chat	devstral-small	stream, tools, vision
fireworks/glm-5	chat	fireworks-glm-5	stream, tools
fireworks/gpt-oss-120b	chat	gpt-oss-120b, gpt-oss	stream, tools
gemini-2.5-flash	chat	gemini-flash	stream, tools, vision
gemini-2.5-pro	chat	-	stream, tools, vision
gemini-3.1-flash-lite	chat	gemini-flash-lite, flash-lite, gemini-lite	stream, tools, vision
gemini-3.5-flash	chat	gemini-3.5, gemini-flash-frontier	stream, tools, vision
gemini-latest	chat	google-latest, google-gemini-latest	stream, tools, vision
glm-4.6v	chat	glm-vision, zai-vision	stream, tools, vision
glm-4.6v-flash	chat	glm-vision-flash	stream, tools, vision
glm-4.6v-flashx	chat	glm-vision-flashx	stream, tools, vision
glm-4.7	chat	glm4	stream, tools
glm-5	chat	glm5, glm-5-fp4	stream, tools
glm-5.1	chat	glm5.1, glm-51	stream, tools
gpt-4o	chat	-	stream, tools, vision
gpt-4o-mini	chat	-	stream, tools, vision
gpt-5-chat-latest	chat	gpt5-chat, gpt-5-chat, gpt-5.2-chat-latest	stream, tools, vision
gpt-5-codex	chat	codex-5.2, gpt5.3, gpt-5.3, codex-5.3	stream, tools, vision
gpt-5-mini	chat	gpt5-mini	stream, tools, vision
gpt-5.4	chat	gpt54, gpt-5-4, gpt-5.2	stream, tools, vision
gpt-5.4-mini	chat	gpt54-mini, gpt-5-mini-latest	stream, tools, vision
gpt-5.4-nano	chat	gpt54-nano, gpt-5-nano-latest	stream, tools, vision
gpt-5.5	chat	gpt5, gpt55, gpt-5-5, openai-latest	stream, tools, vision
grok-3-mini	chat	grok-mini	stream, tools
grok-4.20-non-reasoning	chat	grok-latest-non-reasoning, grok-non-reasoning, grok-fast	stream, tools, vision
grok-4.3	chat	grok-4, grok-reasoning, grok-4-0709, grok-4-1-fast-reasoning	stream, tools, vision
hermes-4-405b	chat	hermes-405b, nous-405b, hermes	stream, tools
hermes-4-70b	chat	hermes-70b, nous-70b	stream, tools
kimi-k2.5	chat	kimi	stream, tools
llama-3.1-8b-instant	chat	llama-8b	stream, tools
llama-3.3-70b-versatile	chat	llama-70b	stream, tools
magistral-medium-latest	chat	magistral-medium, magistral	stream, tools, vision
magistral-small-latest	chat	magistral-small	stream, tools, vision
minimax-m2	chat	-	stream, tools
minimax-m2.1	chat	-	stream, tools
minimax-m2.5	chat	minimax	stream, tools
minimax-m2.5-direct	chat	mm-m2.5	stream, tools
minimax-m2.5-highspeed	chat	mm-fast	stream, tools
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-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
mixtral-8x7b-32768	chat	mixtral	stream, tools
nvidia/deepseek-v3.2	chat	deepseek-v3.2, deepseek-3.2	stream, tools
nvidia/deepseek-v4-pro	chat	nvidia-deepseek-v4-pro, deepseek-v4-pro-free	stream, tools
nvidia/devstral-2-123b	chat	devstral-2, devstral-2-123b	stream, tools
nvidia/minimax-m2.7	chat	minimax-m2.7, mm-m2.7	stream, tools
o3	chat	-	stream, tools, vision
o4-mini	chat	-	stream, tools, vision
open-mistral-nemo	chat	mistral-nemo, nemo	stream, tools
openpaths/auto	chat	auto, auto-chat, auto-text, openpaths-auto	stream, tools, vision
openpaths/auto-cheap	chat	auto-cheap, auto-easy-task, auto-easy, openpaths-auto-cheap	stream, tools, vision
openpaths/auto-code	chat	auto-code, auto-medium-task, auto-medium, openpaths-auto-code	stream, tools, vision
openpaths/auto-fast	chat	auto-fast, openpaths-auto-fast	stream, tools, vision
openpaths/auto-reasoning	chat	auto-reasoning, auto-think, auto-think-task, autothink	stream, tools, vision