Подключение

Ключ Tapwing в программе

Две минуты: создать ключ, вставить в настройки, проверить.

  1. Зарегистрируйтесь и пополните баланс в кабинете.
  2. В кабинете нажмите «Создать ключ» и скопируйте его — он показывается один раз.
  3. В Tapwing: Настройки → Распознавание → Провайдер: Tapwing, вставьте ключ в поле «Ключ API».
  4. Нажмите «Проверить подключение» — и «Сохранить». Баланс появится в строке состояния программы.

Тот же ключ подходит и для обработки текста: Настройки → Обработка текста → Сервис: Tapwing. Модель по умолчанию — tapwing-text; другие модели видны по кнопке «Список моделей».

Ключ в своих программах

Ключ работает с любым OpenAI-совместимым клиентом: скрипты, боты, редакторы и чат-программы, где можно указать свой адрес API («Base URL») и ключ.

Адрес APIhttps://test.tapwing.ru/v1
РаспознаваниеPOST /v1/audio/transcriptions — multipart: file, model (любая, используется whisper-large-v3), language, prompt, response_format = json | text | verbose_json
ТекстPOST /v1/chat/completions — как у OpenAI: model, messages, temperature, max_tokens (до 8192), stream. Модели: tapwing-text (по умолчанию), qwen3.5-9b
Список моделейGET /v1/models — с ценами в рублях за 1 млн токенов
БалансGET /user/balance — в рублях
АвторизацияAuthorization: Bearer tw-…
Длинные записибез ограничения по размеру и длительности: файлы больше 24 МБ сервер сам делит на части по 10 минут и склеивает текст
Частотадо 60 запросов в минуту на ключ — защита от перебора, обычной работе не мешает

curl https://test.tapwing.ru/v1/audio/transcriptions -H "Authorization: Bearer tw-…" -F file=@speech.mp3 -F model=whisper-1

Python (библиотека openai)

from openai import OpenAI
client = OpenAI(base_url="https://test.tapwing.ru/v1", api_key="tw-…")

text = client.audio.transcriptions.create(model="whisper-large-v3", file=open("speech.mp3", "rb")).text
reply = client.chat.completions.create(model="tapwing-text", messages=[
    {"role": "system", "content": "Сделай из текста короткое деловое письмо."},
    {"role": "user", "content": text}])
print(reply.choices[0].message.content)

Ответ содержит заголовки X-Tapwing-Cost-RUB и X-Tapwing-Balance-RUB (у потокового ответа — только в истории расхода). При нулевом балансе — ошибка 402.