Руководство по быстрому старту API эмбеддингов

Аутентификация

Получите доступ к API с помощью уникального API-ключа, сгенерированного в панели управления аккаунтом. Включите этот ключ в заголовок Authorization каждого запроса по схеме Bearer. Базовый URL для всех эндпоинтов — https://api.embeddingapis.com/v1. Этот URL работает с официальными SDK OpenAI и любым клиентом, настроенным на совместимость с OpenAI. Храните ключ в безопасности, так как он предоставляет доступ к вашим предоплаченным кредитам.

Каждый аккаунт ограничен одним активным ключом, который можно перегенерировать в любое время. Перегенерация ключа немедленно аннулирует предыдущий, поэтому обновите конфигурацию немедленно.

Эндпоинт Chat Completions

Отправляйте текстовые промпты на эндпоинт POST /v1/chat/completions. API обслуживает единственную модель без цензуры с идентификатором uncensored. Это модель с открытыми весами LLM, настроенная на ответы без отказов по контенту для законных взрослых, художественных или исследовательских тем безопасности. Она обрабатывает текст на входе и выдает текст, что делает её идеальной для постобработки, суммаризации или извлечения данных в вашем конвейере.

Структурируйте запрос с массивом messages, содержащим ваши системные и пользовательские промпты. API возвращает JSON-ответ, содержащий сгенерированный текст.

Copycurl https://api.embeddingapis.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 для взаимодействия с API. Установите значение base_url на наш эндпоинт и укажите свой API-ключ. Этот подход позволяет использовать существующий клиентский код с минимальными изменениями. Клиент обрабатывает сериализацию и сетевые запросы, возвращая структурированные ответы, которые вы можете разобрать для логики вашего приложения.

Убедитесь, что вы используете актуальную версию SDK для поддержки всех функций, включая потоковую передачу и вызов функций. Идентификатор модели остается uncensored при вызове завершения генерации.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.embeddingapis.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

Для сред JavaScript или TypeScript используйте SDK OpenAI Node.js. Настройте клиент с правильным базовым URL и API-ключом. Эта настройка обеспечивает совместимость с ваш существующими конвейерами на базе Node. SDK управляет подключением к эндпоинту POST /v1/chat/completions, позволяя вам эффективно отправлять промпты и получать текстовые завершения.

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.embeddingapis.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), доставляя токены по мере их генерации. Это особенно полезно для пользовательских интерфейсов реального времени или при обработке длинных текстов, когда немедленная обратная связь ценна.

Разбирайте поток SSE для обработки частичных ответов. Модель без цензуры поддерживает этот режим, позволяя реагировать на контент по мере его создания, не ожидая полного завершения.

Copystream = 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)

Лимиты, ошибки и контекстное окно

Контекстное окно поддерживает 100 000 токенов для промпта и завершения вместе. Запросы, превышающие лимит тела в 8 МБ или лимит запросов в 300 запросов в минуту, завершатся ошибкой. Ошибки аутентификации возвращают статус 401, если ключ недействителен. Когда предоплаченные кредиты исчерпаны, запросы завершаются ошибкой, так как нет кредитов для покрытия использования токенов. Статус 429 указывает на исчерпание лимита запросов.

Всегда применяется жесткое ограничение контента: запросы, содержащие сексуальный контент с участием несовершеннолетних, блокируются, независимо от других настроек. Весь остальной законный взрослый контент обрабатывается без отказов.