Начните создавать с Neiroport

Первый вызов через SDK

Примеры используют модель из актуального каталога. Замените её на нужный доступный вариант.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.NEIROPORT_API_KEY,
  baseURL: "https://neiroport.com/v1"
});

const response = await client.chat.completions.create({
  model: "qwen3.6-27b",
  messages: [{ role: "user", content: "Hello!" }],
  max_tokens: 1024
});

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

Три формата API

Выбирайте формат запроса по возможностям модели. Для всех поддерживаемых протоколов используются ваш ключ Neiroport и адрес API сервиса.

curl https://neiroport.com/v1/messages \
  -H "x-api-key: $NEIROPORT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "claude-fable-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello!"
    }
  ]
}'

curl "https://neiroport.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $NEIROPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Hello!"
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 1024
  }
}'

Каталог и варианты моделей

Каталог обновляется автоматически. Идентификаторы и суффиксы сохраняются полностью: разные варианты имеют отдельные модели и тарифы. Маршрут определяется выбранными предпочтениями.

curl https://neiroport.com/v1/models \
  -H "Authorization: Bearer $NEIROPORT_API_KEY"

Предпочтения маршрутизации

В разделе «Поставщики моделей» сравните предложения и закрепите поставщика отдельно для каждой модели и клиентского ключа. Показанные цены уже включают наценку. Закрепление имеет приоритет над автоматическим выбором и действует в SDK без дополнительных параметров.

Для закреплённых маршрутов переход к другому поставщику отключён. При изменении тарифа или недоступности поставщика запрос отклоняется до отправки; выберите поставщика повторно либо включите автовыбор. В песочнице выберите тот же клиентский ключ, чтобы проверить его маршрут.

При создании API-ключа выберите режим; его можно изменить позже без замены ключа. Все запросы этого ключа используют выбранные предпочтения. В песочнице режим выбирается отдельно.

Стоимость и доступность могут отличаться между режимами. Каталог показывает тариф выбранного режима. Общая и индивидуальная наценка применяются ко всем режимам; неподтверждённый тариф не используется для генерации. В режиме «Только с гарантией» используются исключительно гарантированные маршруты.

В карточке модели указаны форматы API, тип оплаты, вход, выход, чтение и запись кеша либо стоимость запроса. Справочные цены до подтверждения не являются действующим тарифом.

Справочник эндпоинтов

Для относительных путей используется Base URL /v1. Путь Gemini /v1beta начинается от корня сервиса. Методы с отметкой «Недоступно» пока не подключены в Neiroport.

curl https://neiroport.com/v1/responses \
  -H "Authorization: Bearer $NEIROPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen3.6-27b",
  "input": "Hello!",
  "max_output_tokens": 1024,
  "store": false
}'

curl https://neiroport.com/v1/embeddings \
  -H "Authorization: Bearer $NEIROPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gemini-embedding-2-preview",
  "input": "Text to embed"
}'

curl https://neiroport.com/v1/images/generations \
  -H "Authorization: Bearer $NEIROPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google-imagen-4",
  "prompt": "A quiet mountain lake",
  "n": 1,
  "size": "1024x1024"
}'

Справочник ошибок

Ищите по error.code и request_id. Ошибки API и расширенный справочник совместимости доступны отдельно. Внутренние данные маршрутизации не передаются клиенту.

{
  "error": {
    "code": "model_not_found",
    "message": "model_not_found"
  },
  "request_id": "http_xxxxxxxxxxxx"
}

Учёт расхода и потоковые ответы

stream = client.chat.completions.create(
    model="qwen3.6-27b",
    messages=[{"role": "user", "content": "Hello!"}],
    max_tokens=1024,
    stream=True,
    stream_options={"include_usage": True}
)

for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="")
    if chunk.usage:
        print("\nUsage:", chunk.usage)

Для платных POST-запросов передавайте уникальный Idempotency-Key. Повтор с тем же ключом возвращает 409 и request_id исходного запроса. При обрыве потока проверьте историю до повторной отправки.