Базовый URL и аутентификация
Базовый URL для всех запросов — https://api.veniceaiapipricing.com/v1. Вы аутентифицируетесь, передавая ваш API-ключ в Authorization header в виде Bearer-токена. Эта настройка работает с любым стандартным SDK OpenAI. Замените YOUR_API_KEY с ключом, сгенерированным в панели управления вашего аккаунта.
- Конечная точка:
POST /v1/chat/completions - Заголовок:
Authorization: Bearer YOUR_API_KEY
curl https://api.veniceaiapipricing.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Return server status code 200"}]
}'Эндпоинт /v1/chat/completions
Отправляйте историю разговора в /v1/chat/completions с помощью uncensored идентификатор модели. API принимает стандартные объекты сообщений с role и content поля. Входные токены стоят $0.15 за миллион, а выходные токены стоят $0.50 за миллион. Ошибки и отказы не расходуют кредит.
Этот эндпоинт поддерживает генерацию только текста. Он не обрабатывает изображения, аудио или эмбеддинги. Вы можете использовать потоковую передачу ответов или получать полный текст в виде одного объекта JSON.
from openai import OpenAI
client = OpenAI(base_url="https://api.veniceaiapipricing.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)Потоковые ответы (SSE)
Включите потоковую передачу, установив stream: true в тело запроса. API возвращает события, отправляемые сервером (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)Function Calling и режим JSON
API поддерживает структурированные выходные данные и определения инструментов. Используйте response_format: {"type": "json_object"} чтобы принудительно получить вывод в формате JSON. Вы также можете передать tools для вызова функций, позволяя модели возвращать структурированные данные для логики вашего приложения.
Эта функция полезна для извлечения данных или запуска действий. Модель возвращает вызовы инструментов в стандартизированном формате. Затем вы можете выполнить свои функции и передать результаты обратно в разговор.
Параметры: Temperature, Top P, Seeds
Контролируйте креативность с temperature и top_p. The seed parameter обеспечивает детерминированные результаты для тестирования. Эти параметры соответствуют стандартным соглашениям OpenAI. Их настройка влияет на случайность генерируемого текста.
Установить temperature to 0.7 for balanced creativity. Use seed для воспроизводимых результатов. API корректно игнорирует неподдерживаемые параметры.
Лимиты запросов и ограничения
Лимит составляет 300 запросов в минуту на один ключ. Одновременно может выполняться не более 8 запросов на ключ. Размер тела запроса ограничен 8 МБ. Размер контекстного окна составляет 100 000 токенов на вход и выход суммарно. Максимальный объем вывода на один запрос — 16 000 токенов.
Превышение этих лимитов возвращает ошибку 429. Убедитесь, что ваш клиент appropriately обрабатывает повторные попытки. API-ключ уникален для каждого аккаунта; генерация нового ключа заменяет старый.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.veniceaiapipricing.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);