Руководство по быстрому старту API ia
Получите API-ключ и начните отправлять запросы к uncensored LLM API за несколько минут. В этом руководстве описаны аутентификация, основные endpoint, потоковая передача и продвинутые функции с конкретными примерами.
Аутентификация & базовый URL
Используйте свой уникальный API-ключ с каждым запросом к https://api.apiia.cc/v1 базовый URL. Этот совместимый с OpenAI конечная точка работает с любым стандартным SDK путем установки базового URL и предоставления вашего ключа в Authorization header. Ключ генерируется сразу при регистрации через Google или email, номер телефона не требуется. Храните ключ в безопасности, так как он предоставляет прямой доступ к вашему предоплаченному кредиту. Вы можете сгенерировать новый ключ в любое время, который мгновенно заменит предыдущий.
Отправка вашего первого завершения
Отправьте POST-запрос на /v1/chat/completions с моделью, установленной на "uncensored". Этот простой интерфейс «текст на вход, текст на выход» обрабатывает ваши запросы без отказов по контенту для законного использования взрослыми. Вы можете контролировать длину ответа с помощью max_tokens параметр, который по умолчанию равен 2,048, если не указан. Модель поддерживает контекстное окно в 100,000 токенов, что позволяет хранить значительную историю запросов. Используйте этот эндпоинт для надежной генерации текста без фильтрации.
curl https://api.apiia.cc/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the capital of France?"}]
}'
Интеграция Python SDK
Установите официальный пакет OpenAI для Python и настройте базовый URL на указание нашего сервиса. Это позволяет использовать знакомые методы, такие как chat.completions.create() с нашей uncensored-моделью. SDK автоматически выполняет токенизацию и форматирование запросов. Вы можете передавать параметры, такие как temperature и top_p для управления креативностью и случайностью. Этот подход упрощает интеграцию в существующие приложения на Python или рабочие процессы науки о данных.
from openai import OpenAI
client = OpenAI(base_url="https://api.apiia.cc/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
Используйте OpenAI Node.js SDK, установив BASE_URL environment variable или настройка экземпляра клиента. Это обеспечивает бесшовную интеграцию с проектами JavaScript и TypeScript. SDK поддерживает все стандартные функции завершения чата, включая вызов функций и JSON-режим. Вы можете легко переключаться между потоковыми и непотоковыми режимами. Эта гибкость делает его идеальным для создания веб-приложений или serverless-функций, которым требуется генерация текста без цензуры.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.apiia.cc/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);
Потоковые ответы с SSE
Включите потоковую передачу, установив 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)
Лимиты, Ошибки и Контекстное окно
Ваш API-ключ ограничен 300 запросами в минуту и 8 одновременными запросами. Максимальный размер тела запроса составляет 8 МБ. Если вы получите ошибку 401, проверьте валидность вашего API-ключа. Ошибка 402 указывает на недостаточный предоплаченный кредит. Ошибка 429 означает, что вы превысили лимит частоты запросов. Контекстное окно поддерживает 100,000 токенов как для промпта, так и для завершения в совокупности. Понимание этих лимитов помогает вам проектировать надежные приложения, которые gracefully обрабатывают ошибки.
Часто задаваемые вопросы
Как аутентифицировать запросы?
Добавьте свой API-ключ в заголовок Authorization в виде токена Bearer. Базовый URL — HTTPS://api.apiia.cc/v1 для всех SDK, совместимых с OpenAI.
Что произойдет, если я превышу лимит частоты запросов?
Вы получите код статуса 429. Лимит составляет 300 запросов в минуту и 8 параллельных запросов на ключ. Подождите немного перед повторной попыткой.
Действительны ли пробные кредиты бессрочно?
Нет, пробный кредит в размере $0.50 действителен в течение 7 дней. Предоплаченный кредит от пополнений не истекает, но пробный кредит предоставляется один раз на аккаунт.
Получите API-ключ за несколько секунд
Зарегистрируйтесь, получите ключ и обновите базовый URL. Готово.