API-ключ, совместимый с OpenAI: получите его и отправьте запрос
API-ключ, совместимый с OpenAI, — это обычный bearer-токен, который работает с любыми SDK OpenAI, если вы укажете клиенту другой базовый URL. На этой странице показано, как получить такой ключ для текстового API на этом сайте и сделать рабочий запрос за несколько минут.
ОбновленоSpeech To Text API

Что на самом деле представляет собой ключ
«Совместим с OpenAI» описывает формат HTTP API, а не компанию. Сервис принимает то же JSON-тело в POST /v1/chat/completions, что и SDK OpenAI, и использует тот же заголовок Authorization: Bearer. Поэтому ключ от этого сервиса встраивается в любой инструмент, позволяющий задать базовый URL и API-ключ: официальные библиотеки Python и Node, LangChain, обычный curl и большинство десктопных чат-клиентов.
Ключ не является ключом OpenAI, и он не будет работать на api.openai.com. И наоборот: ключ OpenAI здесь не сработает. Каждый ключ принадлежит одному сервису, а этот сервис использует одну модель с открытыми весами, настроенную на ответы без отказов по содержанию для законного использования взрослыми пользователями, размещенную независимым провайдером. Это не официальное API ни одного вендора моделей, и оно не маршрутизирует запросы к другим вендорам.
Вот что нужно запомнить. Базовый URL для этого сайта — https://api.speechtotextapis.com/v1. Идентификатор модели — uncensored. Ключ — это любая строка, которую вы получите после регистрации. Всё остальное — вариации этих трех значений.
Сервис работает только с текстом. Он поддерживает завершение чата, потоковую передачу, вызов функций и JSON-режим. Он не генерирует изображения или аудио, не предлагает эмбеддинги и не дообучает модели. Если вы пришли сюда из конвейера обработки речи, типичная задача — текстовый этап после транскрипции: очистка транскрипта, разделение на сцены, переписывание диалогов или извлечение структурированных данных. Руководство по обработке голосовых сценариев подробно описывает этот аспект.
Получите ключ за четыре шага
- Зарегистрируйтесь. Используйте Google или зарегистрируйтесь по адресу электронной почты и паролю.
- Откройте страницу API-ключа. Она находится на странице ключа на этом сайте. Ваш ключ создается и отображается там.
- Активируйте пробный баланс. Кнопка на той же странице дает вам $0,50 пробного баланса одним кликом. Он предоставляется один раз на человека, действует 7 дней и не требует привязки карты.
- Скопируйте ключ в хранилище секретов. Для локального теста достаточно переменной окружения. Для любого развернутого приложения используйте менеджер секретов вашего хостинга.
Пробный баланс предназначен для того, чтобы доказать работоспособность интеграции до оплаты. По текущей цене его хватит на множество коротких запросов, а раздел стоимости ниже показывает расчеты. Когда будете готовы продолжить, на странице цен указаны суммы пополнения. Баланс предоплаченный, подписки нет, и баланс не сгорает, поэтому нет давления, чтобы потратить пополнение до какого-либо срока.
Пробные ключи имеют более строгие ограничения, чем полные: 2 параллельных запроса и 60 запросов в минуту. Этого достаточно для первого скрипта. Если вы планируете распараллелить десятки фрагментов транскриптов, ожидайте достижения лимита, пока не перейдете на аккаунт с балансом.
Три настройки, которые запрашивает любой клиент
В каком бы программном обеспечении вы ни работали, экран настройки запрашивает те же три значения под немного разными именами.
| Настройка | Типичное имя поля | Значение |
|---|---|---|
| Эндпоинт | Базовый URL, базовый URL API, хост | https://api.speechtotextapis.com/v1 |
| Учётные данные | API-ключ, токен, секрет | Ваш ключ со страницы ключа |
| Модель | Модель, имя модели, движок | uncensored |
Одна деталь сбивает с толку: базовый URL уже заканчивается на /v1. SDK добавляют /chat/completions самостоятельно, поэтому вам не нужно добавлять его. Если ваш клиент запрашивает полный URL эндпоинта чата, а не базовый URL, значение — https://api.speechtotextapis.com/v1/chat/completions.
Если инструмент предлагает только пресет "OpenAI" с жестко заданным хостом и без возможности редактирования, он не сможет работать с этим сервисом. Ищите опцию "пользовательский", "совместимый с OpenAI" или "расширенный", которая открывает поле базового URL.
Ваш первый запрос
Начните с curl, так как он убирает все слои между вами и API. Замените YOUR_KEY на скопированный ключ.
curl https://api.speechtotextapis.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
]
}'
Успешный ответ — это JSON-объект с массивом choices. Текст находится в choices[0].message.content, а блок usage сообщает о токенах, за которые вам выставили счет.
Тот же запрос с официальной библиотекой Python выглядит так. Отличаются только base_url и api_key от стандартной настройки OpenAI.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.speechtotextapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
],
)
print(resp.choices[0].message.content)
А в Node, используя тот же пакет:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.speechtotextapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
],
});
console.log(resp.choices[0].message.content);
Вам не нужно задавать max_tokens. Если он не указан, завершение может использовать всё, что осталось от 100 000-токенного контекстного окна после вашего промпта. Задайте его самостоятельно, если хотите жесткий лимит стоимости за один запрос.
Проверьте работоспособность ключа без расходования токенов
Прежде чем подключить ключ к большой системе, сделайте один дешевый запрос к эндпоинту моделей. Он подтвердит, что ключ принят и базовый URL указан верно.
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
Флаг -i выводит заголовки ответа, где этот API сообщает полезное состояние:
X-Request-Idидентифицирует запрос. Укажите его, если свяжетесь с поддержкой по поводу конкретного запроса.X-Balance-USDпоказывает оставшийся баланс на аккаунте.X-RateLimit-Limit-RequestsиX-RateLimit-Limit-Concurrencyпоказывают лимиты, применимые к вашему ключу, чтобы вы могли сразу увидеть, имеет ли ключ пробные или полные лимиты.
Чтение X-Balance-USD в вашем коде — дешевый способ предупредить себя до исчерпания баланса. Логируйте его один раз за задачу, а не один раз за запрос, если не хотите шумного вывода.
Сколько стоит использование ключа
Наличие ключа ничего не стоит. Вы платите за токены: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов, списываемые с предоплаченного баланса. Неудачные или отклонённые запросы не тарифицируются.
Рабочий пример с запросом очистки транскрипта выше. Предположим, промпт содержит 1 000 токенов, а очищенный ответ — 500 токенов.
- Вход: 1 000 / 1 000 000 x $0,15 = $0,00015
- Выход: 500 / 1 000 000 × $0,50 = $0,00025
- Итого: $0,0004 за вызов
Пробный баланс $0,50 покрывает примерно 1 250 запросов такого размера ($0,50 / $0,0004). Ваши цифры будут отличаться, так как длина транскриптов варьируется, но метод тот же: посчитайте входящие токены, посчитайте исходящие, умножьте.
При пополнении принимаются любые целые суммы от $20 до $500. Большие пополнения дают бонус: +5% от $50, +10% от $100 и +15% от $200. Пополнение на $100, например, дает вам $110 кредита. Можно оплатить криптовалютой (USDT в сети TRC20, USDC в сети Base).
Сохранение ключа в безопасности
API-ключ — это пароль для вашего баланса. Любой, кто им владеет, может потратить ваши средства, поэтому относитесь к нему соответствующим образом.
- Не храните его в системе контроля версий. Читайте из переменной окружения или менеджера секретов.
- Не включайте его в JavaScript для браузера или в бандл мобильного приложения. Всё, что выполняется на устройстве пользователя, может быть просмотрено. Разместите небольшой сервер между вашим фронтендом и API и пусть сервер добавляет заголовок.
- Не вставляйте его в скриншоты, тикеты или сообщения в чате.
- Если вы считаете, что ключ был скомпрометирован, прекратите его использование и немедленно свяжитесь со службой поддержки, не дожидаясь, пока что-то произойдёт.
Что касается конфиденциальности: промпты, отправленные в API, не используются для обучения. Это утверждение о сервисе, а не повод отправлять секреты, которые вам не нужно отправлять. Удаляйте персональные данные из транскрипций, если задача не требует их наличия.
При сбое запроса
Большинство проблем в первый день возникают по одной из четырёх причин.
Неверный базовый URL
Две распространённые ошибки — пропущенный /v1 и удвоенный /chat/completions. Сравните ваше значение посимвольно с тем, что указано в таблице выше.
В ключе есть лишний символ
При копировании со страницы часто захватывается пробел или символ новой строки в конце. Обрежьте значение в коде и убедитесь, что заголовок имеет вид Bearer, один пробел, затем ключ.
Имя модели не uncensored
Клиенты часто используют по умолчанию другое имя модели. Явно указывайте модель в каждом запросе.
HTTP 429
Существует два варианта, и код ошибки позволяет их различить. rate_limited означает, что вы отправили слишком много запросов в минуту. concurrency означает, что одновременно выполняется слишком много запросов. Потоковый запрос удерживает слот параллельных запросов до завершения потока, поэтому медленный клиент может вызвать эту ошибку даже при низкой частоте запросов. Код 429 с заголовком Retry-After: 5 означает временную перегрузку сервиса; подождите пять секунд и повторите запрос. Короткая экспоненциальная задержка в вашем клиенте обрабатывает все три случая.
Полный список параметров, формат потоковой передачи и детали вызова инструментов см. в документации API.
Дополнительные руководства
Вопросы и ответы
Это тот же ключ, что и у OpenAI?
Нет. Он использует тот же формат запроса, поэтому SDK OpenAI работают с ним, но он выпущен этим сервисом и работает только с базовым URL этого сервиса.
Нужна ли карта для получения ключа?
Нет. Зарегистрируйтесь через Google или email, затем получите пробный кредит в размере $0,50 одним нажатием на странице ключа. Для пробного периода не нужна карта, и он действителен в течение 7 дней.
Какое имя модели мне использовать?
Используйте uncensored в поле модели. Запрос к GET /v1/models покажет, к чему у вас есть доступ.
Могу ли я использовать один и тот же ключ с нескольких серверов?
Да, но ограничения действуют на ключ в целом: 8 одновременных запросов и 300 запросов в минуту для полного ключа, 2 и 60 для пробного ключа.
Работает ли ключ для изображений или речи?
Нет. API работает только с текстом. Он не генерирует и не транскрибирует аудио или изображения, а также не поддерживает эмбеддинги или дообучение.
Ваш ключ — в одном шаге от получения
Создайте аккаунт, скопируйте ключ, измените базовый URL. Вот и вся настройка.