Models

Figgshield runs a small, curated catalogue: Nano Banana 2 for images, and Kling 3, Kling 3 Turbo and Seedance 2 for video. All are hosted through fal and reachable the same way — through Claude, the Claude Code CLI, or the REST API — against one credit balance. In Claude you rarely name a model; you ask for a video or an image and Figgshield routes to a sensible default.

List models

GET /api/models/ — public, no authentication required.

curl https://api.figgshield.ai/api/models/

Returns the standard list envelope. Each item carries its params_schema (the options it accepts) and a pricing array (the credit cost of each option combination):

{
  "uuid": "28176a3a-a0d4-4ca2-bcba-259095b472a1",
  "slug": "nano-banana-2",
  "name": "Nano Banana 2",
  "provider": "fal",
  "kind": "image",
  "description": "Crisp images with excellent text rendering. Priced by resolution.",
  "credits_base": 11,
  "status": "online",
  "sort_order": 10,
  "params_schema": { "resolutions": ["1K", "2K", "4K"] },
  "pricing": [
    { "params": { "resolution": "1K" }, "credits": 7 },
    { "params": { "resolution": "2K" }, "credits": 11 },
    { "params": { "resolution": "4K" }, "credits": 21 }
  ]
}

The credit numbers above are illustrative. Read them live from this endpoint, the get_model_pricing tool, or the pricing page rather than hardcoding them — they change as models and providers change.

Fields

Field	Type	Meaning
slug	string	Stable identifier — e.g. nano-banana-2, kling-3. Pass as model when creating a generation over REST.
name	string	Display name (Nano Banana 2, Kling 3, …).
provider	string	Hosting provider — fal for the launch catalogue. Informational.
kind	string	video or image — determines which params apply.
description	string	One-line description.
credits_base	integer	The model’s base (lowest-option) credit cost. Full per-option costs are in pricing.
status	string	online, degraded or offline from live health checks.
sort_order	integer	Suggested display order.
params_schema	object	The values this model accepts (resolutions, durations, whether audio is supported).
pricing	array	One { params, credits } row per billing-relevant option combination.

The catalogue

Nano Banana 2 — image

Slug	nano-banana-2
Resolutions	1K, 2K, 4K
Priced by	resolution

Kling 3 — video

Slug	kling-3
Resolutions	720p, 1080p, 4k
Durations	5 or 10 seconds
Audio	Optional
Priced by	resolution × duration × audio

Kling 3 Turbo — video

Slug	kling-3-turbo
Resolutions	1080p
Durations	5 or 10 seconds
Priced by	duration

Seedance 2 — video

Slug	seedance-2
Resolutions	480p, 720p, 1080p
Durations	5 or 10 seconds
Priced by	resolution × duration

Credit costs

Costs are per option, not a single fixed number per model. Each model’s pricing array lists the exact credit cost of every option combination: images are priced by resolution, and video scales with resolution, duration (a 10-second clip costs more than a 5-second one) and audio where the model supports it.

Because the numbers move as models and providers change, don’t hardcode them. Read them live from:

• GET /api/models/ — the pricing array on each model,
• the get_model_pricing MCP tool — the same per-option pricing plus an availability status, or
• the pricing page — a rendered table of every model and option.

What a credit costs in money depends on your plan — see Billing & top-ups.

Status semantics

The status field on GET /api/models/ reports live provider health:

Status	Meaning	What to do
online	Healthy; generations run normally.	Use freely.
degraded	The provider is up but slow or intermittently failing (failures are auto-refunded).	Expect longer waits; retry if needed.
offline	The provider is down. Creating a generation returns 503 model_unavailable.	Retry later.

Separately, the get_model_pricing tool reports an availability status of available or coming_soon; a coming_soon model is listed with its prices but cannot yet be generated.