PNCДокументация

API PNC

Один ключ — доступ к GPT, Claude и DeepSeek. Оплата в рублях с баланса, только за израсходованные токены. API совместимо с OpenAI: в любой библиотеке достаточно поменять адрес и ключ.

Адресhttps://ai.pulsey.ru/v1
ФорматOpenAI Chat Completions
Ключpnc-sk-…

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

  1. Войдите на ai.pulsey.ru через аккаунт Pulsey — QR-кодом или кодом на почту.
  2. Пополните баланс и откройте API → API-ключи → Создать ключ. Ключ показывается целиком один раз — сохраните его.
  3. Отправьте запрос:
from openai import OpenAI

client = OpenAI(
    base_url="https://ai.pulsey.ru/v1",
    api_key="pnc-sk-...",
)

reply = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://ai.pulsey.ru/v1",
  apiKey: "pnc-sk-...",
});

const reply = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [{ role: "user", content: "Привет!" }],
});
console.log(reply.choices[0].message.content);
curl https://ai.pulsey.ru/v1/chat/completions \
  -H "Authorization: Bearer pnc-sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Ключи и авторизация

Каждый запрос передаёт ключ в заголовке:

Authorization: Bearer pnc-sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • Ключ даёт доступ к балансу аккаунта — храните его как пароль, не кладите в код фронтенда и в публичные репозитории.
  • У нас хранится только отпечаток ключа: потерянный ключ не восстановить — отзовите его и создайте новый.
  • До 20 активных ключей на аккаунт. По каждому видно, сколько он потратил и когда использовался.

Модели

Актуальный список — GET /v1/models (без ключа). Цены — в рублях за 1 млн токенов.

ID моделиВходВыходКэш: чтение / записьКонтекст / ОтветЗрение
openai/gpt-5.6-lunaGPT-5.6 Luna · OpenAI5 ₽5 ₽0,1 / 1 ₽1.1M / 128K✓
claude-haiku-5.5Claude Haiku 5.5 · Anthropic5 ₽10 ₽0,1 / 1 ₽1M / 128K✓
deepseek-v4.1-flashDeepSeek V4.1 Flash · DeepSeek5 ₽10 ₽0,2 / 2 ₽1M / 393.2K✓

Chat Completions

POST /v1/chat/completions

ПараметрТипОписание
model обязателенstringID модели из таблицы выше.
messages обязателенarrayРеплики {"role": "system" | "user" | "assistant" | "tool", "content": …}.
streambooleanОтдавать ответ по кусочкам (SSE). По умолчанию false.
max_tokensintegerПредел длины ответа. Не может превышать то, что позволяет баланс.
temperature, top_pnumberСлучайность ответа.
stopstring | arrayСтроки, на которых модель остановится.
tools, tool_choicearray, string | objectВызов функций — см. Инструменты.
response_formatobject{"type": "json_object"} — ответ строго в JSON.
reasoning_effortstringlow / medium / high — глубина размышлений у моделей, которые это умеют.

Прочие поля запроса отбрасываются. Ответ — в формате OpenAI:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-v4.1-flash",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "Привет! Чем помочь?" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 12, "completion_tokens": 9, "total_tokens": 21 }
}

Потоковые ответы

С "stream": true ответ приходит событиями Server-Sent Events, последнее — data: [DONE]. Перед ним идёт событие с usage. Строки, начинающиеся с двоеточия (: keepalive), — служебные: модель думает, их нужно пропускать.

stream = client.chat.completions.create(
    model="claude-haiku-5.5",
    messages=[{"role": "user", "content": "Напиши хокку про осень"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Изображения

Модели со зрением принимают картинки в content — ссылкой или в base64 (PNG, JPEG, WebP, GIF; запрос целиком — до 12 МБ).

{
  "model": "openai/gpt-5.6-luna",
  "messages": [{
    "role": "user",
    "content": [
      { "type": "text", "text": "Что на фото?" },
      { "type": "image_url", "image_url": { "url": "data:image/jpeg;base64,/9j/4AAQ…" } }
    ]
  }]
}

Инструменты

Описание функций передаётся в tools в формате OpenAI. Модель возвращает tool_calls, вы выполняете функцию и присылаете результат репликой {"role": "tool", "tool_call_id": …, "content": …}.

"tools": [{
  "type": "function",
  "function": {
    "name": "get_weather",
    "description": "Погода в городе",
    "parameters": {
      "type": "object",
      "properties": { "city": { "type": "string" } },
      "required": ["city"]
    }
  }
}]

Цены и списание

  • Списание — после каждого запроса, по точному числу токенов от модели. Минимум — 1 копейка за запрос.
  • Токены считаются раздельно: обычный вход, кэш (повторно отправленный контекст — по закупочной цене, без наценки) и ответ.
  • Баланс не уходит в минус: длина ответа автоматически ограничивается остатком.
  • Если клиент оборвал поток, списывается только то, что модель успела написать.
  • Один баланс на чат на сайте, API и приложение.

Ошибки

Ошибки приходят в формате OpenAI: {"error": {"message": "…", "type": "…"}}. Текст можно показывать пользователю как есть.

КодtypeЧто значит
400invalid_request_errorНеверный запрос: пустой messages, картинка для модели без зрения и т. п.
401invalid_api_keyКлюч не передан, неверен или отозван.
402insufficient_balanceНе хватает денег на балансе.
404model_not_foundТакой модели нет — см. GET /v1/models.
413invalid_request_errorЗапрос больше 12 МБ.
429rate_limitСлишком часто или модель перегружена — повторите позже.
502upstream_errorВременная ошибка провайдера модели — повторите запрос.

Лимиты

  • 120 запросов в минуту на ключ.
  • Тело запроса — до 12 МБ.
  • Ответ — до 64 000 токенов за запрос (и не больше, чем позволяет баланс).

Cursor, Cline и другие

Подойдёт любой инструмент, где можно указать свой OpenAI-совместимый адрес:

ИнструментЧто указать
Cline, Roo Code, Kilo CodeПровайдер OpenAI Compatible, Base URL https://ai.pulsey.ru/v1, ключ, ID модели.
Continueprovider: openai, apiBase: https://ai.pulsey.ru/v1.
CursorSettings → Models → OpenAI API Key + Override OpenAI Base URL.
Любой SDK OpenAIПеременные окружения OPENAI_BASE_URL и OPENAI_API_KEY.

Для ИИ-агентов

Вся эта документация одним текстовым файлом лежит по адресу /llms.txt — отдайте его своему агенту, и он сам разберётся, как подключиться.