# Инструкция для интеграции транскрибации в агентские приложения

Эта инструкция предназначена для агента (например, OpenClaw), который должен самостоятельно настроить интеграцию транскрибации аудио с нашим API.

## 1. Запросите у пользователя API-токен

Сначала запросите у пользователя токен доступа. Если у пользователя еще нет токена, объясните, как его получить:

1. Перейти в Telegram-бот: https://t.me/wormsoft_ai_bot
2. Получить токен в боте.
3. Переслать полученный токен вам в ответном сообщении.

После получения токена используйте его в заголовке авторизации:

```
Authorization: Bearer <api_token>
```

## 2. Эндпоинт транскрибации

Базовый URL API:

```
https://ai.wormsoft.ru/api/v1
```

Эндпоинт:

```
POST /audio/transcriptions
```

Тип содержимого:

```
multipart/form-data
```

## 3. Обязательные параметры

- `file` — аудиофайл (mp3, wav, flac, ogg, opus), максимум 25 МБ.
- `model` — модель для транскрибации:
  - `gigaam` — рекомендуется для **русской речи** (лучшее качество на русском языке).
  - `whisper-large` — для **любого языка** (универсальная модель).

## 4. Необязательные параметры

- `language` — язык аудио в ISO-639-1 (например, `ru`, `en`).
- `response_format` — формат ответа: `json`, `text`, `srt`, `vtt`, `verbose_json`.

## 5. Пример запроса (cURL)

```
curl https://ai.wormsoft.ru/api/v1/audio/transcriptions \
  -H "Authorization: Bearer <api_token>" \
  -F "file=@audio.mp3" \
  -F "model=gigaam" \
  -F "language=ru" \
  -F "response_format=text"
```

## 6. Пример на OpenAI SDK (Python)

```
from openai import OpenAI

client = OpenAI(
    api_key="<api_token>",
    base_url="https://ai.wormsoft.ru/api/v1",
)

with open("audio.mp3", "rb") as f:
    transcription = client.audio.transcriptions.create(
        model="gigaam",
        file=f,
        language="ru",
        response_format="text",
    )

print(transcription)
```

## 7. Тарификация

- **10 кредитов за секунду аудио** (округление вверх до целой секунды).
- Пока модель `whisper-large` тестируется, она работает по тем же ценам, что и `gigaam`.
- **После 20 мая** цена на `whisper-large` будет изменена.