Authorization: Bearer iat_live_xxxxxxxxxxxxxxxx

curl -X POST "https://api.imageat.com/v1/images" \
  -H "Authorization: Bearer $IMAGEAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A cinematic product photograph on sculpted stone",
    "aspectRatio": "1:1",
    "resolution": "2K",
    "outputFormat": "png",
    "numImages": 1
  }'

{
  "url": "https://cdn.imageat.com/generated/image.png",
  "urls": ["https://cdn.imageat.com/generated/image.png"],
  "prompt": "A cinematic product photograph on sculpted stone",
  "generationId": "generation_01...",
  "creditsUsed": 4
}

curl -X POST "https://api.imageat.com/v1/videos"   -H "Authorization: Bearer $IMAGEAT_API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "seedance25",
    "providerVariant": "more",
    "prompt": "A paper airplane glides through a softly lit studio",
    "duration": "5s",
    "resolution": "720p",
    "aspectRatio": "adaptive",
    "generateAudio": true,
    "outputFormat": "mp4",
    "watermark": false
  }'

{
  "status": "pending",
  "taskId": "2750591",
  "generationId": "a45ooNh1FBLgv6bjy7My",
  "prompt": "A paper airplane glides through a softly lit studio"
}

curl "https://api.imageat.com/v1/videos/status?taskId=2750591&generationId=a45ooNh1FBLgv6bjy7My"   -H "Authorization: Bearer $IMAGEAT_API_KEY"

{
  "status": "completed",
  "url": "https://cdn.imageat.com/generated/video.mp4"
}

curl -X POST "https://api.imageat.com/v1/chat/completions" \
  -H "Authorization: Bearer $IMAGEAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen3.8-27b-uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise product strategist."},
      {"role": "user", "content": "Suggest three retention features for Imageat."}
    ],
    "enable_thinking": false,
    "temperature": 0.7,
    "max_tokens": 500
  }'

{
  "id": "chatcmpl_2747897",
  "object": "chat.completion",
  "model": "qwen/qwen3.8-27b-uncensored",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "..." },
    "finish_reason": "stop"
  }],
  "credits_used": 2,
  "billing": {
    "reserved_credits": 3,
    "provider_cost_usd": 0.0324,
    "elapsed_seconds": 54
  }
}

POST https://api.imageat.com/v1/workflows/wf_abc123/runs
Authorization: Bearer iat_live_...
Content-Type: application/json
Idempotency-Key: 8f3b... (optional)

{
  "nodes": [],
  "edges": [],
  "webhook": {
    "url": "https://your-app.com/webhook/imageat",
    "secret": "whsec_..."
  }
}

{
  "run_id": "run_01HX...",
  "status": "queued"
}

{
  "run_id": "run_01HX...",
  "status": "completed",
  "outputs": {
    "node_output_1": {
      "type": "image",
      "value": "https://cdn.imageat.com/runs/run_01HX.../node_output_1.png"
    }
  },
  "credits_used": 12,
  "created_at": "2026-05-22T10:01:24Z",
  "completed_at": "2026-05-22T10:01:38Z"
}

data: {"event":"node_start","node_id":"n1"}

data: {"event":"node_complete","node_id":"n1","output":{...}}

data: {"event":"run_complete","run_id":"run_01HX..."}

{ "ok": true }

https://cdn.imageat.com/runs/{run_id}/{node_id}.{ext}

POST https://your-app.com/webhook/imageat
X-Imageat-Signature: t=1716372924,v1=sha256(...)
Content-Type: application/json

{
  "event": "run_complete",
  "run_id": "run_01HX...",
  "status": "completed",
  "outputs": { ... },
  "credits_used": 12
}

# 1. Create a run
RUN=$(curl -s -X POST https://api.imageat.com/v1/workflows/wf_abc123/runs \
  -H "Authorization: Bearer $IMAGEAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nodes": [], "edges": []}' | jq -r .run_id)

# 2. Poll until complete
while true; do
  RES=$(curl -s https://api.imageat.com/v1/runs/$RUN \
    -H "Authorization: Bearer $IMAGEAT_API_KEY")
  STATUS=$(echo "$RES" | jq -r .status)
  [ "$STATUS" = "completed" ] && echo "$RES" | jq .outputs && break
  [ "$STATUS" = "failed" ] && echo "$RES" | jq . && exit 1
  sleep 2
done

const API_KEY = process.env.IMAGEAT_API_KEY!;
const BASE = "https://api.imageat.com/v1";

async function runWorkflow(workflowId: string) {
  const create = await fetch(`${BASE}/workflows/${workflowId}/runs`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ nodes: [], edges: [] }),
  });
  if (!create.ok) throw new Error(`create failed: ${create.status}`);
  const { run_id } = await create.json();

  while (true) {
    await new Promise((r) => setTimeout(r, 1500));
    const poll = await fetch(`${BASE}/runs/${run_id}`, {
      headers: { Authorization: `Bearer ${API_KEY}` },
    });
    const data = await poll.json();
    if (data.status === "completed") return data;
    if (data.status === "failed") throw new Error(data.error);
  }
}

const result = await runWorkflow("wf_abc123");
console.log(result.outputs, result.credits_used);

import os, time, requests

API_KEY = os.environ["IMAGEAT_API_KEY"]
BASE = "https://api.imageat.com/v1"
H = {"Authorization": f"Bearer {API_KEY}"}

def run_workflow(workflow_id: str) -> dict:
    r = requests.post(
        f"{BASE}/workflows/{workflow_id}/runs",
        headers={**H, "Content-Type": "application/json"},
        json={"nodes": [], "edges": []},
    )
    r.raise_for_status()
    run_id = r.json()["run_id"]

    while True:
        time.sleep(1.5)
        data = requests.get(f"{BASE}/runs/{run_id}", headers=H).json()
        if data["status"] == "completed":
            return data
        if data["status"] == "failed":
            raise RuntimeError(data.get("error", "run failed"))

result = run_workflow("wf_abc123")
print(result["outputs"], result["credits_used"])

{
  "mcpServers": {
    "imageat": {
      "command": "npx",
      "args": ["-y", "@imageat/mcp"],
      "env": {
        "IMAGEAT_API_KEY": "iat_live_xxxxxxxxxxxx"
      }
    }
  }
}

https://mcp.imageat.com/mcp