API Venice AI: первый запрос за пять минут
Запустите нашу LLM без цензуры за пять минут с помощью этого быстрого руководства по API Venice AI. Используйте эндпоинты, совместимые с OpenAI, для отправки текста, потоковой передачи ответов и вызова функций по прозрачной модели оплаты по факту.
https://api.veniceapialternative.com/v1
Базовый URL и аутентификация
Начните с создания аккаунта на странице Получить API-ключ. Вам понадобятся только адрес электронной почты и пароль; для получения пробного баланса в размере $0,50, действительного в течение семи дней, кредитная карта не требуется. Ваш API-ключ отображается сразу после регистрации, и его можно перегенерировать в любое время, что аннулирует старый ключ.
Используйте базовый URL https://api.veniceapialternative.com/v1 с официальными SDK OpenAI или любым клиентом, совместимым с OpenAI. Установите свой API-ключ в качестве токена Bearer в заголовке Authorization. Этот эндпоинт venice ai api заменяет базовый URL OpenAI по умолчанию в конфигурации вашего клиента.
Первый запрос
Отправьте простой запрос на завершение чата, чтобы проверить соединение. Идентификатор модели всегда uncensored. Эта модель с открытыми весами работает на наших GPU-серверах и настроена так, чтобы отвечать без отказов по контенту для законного использования взрослыми.
Замените YOUR_API_KEY на ваш фактический ключ. В ответе возвращается текстовый вывод на основе вашего промпта.
curl https://api.veniceapialternative.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 и настройте её на использование нашего базового URL. Это позволяет использовать существующие кодовые базы, ожидающие эндпоинты OpenAI.
from openai import OpenAI
client = OpenAI(base_url="https://api.veniceapialternative.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 SDK
Для сред Node.js используйте пакет openai. Инициализируйте клиент с пользовательским базовым URL и вашим API-ключом. Это гарантирует, что все запросы маршрутизируются через инфраструктуру venice ai api.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.veniceapialternative.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);
Потоковая передача ответов
Включите потоковую передачу, установив stream: true в запросе. API возвращает Server-Sent Events (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)
Лимиты запросов и ограничения
Модель uncensored поддерживает контекстное окно на 100 000 токенов для промпта и завершения вместе. Лимит — 300 запросов в минуту на API-ключ. Тело запроса не должно превышать 8 МБ.
Распространённые ошибки включают 401 (неверный ключ), 402 (недостаточно средств) и 429 (превышен лимит запросов). Пополните предоплаченный баланс от $10; кредиты не сгорают. Отсутствие ежемесячной подписки не ограничивает ваши возможности.
Характеристики API
Все реальные лимиты и возможности API в одном месте — сверьте их до пополнения.
| Параметр | Значение |
|---|---|
| Формат API | совместим с OpenAI: любой OpenAI SDK работает — замените base URL и ключ |
| Эндпоинты | POST /v1/chat/completions · GET /v1/models |
| ID модели | uncensored |
| Авторизация | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.veniceapialternative.com/v1 |
| JSON-режим | response_format: {"type": "json_object"} |
| Параметры | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Контекстное окно | 100 000 токенов (вход и ответ вместе) |
| Вызов функций | да — tools, tool_choice; ответ содержит tool_calls, в том числе в потоке; результат — сообщением role: tool |
| Потоковая передача | да — server-sent events, последний фрагмент содержит расход токенов |
| Максимум ответа | до остатка окна в 100 000 токенов; max_tokens необязателен (отдельного лимита нет) |
| Размер запроса | до 8 МБ |
| Параллельные запросы | до 8 одновременно на ключ |
| Заголовки ответа | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Лимит запросов | 300 запросов в минуту на ключ |
| Срок действия | оплаченный баланс не сгорает, без подписки |
| Оплата | предоплаченный баланс по фактическому расходу; ошибки и отказы бесплатны |
| Бонус | +5% от $50, +10% от $100 |
| Цена | $0,25 за 1 млн входных токенов · $1,00 за 1 млн выходных |
| Пополнение | USDT (TRC20) или USDC (Base), любая целая сумма от $10 до $500 |
| Пробный баланс | $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 | модель занята — повторите через несколько секунд |
Вопросы и ответы
Это официальный API Venice.ai?
Нет. Это независимый сервис, размещающий модель с открытыми весами без цензуры. Он не связан с основной платформой Venice.ai и не является перепродавцом моделей других поставщиков.
Поддерживает ли этот API генерацию изображений или аудио?
Нет. Это API для текстовых чат-завершений. Оно не поддерживает эмбеддинги, генерацию изображений, аудио, видео или дообучение.
Что произойдёт, если истечёт срок действия моего пробного баланса?
Ваш пробный баланс истекает через семь дней. Вы можете пополнить его криптовалютой (USDT или USDC) от $10. Предоплаченный баланс не сгорает, и вы можете сгенерировать новый API-ключ в любое время.
Ваш ключ — в одной форме от вас
Создайте аккаунт, скопируйте ключ, измените базовый URL. Вот и вся настройка.