Подключение
Ключ Tapwing в программе
Две минуты: создать ключ, вставить в настройки, проверить.
- Зарегистрируйтесь и пополните баланс в кабинете.
- В кабинете нажмите «Создать ключ» и скопируйте его — он показывается один раз.
- В Tapwing: Настройки → Распознавание → Провайдер: Tapwing, вставьте ключ в поле «Ключ API».
- Нажмите «Проверить подключение» — и «Сохранить». Баланс появится в строке состояния программы.
Тот же ключ подходит и для обработки текста: Настройки → Обработка текста → Сервис: Tapwing. Модель по умолчанию — tapwing-text;
другие модели видны по кнопке «Список моделей».
Ключ в своих программах
Ключ работает с любым OpenAI-совместимым клиентом: скрипты, боты, редакторы и чат-программы, где можно указать свой адрес API («Base URL») и ключ.
| Адрес API | https://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.