| name | appnz-images-api |
| description | Use this skill for app.nz image generation and image editing via /v1/images/generations, including OpenAI image models, fal image models, xAI images, Netwrck art, CuteDSL, Z.ai image, and app/auto-image. |
app.nz Images API
Use POST /v1/images/generations on app.nz. Authenticate with an app.nz bearer key unless the endpoint is explicitly public.
Workflow
- Choose
app/auto or a modality-specific auto model when possible.
- For exact provider routing, call
GET /api/gateway/resolve?model=MODEL.
- For provider-owned billing, store BYOK first with
/api/gateway/provider-keys.
- Run the request and inspect
X-Gateway-Provider and X-Gateway-Model for routed upstream details.
- Check
/api/usage when the user asks about spend.
Example
curl -sX POST https://app.nz/v1/images/generations \
-H "Authorization: Bearer pk_live_..." \
-H "Content-Type: application/json" \
-d '{"model":"app/auto-image","prompt":"A clean product mockup on a white desk","size":"1024x1024","n":1}'
Relevant Models
| Model | Modality | Aliases | Caps |
|---|
| cutedsl-image | image | cutedsl-zimage, cute-image, z-image-turbo | - |
| dall-e-3 | image | dalle-3, dalle | - |
| extend-image | image | image-extend, extend-canvas, magic-extend, outpaint-v2 | vision |
| fal-ai/flux-2-pro/outpaint | image | flux-2-pro-outpaint, flux-outpaint, outpaint, fal-outpaint | vision |
| fal-ai/hidream-o1-image/edit | image | hidream-o1-image-edit, hidream-edit, fal-hidream-o1-image-edit, image-edit | vision |
| fal-gpt-image-2 | image | fal-openai-image, fal-gpt-image | - |
| flux-dev | image | flux-1-dev, fal-flux-dev | - |
| flux-dev | image | - | - |
| flux-pro | image | flux-1.1-pro, fal-flux-pro | - |
| flux-pro | image | - | - |
| flux-schnell | image | flux-1-schnell, fal-flux-schnell | - |
| flux-schnell | image | flux-fast | - |
| glm-image | image | zai-image | - |
| 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 | - |
| grok-imagine-image | image | grok-image, xai-image, grok-imagine-image-pro | vision |
| grok-imagine-image-quality | image | grok-image-quality, xai-image-quality | vision |
| hidream-o1-image-dev | image | hidream-o1, hidream-image, hidream-dev, fal-hidream-o1-image-dev | vision |
| klein | image | flux-klein, klein-4b | - |
| openpaths/auto-image | image | auto-image, auto-img, openpaths-auto-image | - |
| ra1 | image | netwrck-image, netwrck-art | - |
| smart-resize | image | fal-smart-resize, image-smart-resize | vision |
| stable-diffusion-3 | image | sd3 | - |
| zimage | image | netwrck-anime, anime-image | - |
