MixMediaAPI · Docs
Sections
Open as Markdown

Quick start

Your first image through the API in 3 steps: key → task → result.

Base URL: https://ai.aimixmedia.site/api/v1

1. Get a key

Sign in at ai.aimixmedia.site and open Dashboard → API keys. Press "Create key" and copy it. New users get $5 of credit.

export API_KEY="sk-aim-..."

2. Create a task

curl -X POST https://ai.aimixmedia.site/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-2","input":{"prompt":"A cat astronaut in a neon city"}}'

import os, requests

r = requests.post(
    "https://ai.aimixmedia.site/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "nano-banana-2",
      "input": {
        "prompt": "A cat astronaut in a neon city"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://ai.aimixmedia.site/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "nano-banana-2",
    "input": {
      "prompt": "A cat astronaut in a neon city"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

The response is the task ID:

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_nano-banana-2_1790621023886ca4e4d"
  }
}

3. Get the result

Ask for the status every 3–5 seconds until state becomes success or fail. It usually takes 1–2 minutes.

curl "https://ai.aimixmedia.site/api/v1/jobs/recordInfo?taskId=task_nano-banana-2_1790621023886ca4e4d" \
  -H "Authorization: Bearer $API_KEY"

import os, time, json, requests

API = "https://ai.aimixmedia.site/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

# 1. create a task
task = requests.post(f"{API}/jobs/createTask", headers=HEADERS, json={
    "model": "nano-banana-2",
    "input": {"prompt": "A cat astronaut in a neon city"},
}).json()
task_id = task["data"]["taskId"]

# 2. wait for the result
while True:
    info = requests.get(f"{API}/jobs/recordInfo", headers=HEADERS,
                        params={"taskId": task_id}).json()["data"]
    if info["state"] in ("success", "fail"):
        break
    time.sleep(4)

# 3. image links
if info["state"] == "success":
    print(json.loads(info["resultJson"])["resultUrls"])
else:
    print("failed:", info["failMsg"])

const API = "https://ai.aimixmedia.site/api/v1";
const headers = { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" };

// 1. create a task
const task = await fetch(`${API}/jobs/createTask`, {
  method: "POST", headers,
  body: JSON.stringify({ model: "nano-banana-2", input: { prompt: "A cat astronaut in a neon city" } }),
}).then((r) => r.json());

// 2. wait for the result
let info;
do {
  await new Promise((r) => setTimeout(r, 4000));
  info = (await fetch(`${API}/jobs/recordInfo?taskId=${task.data.taskId}`, { headers }).then((r) => r.json())).data;
} while (!["success", "fail"].includes(info.state));

// 3. image links
console.log(info.state === "success" ? JSON.parse(info.resultJson).resultUrls : info.failMsg);

Next