appnz-provider-openai

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

OpenAI on app.nz

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

Workflow

1. Use /api/gateway/models?provider=openai 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.openai.com 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 openai 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 openpaths/auto-cheap 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":"openai","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":"openpaths/auto-cheap","messages":[{"role":"user","content":"Give me one practical idea."}]}'

Models

Model	Modality	Aliases	Caps
codex-mini-latest	chat	codex-mini	stream, tools, vision
dall-e-3	image	dalle-3, dalle	-
gpt-4o	chat	-	stream, tools, vision
gpt-4o-mini	chat	-	stream, tools, vision
gpt-4o-mini-transcribe	transcription	openai-transcribe-mini	-
gpt-4o-transcribe	transcription	openai-transcribe	-
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
gpt-image-1	image	openai-image-1	-
gpt-image-1-mini	image	openai-image-mini	-
gpt-image-1.5	image	openai-image-1.5	-
gpt-image-2	image	openai-image-latest, openai-image	-
o3	chat	-	stream, tools, vision
o4-mini	chat	-	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-image	image	auto-image, auto-img, openpaths-auto-image	-
openpaths/auto-reasoning	chat	auto-reasoning, auto-think, auto-think-task, autothink	stream, tools, vision
sora-2	video	sora, openai-video	-
sora-2-pro	video	sora-pro, openai-video-pro	-
whisper-1	transcription	-	-