Наговори

Быстрый старт

Быстрый старт

Получите первую транскрипцию аудио за 5 минут.

1. Создайте API-ключ

Перейдите в Профиль и найдите раздел API-ключи. Нажмите Создать ключ, задайте имя и скопируйте сгенерированный ключ.

Ваш ключ выглядит так: nag_a1b2c3d4e5f6...

Важно: Скопируйте ключ сразу — он отображается только один раз.

2. Загрузите и транскрибируйте

С помощью cURL

# Шаг 1: Получите presigned URL для загрузки
curl -X POST https://api.nagovori.ru/v1/uploads/presign \
  -H "Authorization: Bearer nag_ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "meeting.mp3",
    "content_type": "audio/mpeg",
    "size_bytes": 5242880
  }'

# Шаг 2: Загрузите файл по presigned URL
curl -X PUT "URL_ЗАГРУЗКИ_ИЗ_ШАГА_1" \
  -H "Content-Type: audio/mpeg" \
  --data-binary @meeting.mp3

# Шаг 3: Создайте транскрипцию
curl -X POST https://api.nagovori.ru/v1/transcriptions \
  -H "Authorization: Bearer nag_ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "object_key": "OBJECT_KEY_ИЗ_ШАГА_1",
    "filename": "meeting.mp3",
    "content_type": "audio/mpeg",
    "size_bytes": 5242880,
    "language": "auto"
  }'

С помощью Python

import requests

API_KEY = "nag_ВАШ_API_КЛЮЧ"
BASE = "https://api.nagovori.ru/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Presign загрузки
presign = requests.post(f"{BASE}/uploads/presign", headers=headers, json={
    "filename": "meeting.mp3",
    "content_type": "audio/mpeg",
    "size_bytes": 5_242_880,
}).json()

# Загрузка файла
with open("meeting.mp3", "rb") as f:
    requests.put(presign["upload_url"], data=f, headers={"Content-Type": "audio/mpeg"})

# Создание транскрипции
result = requests.post(f"{BASE}/transcriptions", headers=headers, json={
    "object_key": presign["object_key"],
    "filename": "meeting.mp3",
    "content_type": "audio/mpeg",
    "size_bytes": 5_242_880,
    "language": "auto",
}).json()

print(f"ID транскрипции: {result['id']}, Статус: {result['status']}")

3. Проверьте статус

Опрашивайте статус транскрипции до получения статуса completed:

curl https://api.nagovori.ru/v1/transcriptions/ID_ВАШЕЙ_ТРАНСКРИПЦИИ \
  -H "Authorization: Bearer nag_ВАШ_API_КЛЮЧ"

Ответ содержит transcript_text когда статус completed.

Следующие шаги

← ВведениеАутентификация →