Быстрый старт для конвейеров Acestep

Предварительные требования: получите API-ключ

Перед отправкой запросов вам нужен действующий API-ключ. Перейдите на страницу Получить API-ключ на acestep.cc. Вы можете зарегистрироваться, нажав Продолжить с Google или создав аккаунт по электронной почте и паролю. Номер телефона не требуется. После регистрации ваш API-ключ отображается сразу. Скопируйте этот ключ; он будет использоваться для аутентификации всех последующих запросов. Если у вас нет средств, вам нужно будет пополнить баланс. Мы принимаем только криптовалютные платежи (USDT в сети TRC20 или USDC в сети Base) на суммы от $10 до $500. На новые аккаунты начисляется $0,50 пробного баланса, действительного в течение 7 дней, без необходимости привязки карты. Храните ваш ключ в безопасности, так как он используется для аутентификации вашего использования в рамках лимитов запросов и потребления токенов.

Установка

API использует стандартный протокол, совместимый с OpenAI. Вы можете взаимодействовать с ним с помощью официальных SDK OpenAI для предпочитаемого вами языка или любого HTTP-клиента. Для Python установите пакет openai. Для Node.js установите openai. Убедитесь, что вы используете последнюю версию SDK, поддерживающую пользовательские базовые URL. Базовый URL нашего сервиса — https://api.acestep.cc/v1. Это позволяет вам повторно использовать существующий код конвейера, ожидающий эндпоинты OpenAI, просто заменив базовый URL и API-ключ. Идентификатор модели, который вы должны указать в запросах, — uncensored. Эта модель — LLM с открытыми весами, настроенная на минимальные отказы по законным взрослым, художественным или спорным темам, что делает её идеальной для творческих конвейеров, где фильтры контента могут блокировать допустимый творческий вывод.

Базовый запрос: генерация текста

Отправьте POST-запрос на /v1/chat/completions с вашим системным промптом и сообщениями пользователя. Модель вернет сгенерированный текст. Убедитесь, что вы установили параметр model в значение uncensored. Вы можете управлять креативностью с помощью параметров temperature и top_p. Контекстное окно поддерживает до 100 000 токенов всего (промпт + ответ модели). Максимальный объем вывода за один запрос составляет 32 000 токенов или 2 048, если вы не указали max_tokens. Ошибки и отказы не потребляют баланс, но успешная генерация токенов — да. Используйте этот эндпоинт для генерации сценариев, подписей или обработки текстовых данных перед передачей их другим модальностям, таким как API генерации речи или изображений.

Потоковая передача ответов

Для обновлений в реальном времени установите stream: true в вашем запросе. API возвращает события, отправляемые сервером (SSE). Каждый чанк содержит частичный текст. Детали использования токенов предоставляются в последнем чанке потока. Это полезно для приложений, отображающих текст по мере его генерации, что улучшает воспринимаемую задержку для пользователей. Убедитесь, что ваш клиент корректно обрабатывает SSE. Поток позволяет вам обрабатывать токены по мере их поступления, что полезно для генерации длинных текстов в вашем конвейере. Помните, что потоковая передача не меняет тарифы или лимиты токенов; вы все равно оплачиваете общее количество сгенерированных токенов.

Вызов функций

API поддерживает вызов функций, позволяя модели выдавать структурированные данные на основе определенных вами инструментов. Определите ваши функции в параметре tools. Установите tool_choice в значение auto или конкретное имя функции. Модель ответит объектом вызова функции, если это уместно. Это ценно для извлечения структурированных данных из текста или подготовки входных данных для последующих вызовов API. Вы также можете принудительно формировать вывод JSON, установив response_format в значение {"type": "json_object"}. Это гарантирует, что модель вернет действительный JSON, что критично для надежной интеграции в ваш автоматизированный конвейер. Используйте эти функции для повышения надежности ваших шагов обработки текста.

Тарификация и ограничения

Цены: $0,25 за 1 млн входных токенов и $1,00 за 1 млн выходных токенов. Баланс предоплаченный и не сгорает. Ошибки бесплатны. Лимит запросов: 300 запросов в минуту на ключ и 8 одновременных запросов на ключ. Максимальный размер тела запроса — 8 МБ. При превышении лимита вы получаете ошибку 429. Ошибка 401 означает, что ключ недействителен или истёк. Ошибка 402 означает недостаточный баланс. Возврат средств за баланс не производится; споры решаются через страницу поддержки. На один аккаунт допускается один активный ключ; генерация нового ключа заменяет старый. Учитывайте эти ограничения при проектировании логики повторных попыток в вашем конвейере.

cURL

Copycurl https://api.acestep.cc/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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.acestep.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);

Потоковая передача

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)