Перейти к основному содержанию

​
Способы аутентификации

Все публичные интерфейсы по умолчанию используют Bearer Token: 
Authorization: Bearer YOUR_API_KEY
Базовый адрес: 
https://api.aiid.edu.kg
Хотя у некоторых нативных форматов или специализированных для модели интерфейсов пути отличаются, они по-прежнему используют ту же схему аутентификации по API Key.

​
Структура ошибок

При поиске причин неудачных запросов в первую очередь обращайте внимание на:
  • Код состояния HTTP
  • error.code
  • error.message
Типичная структура: 
{
  "error": {
    "code": "invalid_request_error",
    "message": "the reason why error occurred"
  }
}

​
Распространенные коды состояния

HTTPЗначениеРекомендация
400Ошибка параметров запросаПроверьте обязательные поля, имя модели и параметры пути
401Ошибка аутентификацииПроверьте, действителен ли API Key
404Путь или задача не существуютПроверьте путь запроса и ID задачи
429Превышен лимит запросовСнизьте частоту или повторите попытку
500Внутренняя ошибка сервераЗафиксируйте запрос и повторите попытку или обратитесь в поддержку

​
Общие перечисления состояний

Распространенные роли (Enum):
  • system
  • user
  • assistant
Распространенные статусы длительных задач:
  • queued
  • running
  • succeeded
  • failed
  • in_progress
  • completed
Поля статуса, возвращаемые различными видео-интерфейсами, могут немного отличаться, но их семантика всегда связана с состояниями «В очереди / В процессе / Завершено / Ошибка».

​
Запрос асинхронных задач

Текущая публичная документация ориентирована на «активный запрос результатов задачи». Распространенные методы включают:
  • GET /v1/videos/{task_id}
  • GET /v1/responses/{response_id}
  • GET /api/v3/contents/generations/tasks/{task_id}
  • GET /suno/fetch/{task_id}
  • GET /ent/v2/tasks/{task_id}/creations
  • GET /v1beta/{operation_name}
Рекомендации по интеграции:
  • Используйте механизмы повторов и экспоненциальной задержки при запросе задач
  • Обеспечьте персистентное хранение task_id или operation_name
  • Запрос результатов как резервный механизм (fallback) для проверки статуса асинхронных задач