МиксМедиаAPI · Документация
Разделы
Открыть как Markdown

POST /api/v1/jobs/createTask

Создаёт задачу генерации и сразу возвращает её номер (taskId). Цена списывается сразу и возвращается при ошибке.

Запрос

POST https://ai.aimixmedia.site/api/v1/jobs/createTask
Authorization: Bearer <API_KEY>
Content-Type: application/json

Параметры

ПолеОбязательноеОписание
modelдаID модели, например nano-banana-2 — список
inputдаПараметры модели: prompt, фото и т. д. — см. страницу модели
callBackUrlнетКуда прислать результат, когда задача завершится — callback

Необязательный заголовок Idempotency-Key защищает от дублей при повторе запроса — подробнее.

Ответ

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

Примеры

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","callBackUrl":"https://your-app.example/callback","input":{"prompt":"Постер «Лето в Москве»","aspect_ratio":"3:4"}}'

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",
      "callBackUrl": "https://your-app.example/callback",
      "input": {
        "prompt": "Постер «Лето в Москве»",
        "aspect_ratio": "3:4"
      }
    },
)
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",
    "callBackUrl": "https://your-app.example/callback",
    "input": {
      "prompt": "Постер «Лето в Москве»",
      "aspect_ratio": "3:4"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

Ошибки

codeerrorКогда
401unauthorizedНет ключа или он неверный
402insufficient_balanceНе хватает денег на балансе
422validation_errorНеверный параметр (что именно — в msg)
422unsupported_modelНет такой модели
429rate_limitedСлишком много запросов

Все коды — в разделе Ошибки и лимиты.