appnz-provider-fal

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

fal.ai on app.nz

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

Workflow

1. Use /api/gateway/models?provider=fal 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 provider-native job API 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 fal 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 klein 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":"fal","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":"klein","messages":[{"role":"user","content":"Give me one practical idea."}]}'

Models

Model	Modality	Aliases	Caps
alibaba/happy-horse/image-to-video	video	happy-horse, happy-horse-image-to-video, alibaba-happy-horse	vision
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-pro	image	flux-1.1-pro, fal-flux-pro	-
flux-schnell	image	flux-1-schnell, fal-flux-schnell	-
hidream-o1-image-dev	image	hidream-o1, hidream-image, hidream-dev, fal-hidream-o1-image-dev	vision
klein	image	flux-klein, klein-4b	-
ltx-2.3-image-to-video	video	ltx-2.3, ltx2.3, ltx23, ltx-23	vision
meshy-rigging	3d	rigging, auto-rig, mesh-rigging, 3d-to-3d-rigging	-
meshy-v6-image-to-3d	3d	meshy-v6, meshy-image-to-3d, meshy, fal-meshy-v6-image-to-3d	vision
pixal3d-image-to-3d	3d	pixal3d, image-to-3d, fal-pixal3d	vision
seedance-2.0-fast-reference-to-video	video	seedance-fast-reference, seedance-reference-fast	vision
seedance-2.0-fast-text-to-video	video	seedance-fast, seedance-2-fast, seedance-text-video-fast	-
seedance-2.0-image-to-video	video	seedance-image-to-video, seedance-i2v, seedance-2-i2v	vision
seedance-2.0-reference-to-video	video	seedance-reference, seedance-ref	vision
seedance-2.0-text-to-video	video	seedance, seedance-2, seedance-text-video	-
smart-resize	image	fal-smart-resize, image-smart-resize	vision
trellis-2-retexture	3d	retexture, trellis-retexture, trellis-2, fal-trellis-2-retexture	vision
tripo-p1-image-to-3d	3d	tripo, tripo-p1, tripo-image-to-3d, fal-tripo-p1-image-to-3d	vision