Braily AI API
API

Статус задачи

GET /generations/{task_id} возвращает статус и результат задачи.

После запуска генерации API возвращает task_id. Используйте его, чтобы получить текущий статус задачи и URL результата после завершения.

GET https://braily.ru/api/v1/generations/{task_id}

Пример запроса

curl "https://braily.ru/api/v1/generations/task_123" \
  -H "Authorization: Bearer $API_KEY"
const response = await fetch("https://braily.ru/api/v1/generations/task_123", {
  headers: {
    Authorization: `Bearer ${API_KEY}`,
  },
});

const task = await response.json();

Пример ответа

{
  "data": {
    "task_id": "task_123",
    "status": "COMPLETED",
    "cost": 10,
    "generated": ["https://cdn.braily.ru/generated.png"]
  }
}

Статусы

СтатусОписание
CREATEDЗадача создана и ожидает запуска.
IN_PROGRESSГенерация выполняется.
COMPLETEDГенерация завершена, generated содержит URL результата.
FAILEDЗадача завершилась ошибкой.

Polling

async function waitForTask(taskId) {
  while (true) {
    const response = await fetch(`https://braily.ru/api/v1/generations/${taskId}`, {
      headers: {
        Authorization: `Bearer ${API_KEY}`,
      },
    });

    const payload = await response.json();
    const task = payload.data;

    if (task.status === "COMPLETED" || task.status === "FAILED") {
      return task;
    }

    await new Promise((resolve) => setTimeout(resolve, 3000));
  }
}

После COMPLETED используйте URL из generated, чтобы скачать или отобразить результат.

На этой странице