| 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
- Use
/api/gateway/models?provider=openai to confirm the current public model list if exact availability matters.
- 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.
- 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.
- Prefer a model matching the task modality. If unsure, start with
openpaths/auto-cheap or app/auto.
- 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 | - | - |
