API v2 · 38 edge-узлов

CDN для видео
по одному API

Конвертируйте, кешируйте и раздавайте видео через российские и зарубежные узлы. Один токен — задачи, статусы, готовые файлы и трафик без сюрпризов.

✓ Без карты ✓ 10 ГБ трафика в подарок ✓ TLS 1.3 и подписанные ссылки
api.convertcdn.ru TLS 1.3
$curl -X POST https://api.convertcdn.ru/v1/jobs \
-H "Authorization: Bearer $CDN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"source_url": "https://cdn.example.com/input.mov",
"format": "mp4"
}'
202 Accepted 284 ms req_7c1f
{
  "id": "job_8f3a91c2",
  "status": "queued",
  "output": { "format": "mp4", "quality": "1080p" },
  "cdn": { "region": "ru-central", "edge": "msk-03" }
}
99,95%SLA на доставку
38точек присутствия
120 мсp50 до первого байта
4K HDRMP4, WebM и HLS
01 · Быстрый старт

Три шага до первого файла

Никаких SDK и сложной настройки: обычный HTTP и JSON. Токен для демо уже подставлен в песочницу ниже.

01

Получите токен

Ключ создаётся в панели за минуту. В примерах используется переменная CDN_API_KEY.

02

Отправьте задачу

Вызовите POST /v1/jobs со ссылкой на исходник и нужным форматом. Ответ придёт сразу — с идентификатором задачи.

03

Заберите результат

Следите за статусом через GET /v1/jobs/{id} и скачивайте файл с ближайшего edge-узла по подписанной ссылке.

curl -X POST https://api.convertcdn.ru/v1/jobs \
  -H "Authorization: Bearer $CDN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_url": "https://cdn.example.com/input.mov",
    "format": "mp4",
    "quality": "1080p"
  }'
02 · Эндпоинты

Шесть эндпоинтов закрывают весь сценарий

Создание задачи, статус, файл, отмена и расход ресурсов. Все ответы — JSON, авторизация через Bearer-токен.

Базовый URL https://api.convertcdn.ru/v1
POST /v1/jobs

Создаёт задачу конвертации и ставит результат в очередь CDN.

  • source_urlссылка на исходное видео
  • formatmp4, webm или hls
  • quality720p, 1080p, 4k
  • cdn.regionрегион раздачи
GET /v1/jobs/{id}

Возвращает статус, прогресс и ссылку на готовый файл.

  • idидентификатор задачи
  • fieldsкакие поля вернуть
GET /v1/files/{id}

Метаданные файла и подписанная ссылка с ограниченным сроком жизни.

  • idидентификатор файла
  • ttlсрок жизни ссылки, секунды
DELETE /v1/jobs/{id}

Отменяет задачу и освобождает вычислительные ресурсы.

  • idидентификатор задачи
GET /v1/usage

Показывает расход трафика, минуты конвертации и остаток лимитов.

  • periodмесяц в формате 2026-11
GET /v1/status

Состояние регионов и задержки edge-узлов в реальном времени.

  • regionфильтр по региону
03 · Песочница

Попробуйте API без регистрации

Выберите эндпоинт, отправьте запрос и посмотрите на ответ. Это безопасный демо-режим: запросы не покидают браузер.

api.convertcdn.ru mock
Демо-лимит: 5 запросов / 10 секунд
Запрос POST /v1/jobs
Сценарии:

Ключ демонстрационный. Ответы генерируются в браузере и никуда не отправляются.

Ответ —
Отправьте запрос, чтобы увидеть ответ
// здесь появится JSON

Журнал запросов

последние 5
  • Пока пусто — отправьте первый запрос
04 · Сеть и лимиты

38 узлов, один договор

Трафик уходит с ближайшей точки присутствия. Ниже — демонстрационные задержки и лимиты тарифа Pro.

Edge-узлы онлайн
  • Москва MSK-0311 мс
  • Санкт-Петербург LED-0218 мс
  • Екатеринбург SVX-0127 мс
  • Новосибирск OVB-0139 мс
  • Франкфурт FRA-0434 мс
  • Алматы ALA-0241 мс

Задержка p50 до первого байта · обновляется каждые 5 секунд

Лимиты Pro на ноябрь
Запросов в минуту
600
Одновременных задач
20
Максимальный файл
4 ГБ
Хранение результата
24 часа
Ретраи
3 с backoff
Коды ошибок шпаргалка
  • 400Некорректный JSON в теле
  • 401Нет или неверный токен
  • 404Задача или файл не найдены
  • 422Не прошла валидация полей
  • 429Превышен лимит запросов
  • 5xxОшибка на стороне CDN
05 · Тарифы

Платите за трафик, а не за панели

Начните бесплатно, подключите Pro для продакшена или соберите Scale под свой объём.

Free

0 ₽/мес

Для тестов и небольших проектов.

  • 10 ГБ трафика в месяц
  • 60 запросов в минуту
  • 2 одновременные задачи
  • MP4 до 1080p
  • Хранение 6 часов
Начать бесплатно

Scale

от 12 000 ₽/мес

Для высоких нагрузок и своих регионов.

  • Трафик по договору
  • 6 000 запросов в минуту
  • 100 одновременных задач
  • Выделенные edge-узлы
  • Хранение до 7 дней
  • Поддержка 24/7
Запросить расчёт