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

GET /api/v1/jobs/recordInfo

Статус задачи и результат. Спрашивайте раз в 3–5 секунд, пока state не станет success или fail.

Запрос

GET https://ai.aimixmedia.site/api/v1/jobs/recordInfo?taskId=<taskId>
Authorization: Bearer <API_KEY>

Параметры

ПараметрОбязательныйОписание
taskIdдаНомер задачи из createTask

Ответ

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_nano-banana-2_1790621023886ca4e4d",
    "model": "nano-banana-2",
    "state": "success",
    "param": "{\"model\":\"nano-banana-2\",\"callBackUrl\":\"\",\"input\":{\"prompt\":\"...\"}}",
    "resultJson": "{\"resultUrls\":[\"https://ai.aimixmedia.site/files/7496aef5292507f51b84cb2cb258d001.png\"]}",
    "failCode": "",
    "failMsg": "",
    "costTime": 104016,
    "completeTime": 1790621127902,
    "createTime": 1790621023886,
    "updateTime": 1790621127902,
    "progress": 100,
    "creditsConsumed": 0.02,
    "costUsd": "0.0200",
    "refunded": false,
    "filesExpired": false,
    "callback": null
  }
}
ПолеЧто это
stateСтатус — см. таблицу ниже
resultJsonПри success — строка JSON с resultUrls (ссылки на файлы, хранятся 30 дней)
failCode, failMsgКод и текст ошибки при fail
creditsConsumedСколько списано, USD (0 после возврата)
refundedtrue — деньги вернули (задача не удалась)
callbackСтатус доставки callback, если был callBackUrl
costTime, createTime, completeTimeВремя выполнения и отметки времени, мс

Статусы

stateЧто значит
waitingПринята, ждёт очереди
queuingПередана модели
generatingГенерируется
successГотово ✓
failОшибка, деньги возвращены

Если задача не завершилась за 20 минут, она становится fail.

Примеры

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

r = requests.get(
    "https://ai.aimixmedia.site/api/v1/jobs/recordInfo",
    params={"taskId": "task_nano-banana-2_1790621023886ca4e4d"},
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
print(r.json())  # data.state, data.resultJson
const r = await fetch("https://ai.aimixmedia.site/api/v1/jobs/recordInfo?taskId=task_nano-banana-2_1790621023886ca4e4d", {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
console.log(await r.json()); // data.state, data.resultJson

Ошибки

codeerrorКогда
401unauthorizedНет ключа или он неверный
404task_not_foundНет такой задачи в вашем аккаунте
422validation_errorНе передан taskId