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

API совместим с OpenAI: тот же формат Chat Completions. Достаточно заменить адрес и модель — остальной код менять не нужно.

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

Три шага:

1. Зарегистрируйтесь и оплатите пакет токенов.
2. Создайте ключ в кабинете — он выглядит как sk-aivc-....
3. Отправьте первый запрос на https://api.aivcrypto.ru/v1/chat/completions.

Авторизация

Ключ передаётся в заголовке Authorization:

Authorization: Bearer sk-aivc-ВАШ_КЛЮЧ

Ключ виден только один раз при создании. Если потеряли — отзовите старый и создайте новый в кабинете.

Модели

Доступные модели:

Актуальный список всегда доступен запросом GET https://api.aivcrypto.ru/v1/models.

Цены

Одна цена для всех моделей: 0,05 ₽ за 1000 токенов — это 50 ₽ за миллион.

Токены не сгорают. Списание по факту: сумма токенов в запросе и в ответе.

Примеры запросов

cURL

curl https://api.aivcrypto.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-aivc-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"Привет!"}]}'

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.aivcrypto.ru/v1",
    api_key="sk-aivc-...",
)

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

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.aivcrypto.ru/v1",
  apiKey: process.env.AIVC_KEY,
});

const r = await client.chat.completions.create({
  model: "glm-5.3-flash",
  messages: [{ role: "user", content: "Привет!" }],
});
console.log(r.choices[0].message.content);

Стриминг

Для длинных ответов включите потоковую передачу — пользователь увидит текст сразу:

stream = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Напиши 5 идей"}],
    stream=True,
)

for chunk in stream:
    piece = chunk.choices[0].delta.content
    if piece:
        print(piece, end="", flush=True)

Расход токенов

Списание идёт за две части: токены в запросе и токены в ответе.

Расход по каждому запросу виден в кабинете: сколько ушло на вход и сколько на выход.

Лимиты

На каждый ключ действует ограничение по числу запросов в минуту. Значение по умолчанию — 60 запросов в минуту. Если вашей нагрузке этого мало, напишите нам: лимит поднимается.

При превышении возвращается код 429. Правильная реакция — пауза и повтор, а не немедленная повторная отправка.

Ошибки

Ключи

Ключи создаются и отзываются в кабинете: https://api.aivcrypto.ru/keys. Ключ показывается один раз при создании — сохраните его сразу.

Можно держать несколько ключей: отдельный для продакшена, отдельный для тестов. Это удобно, когда нужно отозвать один, не ломая остальные.

Оплата

Пакеты токенов и история платежей — в разделе https://api.aivcrypto.ru/billing. После оплаты токены зачисляются сразу, ключ менять не нужно.

Для юридических лиц выставляем счёт — напишите на webmaster@aivcrypto.ru с реквизитами.

Ссылки

• OpenAPI-спецификация — JSON-файл для программ: генераторы клиентов, Postman, валидаторы. Скачивается, а не открывается: браузер показал бы его сплошным текстом.
• llms.txt — краткая карта сервиса для языковых моделей.
• Витрина API — описание, калькулятор стоимости, частые вопросы.