API PNC
Один ключ — доступ к GPT, Claude и DeepSeek. Оплата в рублях с баланса, только за израсходованные токены. API совместимо с OpenAI: в любой библиотеке достаточно поменять адрес и ключ.
https://ai.pulsey.ru/v1pnc-sk-…Быстрый старт
- Войдите на ai.pulsey.ru через аккаунт Pulsey — QR-кодом или кодом на почту.
- Пополните баланс и откройте API → API-ключи → Создать ключ. Ключ показывается целиком один раз — сохраните его.
- Отправьте запрос:
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 · OpenAI | 5 ₽ | 5 ₽ | 0,1 / 1 ₽ | 1.1M / 128K | ✓ |
claude-haiku-5.5Claude Haiku 5.5 · Anthropic | 5 ₽ | 10 ₽ | 0,1 / 1 ₽ | 1M / 128K | ✓ |
deepseek-v4.1-flashDeepSeek V4.1 Flash · DeepSeek | 5 ₽ | 10 ₽ | 0,2 / 2 ₽ | 1M / 393.2K | ✓ |
Chat Completions
POST /v1/chat/completions
| Параметр | Тип | Описание |
|---|---|---|
model обязателен | string | ID модели из таблицы выше. |
messages обязателен | array | Реплики {"role": "system" | "user" | "assistant" | "tool", "content": …}. |
stream | boolean | Отдавать ответ по кусочкам (SSE). По умолчанию false. |
max_tokens | integer | Предел длины ответа. Не может превышать то, что позволяет баланс. |
temperature, top_p | number | Случайность ответа. |
stop | string | array | Строки, на которых модель остановится. |
tools, tool_choice | array, string | object | Вызов функций — см. Инструменты. |
response_format | object | {"type": "json_object"} — ответ строго в JSON. |
reasoning_effort | string | low / 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 | Что значит |
|---|---|---|
| 400 | invalid_request_error | Неверный запрос: пустой messages, картинка для модели без зрения и т. п. |
| 401 | invalid_api_key | Ключ не передан, неверен или отозван. |
| 402 | insufficient_balance | Не хватает денег на балансе. |
| 404 | model_not_found | Такой модели нет — см. GET /v1/models. |
| 413 | invalid_request_error | Запрос больше 12 МБ. |
| 429 | rate_limit | Слишком часто или модель перегружена — повторите позже. |
| 502 | upstream_error | Временная ошибка провайдера модели — повторите запрос. |
Лимиты
- 120 запросов в минуту на ключ.
- Тело запроса — до 12 МБ.
- Ответ — до 64 000 токенов за запрос (и не больше, чем позволяет баланс).
Cursor, Cline и другие
Подойдёт любой инструмент, где можно указать свой OpenAI-совместимый адрес:
| Инструмент | Что указать |
|---|---|
| Cline, Roo Code, Kilo Code | Провайдер OpenAI Compatible, Base URL https://ai.pulsey.ru/v1, ключ, ID модели. |
| Continue | provider: openai, apiBase: https://ai.pulsey.ru/v1. |
| Cursor | Settings → Models → OpenAI API Key + Override OpenAI Base URL. |
| Любой SDK OpenAI | Переменные окружения OPENAI_BASE_URL и OPENAI_API_KEY. |
Для ИИ-агентов
Вся эта документация одним текстовым файлом лежит по адресу /llms.txt — отдайте его своему агенту, и он сам разберётся, как подключиться.