Skip to content
FIGGSHIELD

Models

The two live models — Kling for video and Nano Banana 2 for images — with their parameters, live status semantics and per-generation credit costs.

View as Markdown

Figgshield runs two models: Kling for video and Nano Banana 2 for images. Both are reachable the same way — through Claude, the Claude Code CLI, or the REST API — and draw on the same credit balance. In Claude you rarely name a model; you ask for a video or an image and Figgshield routes to the right one.

List models

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

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

Returns the standard list envelope. Each item:

{
  "uuid": "3c2b1a09-8f7e-4d6c-5b4a-392817065e4d",
  "slug": "kling-video",
  "name": "Kling",
  "provider": "fal",
  "kind": "video",
  "description": "Cinematic motion in 5 or 10-second clips, with optional audio.",
  "credits_base": 35,
  "status": "online",
  "sort_order": 10,
  "params_schema": {
    "durations": [5, 10],
    "resolutions": ["720p", "1080p"],
    "audio": true,
    "aspect_ratios": ["16:9", "9:16"]
  }
}

Fields

FieldTypeMeaning
slugstringStable identifier — kling-video or nano-banana-2. Pass as model when creating a generation over REST.
namestringDisplay name (Kling, Nano Banana 2).
providerstringHosting provider (fal for Kling, google for Nano Banana 2). Informational.
kindstringvideo or image — determines which params apply.
descriptionstringOne-line description.
credits_baseintegerBase credits per generation (35 for Kling, 8 for Nano Banana 2). Duration and audio can multiply it — see below.
statusstringonline, degraded or offline from live health checks.
sort_orderintegerSuggested display order.
params_schemaobjectThe values this model accepts.

The two models

Kling — video

Slugkling-video
Durations5 or 10 seconds
Resolutions720p, 1080p
AudioOptional, default off (doubles the credit cost)
Base cost35 credits

Nano Banana 2 — image

Slugnano-banana-2
Resolutions1K, 2K, 4K
Base cost8 credits

Credit costs

Costs are fixed per generation; credits_base is the authoritative base. For Kling, a 10-second clip and audio each double the cost:

GenerationKindCredits
Nano Banana 2 image (1K / 2K / 4K)image8
Kling — 5-second clip (720p / 1080p)video35
Kling — 5-second clip with audiovideo70
Kling — 10-second clipvideo70

The same credits work across both models; there are no per-model plans or multipliers beyond duration and audio. What a credit costs in money depends on your plan — see Billing & top-ups.

Status semantics

StatusMeaningWhat to do
onlineHealthy; generations run normally.Use freely.
degradedThe provider is up but slow or intermittently failing (failures are auto-refunded).Expect longer waits; retry if needed.
offlineThe provider is down. Creating a generation returns 503 model_unavailable.Retry later.