Программный интерфейс для доступа к нейросетевым сервисам: генерация текста, обработка изображений и голосовые модели. Один ключ — все возможности.
Основные методы API v1. Авторизация — Bearer-токен в заголовке.
Возвращает статус сервиса и версию сборки. Не требует авторизации, не учитывается в квоте запросов.
# запрос curl https://api.neyrocraft.online/v1/health # ответ 200 { "status": "ok", "version": "1.0.3", "uptime": 146022 }
Создаёт текст по промпту. Поддерживает параметры температуры, максимальной длины и выбор модели.
# запрос curl -X POST https://api.neyrocraft.online/v1/generate \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "Расскажи короткую шутку про программиста", "max_tokens": 200, "temperature": 0.8}' # ответ 200 { "id": "gen_9f2a", "text": "…", "usage": {"total_tokens": 132} }
Возвращает перечень моделей с их ограничениями по контексту и стоимостью запроса.
{ "data": [
{ "id": "nc-lite", "context": 8192 },
{ "id": "nc-pro", "context": 32768 },
{ "id": "nc-vision", "context": 16384, "image_input": true }
] }
Создаёт изображение по текстовому описанию. Возвращает URL результата, живущий 24 часа.
curl -X POST https://api.neyrocraft.online/v1/images/generate \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{"prompt": "космический кит в туманности", "size": "1024x1024"}' # ответ 200 { "id": "img_41c7", "url": "https://cdn.neyrocraft.online/img/41c7.png" }
Три шага до первого успешного запроса.
Зарегистрируйтесь в личном кабинете и создайте API-ключ в разделе «Интеграции».
Отправьте GET /v1/health — если в ответе status: ok, соединение настроено верно.
Вызовите /v1/generate с вашим промптом и получите ответ в формате JSON.
API возвращает стандартные HTTP-коды; детали — в поле error.message.
| Код | Значение | Что делать |
|---|---|---|
200 | Успешный ответ | — |
401 | Неверный или отсутствующий ключ | Проверьте заголовок Authorization |
429 | Превышен лимит запросов | Подождите, повторите с экспоненциальной задержкой |
500 | Внутренняя ошибка сервера | Повторите запрос; если не уходит — напишите в поддержку |