curl -X POST "https://api.hooked.so/v1/avatar/create/generate" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "description": "28 year old woman with curly hair in a bright kitchen, holding a coffee", "name": "Maya" }'

const headers = { "x-api-key": process.env.HOOKED_API_KEY, "Content-Type": "application/json" };
const started = await fetch("https://api.hooked.so/v1/avatar/create/generate", {
  method: "POST",
  headers,
  body: JSON.stringify({ description: "28 year old woman with curly hair in a bright kitchen, holding a coffee", name: "Maya" }),
}).then((r) => r.json());

let avatar = started.data;
while (avatar.status === "PROCESSING") {
  await new Promise((resolve) => setTimeout(resolve, 5000));
  avatar = (await fetch(`https://api.hooked.so/v1/avatar/${avatar.id}`, { headers }).then((r) => r.json())).data;
}
console.log(avatar.status, avatar.id);

import os, time
import requests

headers = {"x-api-key": os.environ["HOOKED_API_KEY"]}
avatar = requests.post(
    "https://api.hooked.so/v1/avatar/create/generate",
    headers=headers,
    json={"description": "28 year old woman with curly hair in a bright kitchen, holding a coffee", "name": "Maya"},
).json()["data"]
while avatar["status"] == "PROCESSING":
    time.sleep(5)
    avatar = requests.get(f"https://api.hooked.so/v1/avatar/{avatar['id']}", headers=headers).json()["data"]
print(avatar["status"], avatar["id"])

{
  "success": true,
  "message": "Avatar generation started",
  "data": {
    "id": "cm7a1v9t20003ab12cd34ef56",
    "name": "Maya",
    "type": "AI",
    "gender": "Female",
    "age": "Adult",
    "image": null,
    "status": "PROCESSING",
    "situation": [],
    "emotions": [],
    "skinTone": "medium",
    "isCustom": true,
    "source": "custom",
    "createdAt": "2026-10-05T09:12:44.000Z",
    "usedCredits": 4
  }
}

{
  "success": false,
  "message": "description: Required"
}