← Cloudflare Stream / stream / edit-videos

Создание клипов из видео

Обрезка видео, также называемая «тримминг» или изменением длительности видео, позволяет изменить начальную и конечную точки видео, чтобы зрители видели только определённый «фрагмент» видео. Например, если у вас есть 20-минутное видео, а поделиться нужно только пятиминутным фрагментом из середины, можно обрезать видео, удалив содержимое до и после этого пятиминутного фрагмента.

См. Документация по API нарезки видео, где это описано подробнее.

Прежде чем создавать клип из видео, вам понадобится API-токен. Подробнее о создании API-токена см. Создание API-токенов.

Чтобы вырезать фрагмент видео, определите время начала и окончания, которые нужно взять из исходного видео для создания нового. Используйте videoUID и время начала и окончания для выполнения запроса.

{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 20,
	"endTimeSeconds": 40
}

• clippedFromVideoUID: Уникальный идентификатор видео, используемого для создания нового обрезанного видео.
• startTimeSeconds: Отметка времени в исходном видео, указывающая, с какого момента начинается новое видео.
• endTimeSeconds: Отметка времени в исходном видео, указывающая, на каком моменте заканчивается новое видео.
  
  

curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts/<YOUR_ACCOUNT_ID_HERE>/stream/clip' \
--header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
    "startTimeSeconds": 10,
    "endTimeSeconds": 15
    }'

Вы можете проверить, готово ли ваше видео к воспроизведению на Stream странице дашборда Cloudflare.

Пока обрезанное видео обрабатывается, в ответе о статусе видео отображается В очереди. Когда процесс обрезки видео завершится, статус видео изменится на Готово и отображает новое имя обрезанного видео и его новую длительность.

Чтобы получать уведомление о завершении обработки видео и его готовности к воспроизведению, вы можете подписка на уведомления webhook.

При обрезке видео можно также указать новое имя для получившегося ролика. В примере ниже name поле указывает новое имя для обрезанного видео.

{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"meta": {
		"name": "overriding-filename-clip.mp4"
	}
}

После обрезки и обработки видео с новым именем появится в списке видео на панели управления Cloudflare.

Вы также можете добавить собственный водяной знак к видео. Подробнее о водяных знаках и загрузке профиля водяного знака см. Применение водяных знаков.

{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"watermark": {
		"uid": "4babd675387c3d927f58c41c761978fe"
	},
	"meta": {
		"name": "overriding-filename-clip.mp4"
	}
}

При обрезке видео вы можете сделать его закрытым и доступным только определённым пользователям, с обязательным подписанным URL-адресом.

{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"requireSignedURLs": true,
	"meta": {
		"name": "signed-urls-demo.mp4"
	}
}

После завершения создания клипа откройте дашборд Cloudflare и список видео, чтобы найти нужное видео. При выборе видео Настройки вкладка отображает галочку рядом с Require Signed URLs.

Вы также можете указать миниатюру для видео в процентном значении. Чтобы преобразовать временную метку миниатюры из секунд в проценты, разделите нужную временную метку на общую длительность видео. Подробнее о миниатюрах см. Отображение миниатюр.

{
	"clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
	"startTimeSeconds": 10,
	"endTimeSeconds": 15,
	"thumbnailTimestampPct": 0.5,
	"meta": {
		"name": "thumbnail_percentage.mp4"
	}
}