WOWFLOW API

Programmatic access to every AI image & video model. Same balance as your WOWFLOW account. Bearer-token auth, JSON in / JSON out, no SDK required.

1. Authentication

All endpoints require an API key in the Authorization header:

Authorization: Bearer wf_live_...

Generate keys in Settings → API Access. Each account can have up to 10 active keys. The secret value is shown only once at creation time — store it somewhere safe.

2. Base URL

https://wowflow.space/api/v1

3. List available models

curl https://wowflow.space/api/v1/models \
  -H "Authorization: Bearer $WOWFLOW_KEY"

import os, requests

r = requests.get(
    "https://wowflow.space/api/v1/models",
    headers={"Authorization": f"Bearer {os.environ['WOWFLOW_KEY']}"},
)
print(r.json())

const r = await fetch("https://wowflow.space/api/v1/models", {
  headers: { Authorization: `Bearer ${process.env.WOWFLOW_KEY}` },
});
console.log(await r.json());

Response:

{
  "data": [
    {
      "id":           "nano-banana-pro-1k",
      "name":         "Nano Banana Pro 1K",
      "type":         "image",
      "price_cents":  11,
      "price_usd":    0.11,
      "resolution":   "1K",
      "duration_sec": null
    },
    ...
  ]
}

4. Create a generation

Body:

4.1 Model parameters

Everything in this section goes in input (or at the top level — they are merged). Parameters that set the price are pinned by the model id and are ignored if you send them: quality, resolution, duration, sound, mode. Choose the tier by choosing the model id, not by sending a parameter.

curl -X POST https://wowflow.space/api/v1/generations \
  -H "Authorization: Bearer $WOWFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":  "nano-banana-pro-1k",
    "prompt": "a misty forest at dawn, soft light, cinematic"
  }'

import os, requests

r = requests.post(
    "https://wowflow.space/api/v1/generations",
    headers={
        "Authorization": f"Bearer {os.environ['WOWFLOW_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model":  "nano-banana-pro-1k",
        "prompt": "a misty forest at dawn, soft light, cinematic",
    },
)
gen = r.json()
print(gen["id"], gen["status"])

const r = await fetch("https://wowflow.space/api/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WOWFLOW_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model:  "nano-banana-pro-1k",
    prompt: "a misty forest at dawn, soft light, cinematic",
  }),
});
const gen = await r.json();
console.log(gen.id, gen.status);

Response (201):

{
  "id":         "8c2e90b1-...",
  "status":     "processing",
  "model":      "nano-banana-pro-1k",
  "cost_cents": 11,
  "cost_usd":   0.11,
  "created_at": "2026-05-08T14:23:11.000Z"
}

5. Poll for the result

Poll every 2–5 seconds until status is completed or failed. Webhooks are coming in v2.

curl "https://wowflow.space/api/v1/generations?id=$ID" \
  -H "Authorization: Bearer $WOWFLOW_KEY"

import time, os, requests

def wait_for(gen_id, timeout=300):
    headers = {"Authorization": f"Bearer {os.environ['WOWFLOW_KEY']}"}
    deadline = time.time() + timeout
    while time.time() < deadline:
        r = requests.get(
            f"https://wowflow.space/api/v1/generations?id={gen_id}",
            headers=headers,
        ).json()
        if r["status"] == "completed":
            return r["result_url"]
        if r["status"] == "failed":
            raise Exception(r.get("error") or "failed")
        time.sleep(3)
    raise TimeoutError("Generation timed out")

async function waitFor(id, timeoutMs = 300_000) {
  const headers = { Authorization: `Bearer ${process.env.WOWFLOW_KEY}` };
  const deadline = Date.now() + timeoutMs;
  while (Date.now() < deadline) {
    const r = await fetch(
      `https://wowflow.space/api/v1/generations?id=${id}`,
      { headers }
    ).then(x => x.json());
    if (r.status === "completed") return r.result_url;
    if (r.status === "failed")    throw new Error(r.error || "failed");
    await new Promise(r => setTimeout(r, 3000));
  }
  throw new Error("Generation timed out");
}

Response when ready:

{
  "id":           "8c2e90b1-...",
  "status":       "completed",
  "model":        "nano-banana-pro-1k",
  "result_url":   "https://.../result.png",
  "cost_cents":   11,
  "cost_usd":     0.11,
  "created_at":   "2026-05-08T14:23:11.000Z",
  "completed_at": "2026-05-08T14:23:32.000Z"
}

6. List recent generations

Omit id to list your account's most recent generations (up to 200).

7. Check balance

{
  "balance_cents":     1234,
  "balance_usd":       12.34,
  "total_topup_cents": 5000,
  "total_spent_cents": 3766,
  "currency":          "USD"
}

8. Transaction history

Returns recent spend + top-up transactions, ordered newest-first.

9. Errors

All errors follow this shape:

{ "error": { "code": "insufficient_balance", "message": "..." } }

10. Versioning & stability

This is v1. Breaking changes will be released under a new path (/api/v2/...). Additive changes — new models, new fields — may happen at any time on v1.

11. Roadmap

• Webhooks — fire-and-forget result delivery (v2)
• Variants — request N images in one call
• Permanent result URLs — mirror every provider result to our own storage, so result_url never expires
• Streaming for long video generations

Questions? Ping @fukfaku on Telegram.