НейроГейт API для разработчиков

curl

curl https://api.neuralgate.ru/v1/chat/completions \
  -H "Authorization: Bearer ng-proj-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Привет! Кратко расскажи о НейроГейт."}
    ]
  }'

Python

from neuralgate import NeuralGate

client = NeuralGate(api_key="ng-proj-...")

response = client.chat.completions.create({
    "model": "openai/gpt-4o-mini",
    "messages": [{"role": "user", "content": "Привет!"}]
})

print(response["choices"][0]["message"]["content"])

JavaScript

import { NeuralGate } from "@neuralgate/sdk";

const client = new NeuralGate({
  apiKey: "ng-proj-..."
});

const response = await client.chat.completions.create({
  model: "openai/gpt-4o-mini",
  messages: [{ role: "user", content: "Привет!" }]
});

console.log(response.choices[0].message.content);

Go

client := neuralgate.NewClient("ng-proj-...")

resp, err := client.Chat.Completions.Create(
    context.Background(),
    map[string]any{
        "model": "openai/gpt-4o-mini",
        "messages": []map[string]any{
            {"role": "user", "content": "Привет!"},
        },
    },
)

Установка

npm install @neuralgate/sdk
pip install neuralgate-sdk
go get github.com/neuralgate/neuralgate/sdk/go

Статус текущих релизов: foundation 0.1.0.

JavaScript / TypeScript

import { NeuralGate } from "@neuralgate/sdk";

const client = new NeuralGate({
  apiKey: "ng-proj-..."
});

const response = await client.chat.completions.create({
  model: "google/gemini-2.5-flash",
  messages: [
    { role: "user", content: "Привет! Кратко расскажи о НейроГейт." }
  ]
});

Python

from neuralgate import NeuralGate

client = NeuralGate(api_key="ng-proj-...")

response = client.chat.completions.create({
    "model": "google/gemini-2.5-flash",
    "messages": [
        {"role": "user", "content": "Привет! Кратко расскажи о НейроГейт."}
    ],
})

Go

client := neuralgate.NewClient("ng-proj-...")

resp, err := client.Chat.Completions.Create(
    context.Background(),
    map[string]any{
        "model": "google/gemini-2.5-flash",
        "messages": []map[string]any{
            {"role": "user", "content": "Привет!"},
        },
    },
)

Что уже включено

• chat completions
• SSE streaming helper
• models.list / count / endpoints
• TypeScript declarations для JavaScript SDK
• retry / timeout / Abort helpers
• publish-ready foundation для npm и PyPI

Управление запросами

JavaScript SDK поддерживает timeoutMs, maxRetries, retryDelayMs и AbortSignal. Python SDK — timeout, max_retries, retry_delay. Go SDK использует context.Context и client-level retry policy.

Версионирование

SDK следует SemVer: MAJOR для breaking changes, MINOR для новых возможностей, PATCH для исправлений. Текущая стартовая версия: 0.1.0.

Публикация

Для пакета уже подготовлен publish workflow под npm registry, а release notes ведутся через отдельный changelog. Это позволяет развивать SDK как официальный продуктовый артефакт, а не просто набор примеров.

Поддерживаемые сценарии

• non-stream и stream
• tools / tool_choice
• response_format / structured output
• image_url и multi-image input
• OpenRouter-compatible route/provider/models fields

Совместимость

• Базовый контракт максимально близок к OpenAI Chat Completions.
• Каталог моделей по форме ближе к OpenRouter.
• Сохраняются расширения НейроГейт, например x_neuralgate в model metadata.

Что смотреть в ответе

• id
• architecture.input_modalities
• supported_parameters
• pricing
• x_neuralgate.supports_vision
• x_neuralgate.supports_reasoning

Рекомендация

Перед multimodal-запросами всегда проверяйте, что модель действительно vision-capable. Для больших документов и OCR используйте либо vision-модель, либо fallback на извлечённый текст.

Практические рекомендации

• Для фото и больших файлов используйте HTTPS URL.
• Base64 применяйте только для маленьких вложений.
• Для документов чаще выгоднее URL + extracted text.
• Уменьшайте изображения до разумного размера до отправки.

Большие документы

{
  "model": "deepseek/deepseek-r1",
  "messages": [{
    "role": "user",
    "content": "Файл: https://storage.example.com/doc.pdf\n\nВыдержка:\n...\n\nСделай краткое резюме."
  }]
}