neyrocraft · API
Все системы работают в штатном режиме

API платформы neyrocraft

Программный интерфейс для доступа к нейросетевым сервисам: генерация текста, обработка изображений и голосовые модели. Один ключ — все возможности.

BASE https://api.neyrocraft.online/v1
Статус
● online
Аптайм, 30 дней
99.9%
Задержка p95
≈ 180 мс
Версия API
v1.0
01

Эндпоинты

Основные методы API v1. Авторизация — Bearer-токен в заголовке.

GET/v1/healthпроверка доступности▶

Возвращает статус сервиса и версию сборки. Не требует авторизации, не учитывается в квоте запросов.

# запрос
curl https://api.neyrocraft.online/v1/health

# ответ 200
{ "status": "ok", "version": "1.0.3", "uptime": 146022 }
POST/v1/generateгенерация текста▶

Создаёт текст по промпту. Поддерживает параметры температуры, максимальной длины и выбор модели.

# запрос
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} }
GET/v1/modelsсписок доступных моделей▶

Возвращает перечень моделей с их ограничениями по контексту и стоимостью запроса.

{ "data": [
    { "id": "nc-lite",     "context": 8192 },
    { "id": "nc-pro",      "context": 32768 },
    { "id": "nc-vision",   "context": 16384, "image_input": true }
] }
POST/v1/images/generateгенерация изображений▶

Создаёт изображение по текстовому описанию. Возвращает 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" }
02

Быстрый старт

Три шага до первого успешного запроса.

1

Получите ключ

Зарегистрируйтесь в личном кабинете и создайте API-ключ в разделе «Интеграции».

2

Проверьте связь

Отправьте GET /v1/health — если в ответе status: ok, соединение настроено верно.

3

Сделайте запрос

Вызовите /v1/generate с вашим промптом и получите ответ в формате JSON.

03

Коды ошибок

API возвращает стандартные HTTP-коды; детали — в поле error.message.

КодЗначениеЧто делать
200Успешный ответ—
401Неверный или отсутствующий ключПроверьте заголовок Authorization
429Превышен лимит запросовПодождите, повторите с экспоненциальной задержкой
500Внутренняя ошибка сервераПовторите запрос; если не уходит — напишите в поддержку
Скопировано в буфер обмена