01 · Image
Text-to-image
POST /v1/images/generations settles per image inline. krea-2 maps to FLUX.1 Krea on fal.
Capability · Generation
Generate images, video and talking avatars.
Text-to-image, text/image-to-video and audio-driven talking avatars for general (non-PHI) content — paid on fal.ai.
POST /v1/images/generations · /v1/videos/generations
What you get
Built for regulated workloads
Generation is general-content only — there is no PHI generation provider, so an X-PHI:true request returns phi_blocked. Requests route to fal.ai. Images settle synchronously; video is async — enqueue, then poll /v1/videos/{id}.
02 · Video
Async video
Text/image→video generates asynchronously: enqueue at /v1/videos/generations, then poll /v1/videos/{id}. Pick the tier with quality — standard (wan, Krea-Wan 14B) or premium (seedance, Seedance 2.0). The job id embeds the model so the poll re-resolves it exactly. Paid video bills once, on first completion.
03 · Avatar
Talking avatars
avatar takes a portrait image plus audio and returns a lip-synced video (InfiniTalk on fal). Sending audio to /v1/videos biases routing to the avatar canonical.
04 · Privacy
Private re-hosting
By default fal stores I/O and serves public URLs; the adapter disables upstream retention (X-Fal-Store-IO:0). Enable the optional R2 re-host to serve outputs from short-lived signed /v1/media URLs instead.
Availability & pricing
Where it runs, what it costs
Every route is pinned to a region, PHI stays on resident hosts, and the PHI gate is enforced per call. Prices mirror the live /v1/pricing rate card.
| Region | Provider | Model | Tier | Price |
|---|---|---|---|---|
| All | fal.ai | krea-2 (FLUX.1 Krea) · image | General | $0.01 / image |
| All | fal.ai | wan (Krea-Wan 14B) · video · standard | General | $0.04 / sec |
| All | fal.ai | seedance (Seedance 2.0) · video · premium | General | $0.51 / sec |
| All | fal.ai | avatar (InfiniTalk) · video | General | $0.33 / sec |
| Any | — | generation (PHI) | No route | phi_blocked |
Generation runs on fal.ai. Generation is general/non-PHI only — X-PHI:true returns phi_blocked.
Try it
A real call, end to end
Generate an image on the paid tier. Video follows the same shape but returns a job id to poll.
How generation routes
- Requests route to fal.ai; generation is a paid, prepaid-credits capability.
- Images are synchronous; video is async (poll /v1/videos/{id}), keeping the proxy stateless.
- Paid video bills once on first completed poll (idempotent via a one-time claim).
- No PHI: there is no PHI generation provider, so X-PHI:true is refused.
Good to know
- · fal model ids and hosts are env-overridable (FAL_IMAGE_MODEL / FAL_VIDEO_MODEL / FAL_VIDEO_PREMIUM_MODEL / FAL_AVATAR_MODEL).
- · Premium video (Seedance 2.0) renders at up to 720p with native audio and takes duration (4–15s), resolution and aspect_ratio; billing is flat per generated second at the 720p rate.
- · R2 re-hosting is optional and binding-gated; when off, the gateway passes the upstream URL through.
curl
curl https://cloudsitus.com/api/v1/images/generations \
-H "Authorization: Bearer $PHI_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "model": "krea-2", "prompt": "a calm clinic waiting room, soft light" }'response
x-phi-tier: non_phi
x-phi-cost-micro: 33000
{ "data": [{ "url": "https://cloudsitus.com/api/v1/media/..." }] }Can I generate images or video on PHI?
No. No generation provider is PHI-eligible, so any X-PHI:true generation request returns phi_blocked. Generation is for general / marketing content only.
Why is video asynchronous?
Render time and output duration are unknown until the job finishes. Enqueuing at /v1/videos/generations and polling /v1/videos/{id} keeps CloudSitus stateless — the job state lives upstream — and lets paid video bill once, on first completion.
How do I keep generated assets private?
The adapter already disables fal’s upstream retention. For confidential content, enable the R2 re-host: outputs are copied to your own bucket and served from short-lived signed /v1/media URLs instead of public fal URLs.
Ready when you are
Put image & video in production — without giving up your data.
Spin up a key in minutes. The residency and PHI posture above arrives unchanged.
Prepaid credits from $10 · No subscription · No data retained