Falcon

Reference

Falcon API

Session tokens (fls_…) from signup/login, or API keys (fln_…) from POST /v1/keys. Same routes for developer integrations.

Auth

Accounts + keys

Sign up, then mint keys at /keys or via API. Send Authorization: Bearer fln_… or fls_….

Spatial

Sketch, image, or video

POST /v1/spatial accepts sketch text, or image / video (vision sketch → Waymark).

Base URL

Cloud Run

https://falcon-api-854266395503.us-central1.run.app

CORS allows https://falconlab.app.

API keys

Self-serve

POST /v1/keys 
{ "label": "my-app" }

Returns apiKey once. Also: GET /v1/keys, DELETE /v1/keys/:id. Or use the UI: Create API key.

Auth

Accounts

Sign up

POST /v1/auth/signup 
{
  "email": "you@example.com",
  "password": "at-least-8-chars",
  "name": "Alex"
}
  • POST /v1/auth/login
  • GET /v1/auth/me
  • POST /v1/auth/logout

Intention

LIM / ELIM

POST /v1/intention 
{ "text": "weather toronto", "model": "elim" }

Spatial

Waymark (+ vision)

From image

POST /v1/spatial 
{
  "image": "data:image/jpeg;base64,/9j/4AAQ…",
  "question": "which is closer to me?"
}

From video

POST /v1/spatial 
{
  "video": "data:video/mp4;base64,AAAA…",
  "mimeType": "video/mp4",
  "question": "which way is the bike moving?"
}

Also accepts raw base64 in image, image_base64, video, or video_base64 with optional mimeType (image/jpeg, video/mp4, video/webm, video/quicktime, …). Max ~6MB image / ~15MB video decoded. Response includes sketch, text, engine, and from: "image" or "video".

From sketch

POST /v1/spatial 
{
  "sketch": "foreground: red door left; bike rack right closer to ground",
  "question": "which is closer to me?"
}

Reserve

ERM

POST /v1/reserve 
{ "text": "what's the weather?" }

Usage

Quotas

GET /v1/usage — monthly counters vs plan quota.

  • playground — 300 intention · 60 spatial · 300 reserve / month
  • lab — higher limits when billing is configured