API нейросетей с одним ключом, протоколом OpenAI и оплатой в рублях

1. 1

   Получите ключ

   Ключ создаётся в кабинете разработчика после первой покупки пакета токенов. Он начинается с sk-epic- и показывается один раз.

2. 2

   Укажите адрес

   Вместо адреса OpenAI подставьте https://epicai.ru/v1. Подходят официальные библиотеки openai для Python и Node.js, LangChain и любой клиент, где можно сменить адрес.

3. 3

   Выберите модель

   Имена берите из GET /v1/models. Запрос бесплатный, в ответе есть цены, контекст и возможности каждой модели.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://epicai.ru/v1",
    api_key=os.environ["EPICAI_API_KEY"],
)
reply = client.chat.completions.create(
    model="claude-haiku-5-5",
    messages=[{"role": "user", "content": "Hello!"}],
    max_tokens=400,
)
print(reply.choices[0].message.content)
print("Списано TOK:", reply.model_extra["epic"]["cost_tok"])

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://epicai.ru/v1",
  apiKey: process.env.EPICAI_API_KEY,
});
const reply = await client.chat.completions.create({
  model: "claude-haiku-5-5",
  messages: [{ role: "user", content: "Hello!" }],
  max_tokens: 400,
});
console.log(reply.choices[0].message.content);
console.log("Списано TOK:", reply.epic.cost_tok);

import os
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="claude-haiku-5-5",
    base_url="https://epicai.ru/v1",
    api_key=os.environ["EPICAI_API_KEY"],
    max_tokens=300,
)
print(llm.invoke("Hello!").content)

Список моделей и цен читайте при запуске программы и не зашивайте имена в код. Каталог меняется, старые версии снимают, новые подключают. Среди видеомоделей есть OmniHuman 2.0. Она делает говорящего аватара из фото человека и записи речи или песни.

• Потоковый ответ

  Параметр stream со значением true, как у OpenAI. Расход приходит в последнем кадре, если добавить stream_options.include_usage.

• Вызов функций

  Массив tools и tool_choice, до 128 функций в запросе. Сами функции выполняет ваша программа.

• Картинки на входе

  Ссылкой или в base64, для моделей с признаком vision в списке. Остальные отвечают понятной ошибкой, и токены не списываются.

• JSON-режим

  Поле response_format принимает json_object и json_schema. У моделей Claude работает json_object.

• Рассуждения

  У моделей с признаком reasoning доступен параметр reasoning_effort, а ход рассуждений приходит в поле reasoning_content, если вендор его отдаёт.

• Цена в каждом ответе

  Поле epic.cost_tok и заголовок x-epic-cost-tok показывают, сколько токенов списано. Номер запроса лежит в x-request-id.

• Задачи

  POST /v1/tasks принимает модель, описание и параметры. Состояние и результат читаются через GET /v1/tasks/{id}, файлы лежат на сервере 7 суток.

• Цена до запуска

  POST /v1/quote называет цену задачи и ничего не резервирует. Ту же сумму epicai резервирует при создании, а если задача не удалась, резерв снимается.

• Вебхуки

  Укажите webhook_url, и о готовности придёт запрос с подписью X-Epic-Signature. При сбое доставка повторяется, события называются task.succeeded и task.failed.

• Формы OpenAI

  Картинки, озвучка и расшифровка доступны и в привычной форме: /v1/images/generations, /v1/audio/speech и /v1/audio/transcriptions.

• Операции над результатом

  Midjourney: увеличение, вариации, расширение кадра, ролик из картинки. Suno: продление трека, замена участка, WAV и видео.

curl https://epicai.ru/v1/tasks \
  -H "Authorization: Bearer $EPICAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2-1",
    "prompt": "Coffee shop logo, minimal",
    "webhook_url": "https://example.com/hooks/epicai"
  }'

curl https://epicai.ru/v1/quote \
  -H "Authorization: Bearer $EPICAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2-1",
    "prompt": "Coffee shop logo, minimal"
  }'

• Те же токены, что на сайте

  Баланс общий, запросы по ключу и из чата тратят одни и те же токены. Подписки и отдельного тарифа нет.

• Цены каталога

  Цены моделей совпадают с сайтом, а ценовые акции на модель действуют и в API. GET /v1/models отдаёт цены за миллион токенов модели.

• Резерв перед запросом

  Перед обращением к модели резервируется худший случай по max_tokens, после ответа списывается фактическая сумма. Задавайте max_tokens, чтобы резерв не был лишним.

• Платите за результат

  Запрос, отклонённый до модели, и ошибка вендора до начала ответа ничего не стоят. Задача с медиа, которая завершилась ошибкой, возвращает резерв.

• Настройки каждого ключа

  Запросов в минуту, потолок расхода на сутки и месяц, список разрешённых моделей, до 10 IP-адресов или подсетей, срок действия.

• Несколько ключей

  До 20 действующих ключей на аккаунт, по ключу на проект, расход и лимиты считаются отдельно. Отозванный ключ перестаёт работать на следующем же запросе.

• Журнал и статистика

  В кабинете /developers видны расход по дням, моделям и ключам и журнал вызовов. Те же числа отдаёт GET /v1/usage.

• Ключи организации

  Если ваша компания подключена к epicai Business, администратор выпускает сотрудникам ключи, которые платят с общего баланса организации. Лимиты организации действуют и в API.

• Тексты не сохраняются

  Тексты запросов и ответов моделей не записываются ни в журнал вызовов, ни в базу. Запрос по ключу не создаёт чат на сайте.

• Журнал без содержимого

  Время, ключ, модель, число токенов, код ответа и IP-адрес. Записи удаляются через 90 дней.

• Файлы результатов

  Файлы картинок, видео и музыки лежат на сервере 7 суток, затем стираются. Ссылка открывается без ключа и защищена длинным случайным номером, поэтому передавайте её только тем, кто может видеть результат.

• Ключ

  Хранится только SHA-256 от ключа и первые знаки для узнавания в списке. Потерянный ключ восстановить нельзя, нужно выпустить новый.

• Запрос уходит вендору

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