> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aigenda.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Загрузка по ссылке

> AiGenda сама скачает файл по прямой ссылке.

Подходит, когда запись уже лежит в облаке, в телефонии или в CRM. Вы передаёте ссылку, AiGenda скачивает файл в фоне.

```bash theme={null}
curl -X POST https://api.aigenda.tech/api/spaces/1024/audio/by_url/ \
  -H "Authorization: Bearer <access>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://records.example.com/calls/2026-10-17/client-call.mp3",
    "title": "Звонок с клиентом 17.10.mp3",
    "content_type": "audio/mpeg"
  }'
```

| Поле | Правило |
| - | - |
| `url` | Прямая ссылка на файл, до 255 символов. Файл должен скачиваться по ней без авторизации, cookies и промежуточных страниц |
| `title` | До 255 символов, **заканчивается расширением файла** |
| `content_type` | MIME-тип файла, например `audio/mpeg` |

## Что дальше

Запрос отвечает сразу, а файл AiGenda скачивает уже после ответа. Поэтому:

1. Возьмите `id` записи из ответа.
2. Опрашивайте [`info/`](/api-reference/audio/info) раз в 3–5 секунд, пока не придёт `is_uploaded: true`.
3. Запустите [обработку](/processing/start).

<Warning>
  Загрузка по ссылке сама обработку не запускает. Без вызова `classify` запись так и останется необработанной.
</Warning>

<Tip>
  Ссылки из облачных хранилищ с подписью (S3, Яндекс Облако) бывают длиннее 255 символов. Если ссылка не помещается, скачайте файл у себя и загрузите его [файлом](/upload/file).
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.