Flow Studio Developer API

Authentication & Headers

Authenticate every request using your secret API key in the Authorization header. Create or roll your key anytime from the Developer Console.

Authorization: Bearer fsk_live_your_secret_key_here
Content-Type: application/json
Idempotency-Key: optional-unique-request-id-123

Models & Per-Call Pricing (USD)

Minimum wallet deposit is $10 USD. Balance never expires while your account is active.

Live API Tester

Paste your fsk_live_... key below to test your wallet connection and inspect live JSON responses right from your browser.

// Click "GET /v1/account" or "GET /v1/models" above to test your key live.

1. Check Wallet & Concurrency

Returns your live USD balance, total spent, enabled permissions (images_enabled, video_enabled), concurrency threads, rate limits, and per-call USD pricing.

2. List Models, Aspects & Prices

Returns all supported image & video models, aspect ratios, durations, and your account's active USD rate card.

3. Generate Images

Queues 1 to 100 images in a batch, or pass "wait": true on a single-prompt call to wait synchronously (up to 75s) and receive the completed media_url in one response.

{
  "prompt": "editorial product photo of a matte black perfume bottle on wet basalt",
  "model": "nano-banana-pro",
  "aspect": "1:1",
  "resolution": "1K",
  "refs": [],
  "wait": true
}

4. Generate Videos (Veo 3.1 Lite)

Queues one or more Veo 3.1 Lite video clips. Supports Text-to-Video (t2v), Start-Frame Image-to-Video (i2v via start_ref), Reference Ingredients-to-Video (r2v via refs, up to 3 images, 8s duration), and Start & End Frame ("mode": "fl" with "frames": [start_ref, end_ref]: every clip opens on the first image and ends on the second, 4s/6s/8s).

{
  "prompts": ["slow cinematic drone shot over misty emerald mountains at sunrise"],
  "mode": "t2v",
  "aspect": "16:9",
  "duration": 8,
  "resolution": "720p"
}

5. Upload Reference Image

Upload a PNG/JPEG/WebP image via multipart/form-data (file field) or JSON ({"base64": "...", "mime": "image/png"}). Returns {"ok": true, "ref": {"id": "..."}} which can be passed in refs or start_ref.

6. Get Job Status

Poll a single job. When job.status === "done", download the generated image or MP4 video from job.media_url.

7. Upscale Completed Job (2K / 4K / 1080p)

Upscales a completed 1K/2K image to 2K or 4K, or a 720p video to 1080p. Charges only the price difference between the current resolution and target resolution.

{ "resolution": "4K" }

8. Poll & Cancel Batches

GET returns aggregate status counts (queued, running, done, failed, cancelled) and all jobs in the batch. DELETE cancels any remaining queued jobs and immediately refunds their reserved USD to your wallet.

9. Download Generated Media

Streams the generated PNG/JPEG/WebP image or MP4 video binary. Files are retained for 6 hours after completion.

Quickstart Code Examples

curl -X POST "https://api.shahzaibmalik.com/v1/images/generations" \
  -H "Authorization: Bearer fsk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "editorial product photo of a matte black perfume bottle on wet basalt",
    "model": "nano-banana-pro",
    "aspect": "1:1",
    "resolution": "1K",
    "wait": true
  }'

import requests

API_BASE = "https://api.shahzaibmalik.com/v1"
HEADERS = {"Authorization": "Bearer fsk_live_YOUR_KEY"}

r = requests.post(
    f"{API_BASE}/images/generations",
    headers=HEADERS,
    json={
        "prompt": "cinematic neon alley in Tokyo after rain, 35mm photograph",
        "model": "nano-banana-pro",
        "aspect": "16:9",
        "resolution": "2K",
        "wait": True,
    },
    timeout=90,
)
data = r.json()
job = data["jobs"][0]
if job["status"] == "done" and job["media_url"]:
    img = requests.get(job["media_url"], headers=HEADERS, timeout=60).content
    with open("output.png", "wb") as f:
        f.write(img)
    print("Saved output.png! Remaining balance: $", data["balance_usd"])

const API_BASE = "https://api.shahzaibmalik.com/v1";
const headers = {
  "Authorization": "Bearer fsk_live_YOUR_KEY",
  "Content-Type": "application/json",
};

const sub = await fetch(`${API_BASE}/videos/generations`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    prompts: ["aerial drone shot over turquoise ocean waves crashing on black sand"],
    mode: "t2v",
    aspect: "16:9",
    duration: 8,
    resolution: "720p",
  }),
}).then(r => r.json());

const jobId = sub.jobs[0].id;
while (true) {
  await new Promise(r => setTimeout(r, 4000));
  const { job } = await fetch(`${API_BASE}/jobs/${jobId}`, { headers }).then(r => r.json());
  if (job.status === "done") {
    console.log("Video ready:", job.media_url);
    break;
  }
  if (job.status === "failed" || job.status === "cancelled") {
    throw new Error(job.error || job.status);
  }
}