Один API: руководство по быстрому старту
Интегрируйте API нашей модели без цензуры, изменив одну настройку. Готовая замена означает, что вы меняете базовый URL и API-ключ, а затем продолжаете использовать существующий код.
Базовый URL и аутентификация
Сначала укажите клиенту наш выделенный эндпоинт. Этот совместимый с OpenAI API использует стандартные заголовки аутентификации, поэтому вам нужно изменить только два значения в конфигурации.
Базовый URL: https://api.onekeyllmapi.com/v1. Сгенерируйте уникальный API-ключ на странице регистрации. Для начала не нужна карта, ключ отображается сразу после регистрации. Храните ключ в безопасности; он аутентифицирует все запросы к сервису.
Базовое завершение
Отправьте простой промпт, чтобы получить прямой ответ. Это основа нашего API для разработчиков. Модель возвращает текст без отказов по контенту для законного использования взрослыми, что идеально подходит для творческих или неограниченных задач.
- Идентификатор модели:
uncensored - Эндпоинт:
POST /v1/chat/completions - Контекст: 100 000 токенов
Выполните свой первый запрос с помощью этого примера:
curl https://api.onekeyllmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Интеграция с Python SDK
Используйте официальную библиотеку OpenAI для Python для взаимодействия с нашим сервисом. Необходимы только изменения в base_url и api_key. Это гарантирует работу вашей существующей логики без изменений.
- Установка через
pip install openai - Установите переменные окружения или передайте их напрямую при инициализации клиента
- Вызовите
chat.completions.create()как обычно
Настройте клиент следующим образом:
from openai import OpenAI
client = OpenAI(base_url="https://api.onekeyllmapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Использование Node.js SDK
Интегрируйтесь с проектами на JavaScript или TypeScript с помощью стандартного пакета OpenAI для Node. Укажите клиенту наш URL и предоставьте ключ. Этот подход сохраняет совместимость с любой структурой клиента, совместимого с OpenAI.
- Установка через
npm install openai - Инициализация с пользовательским базовым URL
- Используйте стандартные паттерны async/await
Пример инициализации:
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.onekeyllmapi.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Потоковые ответы
Получайте ответы токеном за токеном для снижения воспринимаемой задержки. Наш streaming api поддерживает Server-Sent Events (SSE), что позволяет отображать вывод по мере его генерации. Это полезно для чат-интерфейсов или приложений реального времени.
- Установите
stream: trueв вашем запросе - Разберите поток SSE на клиенте
- Эффективно обрабатывайте частичные токены
Включите потоковую передачу в вашем коде:
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Лимиты, ошибки и контекст
Поймите ограничения для создания надежных интеграций. API поддерживает контекстное окно на 100k, позволяя работать с длинными документами или разговорами. Запросы ограничены размером тела 8 МБ.
Распространенные ошибки включают 401 для недействительных ключей, 402 при исчерпании предоплаченного баланса и 429 при превышении 300 запросов в минуту. Кредит по модели оплаты по факту использования не сгорает, и вы можете пополнить его от $10. Поддерживается вызов функций для выполнения функций.
Характеристики API
Все реальные лимиты и возможности API в одном месте — сверьте их до пополнения.
| Параметр | Значение |
|---|---|
| Формат API | совместим с OpenAI: любой OpenAI SDK работает — замените base URL и ключ |
| ID модели | uncensored |
| Base URL | https://api.onekeyllmapi.com/v1 |
| Авторизация | Authorization: Bearer YOUR_KEY |
| Эндпоинты | POST /v1/chat/completions · GET /v1/models |
| Контекстное окно | 100 000 токенов (вход и ответ вместе) |
| Вызов функций | да — tools, tool_choice; ответ содержит tool_calls, в том числе в потоке; результат — сообщением role: tool |
| JSON-режим | response_format: {"type": "json_object"} |
| Параметры | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Потоковая передача | да — server-sent events, последний фрагмент содержит расход токенов |
| Максимум ответа | до остатка окна в 100 000 токенов; max_tokens необязателен (отдельного лимита нет) |
| Размер запроса | до 8 МБ |
| Заголовки ответа | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Лимит запросов | 300 запросов в минуту на ключ |
| Параллельные запросы | до 8 одновременно на ключ |
| Пополнение | USDT (TRC20) или USDC (Base), любая целая сумма от $10 до $500 |
| Оплата | предоплаченный баланс по фактическому расходу; ошибки и отказы бесплатны |
| Срок действия | оплаченный баланс не сгорает, без подписки |
| Бонус | +5% от $50, +10% от $100 |
| Цена | $0,25 за 1 млн входных токенов · $1,00 за 1 млн выходных |
| Пробный баланс | $0,50 на 7 дней, без карты · Пробный ключ: 2 параллельных запроса, 60 в минуту; полные лимиты (8 и 300) после первого пополнения |
| Ключи | один активный ключ на аккаунт; новый заменяет старый |
| Вход | Google или e-mail и пароль |
| Контент | контент для взрослых разрешён; сексуальный контент с несовершеннолетними запрещён |
Коды ошибок
Ошибки приходят в JSON с постоянным type; неудачные и отклонённые запросы не оплачиваются.
| Код | Тип | Что значит |
|---|---|---|
400 | bad_request | неверный JSON, пустые сообщения, неверный параметр или превышено окно контекста |
401 | missing_key · invalid_key · key_revoked | нет ключа, ключ неверный или заменён новым |
402 | no_credit | баланс пуст — пополните, работа продолжится сразу |
403 | content_blocked | сексуальный контент с несовершеннолетними — отказ, без оплаты |
404 | not_found | неизвестный эндпоинт |
413 | request_too_large | тело запроса больше 8 МБ |
429 | rate_limited · concurrency | больше 300/мин или 8 параллельно — подождите и повторите |
503 | upstream_busy | модель занята — повторите через несколько секунд |
Вопросы и ответы
Это модель OpenAI?
Нет. Мы предоставляем одну выделенную нецензурируемую большую языковую модель, работающую на нашем оборудовании. Это не GPT, Claude или модель другого поставщика, но она совместима с их структурой API.
Как работает ценообразование?
Мы используем модель оплаты по факту использования без ежемесячных платежей. Входные токены стоят $0,25 за 1 млн, выходные — $1,00 за 1 млн. Предоплаченный баланс не сгорает, и вы можете начать с пробного баланса $0,50.
Какой размер контекстного окна?
API поддерживает контекстное окно на 100 000 токенов как для промпта, так и для завершения. Это позволяет вести обширные диалоги или обрабатывать длинные документы в рамках одного запроса.
Ваш ключ — в одной форме от вас
Создайте аккаунт, скопируйте ключ, измените базовый URL. Вот и вся настройка.