Создаёт задачу конвертации и ставит результат в очередь CDN.
source_urlссылка на исходное видеоformatmp4, webm или hlsquality720p, 1080p, 4kcdn.regionрегион раздачи
Конвертируйте, кешируйте и раздавайте видео через российские и зарубежные узлы. Один токен — задачи, статусы, готовые файлы и трафик без сюрпризов.
{
"id": "job_8f3a91c2",
"status": "queued",
"output": { "format": "mp4", "quality": "1080p" },
"cdn": { "region": "ru-central", "edge": "msk-03" }
}
Никаких SDK и сложной настройки: обычный HTTP и JSON. Токен для демо уже подставлен в песочницу ниже.
Ключ создаётся в панели за минуту. В примерах используется переменная CDN_API_KEY.
Вызовите POST /v1/jobs со ссылкой на исходник и нужным форматом. Ответ придёт сразу — с идентификатором задачи.
Следите за статусом через 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"
}'
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"
}'
const res = await fetch("https://api.convertcdn.ru/v1/jobs", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CDN_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
source_url: "https://cdn.example.com/input.mov",
format: "mp4",
quality: "1080p"
})
});
const job = await res.json();
console.log(job.id, job.status);
import os
import requests
res = requests.post(
"https://api.convertcdn.ru/v1/jobs",
headers={"Authorization": f"Bearer {os.environ['CDN_API_KEY']}"},
json={
"source_url": "https://cdn.example.com/input.mov",
"format": "mp4",
"quality": "1080p",
},
timeout=30,
)
job = res.json()
print(job["id"], job["status"])
Создание задачи, статус, файл, отмена и расход ресурсов. Все ответы — JSON, авторизация через Bearer-токен.
Создаёт задачу конвертации и ставит результат в очередь CDN.
source_urlссылка на исходное видеоformatmp4, webm или hlsquality720p, 1080p, 4kcdn.regionрегион раздачиВозвращает статус, прогресс и ссылку на готовый файл.
idидентификатор задачиfieldsкакие поля вернутьМетаданные файла и подписанная ссылка с ограниченным сроком жизни.
idидентификатор файлаttlсрок жизни ссылки, секундыОтменяет задачу и освобождает вычислительные ресурсы.
idидентификатор задачиПоказывает расход трафика, минуты конвертации и остаток лимитов.
periodмесяц в формате 2026-11Состояние регионов и задержки edge-узлов в реальном времени.
regionфильтр по регионуВыберите эндпоинт, отправьте запрос и посмотрите на ответ. Это безопасный демо-режим: запросы не покидают браузер.
/v1/jobs
Ключ демонстрационный. Ответы генерируются в браузере и никуда не отправляются.
// здесь появится JSON
Трафик уходит с ближайшей точки присутствия. Ниже — демонстрационные задержки и лимиты тарифа Pro.
Задержка p50 до первого байта · обновляется каждые 5 секунд
400Некорректный JSON в теле401Нет или неверный токен404Задача или файл не найдены422Не прошла валидация полей429Превышен лимит запросов5xxОшибка на стороне CDNНачните бесплатно, подключите Pro для продакшена или соберите Scale под свой объём.
Для тестов и небольших проектов.
Для видеоконвертера в продакшене.
Для высоких нагрузок и своих регионов.