/api/v1/whoami
Account + balance
One key, every endpoint
Generate, rig and export from your own code. The same routes the site runs on, the same token metering, no second path to your balance.
Needs an active plan · Pulse, Forge or Crown.
$
{
"name": "Taner",
"plan": "forge",
"tokens_remaining": 1414,
"scopes": ["*"]
}
Overview
Issue a key on your API keys page and
authenticate with Authorization: Bearer ffl_…. Everything lives under /api/v1.
Authentication
Send your API key as a Bearer token. Requires an active Pulse/Forge/Crown subscription.
curl -H "Authorization: Bearer ffl_…" https://formfromlight.com/api/v1/whoamiScopes
Keys can be limited to specific actions. Default issued keys get * (full access). Use the scoped variants in CI / production for least-privilege.
| Scope | Allows |
|---|---|
* |
All endpoints |
models:read |
GET /models, /models/{id} |
generate:image |
POST /generate/image |
generate:text |
POST /generate/text |
rig |
POST /models/{id}/rig |
Calls without the right scope return 403 with the list of granted scopes.
Endpoints
/api/v1/models?limit=25
List your recent models
/api/v1/models/{id}
Single model status + download URLs
/api/v1/generate/image
Generate from image (URL or multipart) · 2 tokens on Fast, 4 on Studio
image_url · ai_model (trellis/tripo-h31) · quality · style · title
/api/v1/generate/text
Generate from text prompt
prompt · quality · style · title
/api/v1/models/{id}/rig
Auto-rig, optionally with a baked animation · 4 tokens
animation (optional: idle/walk/run/jump/dance/wave/punch/kick)
Rate limits
120 requests/minute across all endpoints. Generation endpoints charge tokens up-front; failed generations are auto-refunded.