← Cloudflare Stream / stream

Transformace videí

Můžete optimalizovat a upravovat videa uložená mimo Cloudflare Stream s Media Transformations. Transformovaná videa a obrázky se poskytují z jedné z vašich zón na Cloudflare.

Chcete-li transformovat video nebo obrázek, musíte povolit transformace pro vaši zónu. Pokud má vaše zóna již povoleny Image Transformations, můžete videa optimalizovat také pomocí Media Transformations.

Můžete dynamicky optimalizovat a generovat statické obrázky z videí uložených mimo Cloudflare Stream s Media Transformations.

Cloudflare automaticky uloží do mezipaměti každé transformované video nebo obrázek na naší globální síti, takže na svém originu budete uchovávat pouze originální obrázek.

Chcete-li povolit transformace pro svou zónu:

1. V dashboardu Cloudflare přejděte na Transformace stránce.

   Přejděte na Transformace ↗

2. Vyhledejte konkrétní zónu, ve které chcete povolit transformace.

3. Vyberte Povolit pro zónu.

Videa můžete převádět a měnit jejich velikost tak, že o ně požádáte prostřednictvím speciálně formátované URL, aniž byste museli psát jakýkoli kód. Formát URL je následující:

https://example.com/cdn-cgi/media/<OPTIONS>/<SOURCE-VIDEO>

• example.com: Váš web nebo zóna na Cloudflare s povolenou funkcí Transformations.
• /cdn-cgi/media/: Předpona, která označuje speciální cestu zpracovávanou vestavěnou službou Cloudflare pro transformaci médií.
• <OPTIONS>: Seznam možností oddělených čárkami. Dostupné možnosti najdete níže.
• <SOURCE-VIDEO>: Úplná URL adresa (začínající https:// nebo http://) původního souboru, u kterého se mění velikost.

Například tato URL adresa načte video ve vysokém rozlišení z bucketu R2, zkrátí ho, ořízne a změní jeho velikost na čtverec a odstraní zvuk.

https://example.com/cdn-cgi/media/mode=video,time=5s,duration=5s,width=500,height=500,fit=crop,audio=false/https://pub-8613b7f94d6146408add8fefb52c52e8.r2.dev/aus-mobile-demo.mp4

Výsledkem je soubor MP4, který lze použít v HTML elementu video bez knihovny přehrávače.

Určuje typ výstupu, který se má vygenerovat.

• video: Výstupem je soubor MP4 optimalizovaný pro H.264/AAC.
• frame: Výstupem je statický obrázek.
• spritesheet: Výstupem je JPEG s více snímky.
• audio: Výstupem je soubor M4A kódovaný ve formátu AAC.

Určuje, kdy se má začít extrahovat výstup ve vstupním souboru. Závisí na mode:

• Když mode je spritesheet, video, nebo audio, určuje časovou značku, od které výstup začne.
• Když mode je frame, určuje časovou značku, ze které se má extrahovat statický snímek.
• Formátuje se jako časový řetězec, například: 5s, 2m
• Přijatelný rozsah: 0 až 10m
• Výchozí: 0

Délka výstupního videa nebo spritesheetu. Závisí na mode:

• Když mode je video nebo audio, určuje délku výstupu.
• Když mode je spritesheet, určuje časový rozsah, ze kterého se vybírají snímky.
• Přijatelný rozsah: 1s až 60s (nebo 1m)
• Výchozí: délka vstupu nebo 60 sekund, podle toho, co je kratší

V kombinaci s width a height, určuje způsob změny velikosti a oříznutí výstupu. Pokud se velikost výstupu mění, vždy se mění proporcionálně, aby nedošlo ke zkreslení obsahu.

• contain: Při zachování poměru stran zvětší nebo zmenší video tak, aby se celé vešlo do výstupních rozměrů.
• scale-down: Funguje stejně jako contain, ale video pouze zmenšuje, nikdy jej nezvětšuje.
• cover: Při zachování poměru stran zvětší nebo zmenší video tak, aby celé pokrylo výstupní rozměry, přičemž přebytečnou část ořízne se zaměřením na střed.

Určuje maximální výšku výstupu v pixelech. Přesné chování závisí na fit.

• Přijatelný rozsah: 10-2000 pixelů

Určuje maximální šířku obrázku v pixelech. Přesné chování závisí na fit.

• Přijatelný rozsah: 10-2000 pixelů

Když mode je video, určuje, zda má výstup obsahovat zdrojové audio.

• true: Zahrnuje zdrojový zvuk.
• false: Výstup bude bez zvuku.
• Výchozí: true

Když mode je audio, audio nemůže být false.

Pokud mode je frame, určuje formát obrazového výstupu.

• Přijatelné možnosti: jpg, png

Pokud mode je audio, určuje formát zvukového výstupu.

• Přijatelné možnosti: m4a (výchozí)

Určuje název souboru použitý v hlavičce Content-Disposition vrácené odpovědi. Pokud není zadán, název souboru se odvodí ze zdrojové URL adresy.

• Přijatelné hodnoty:
  • Maximální délka je 120 znaků.
  • Může obsahovat pouze malá písmena (a-z), čísla (0-9), spojovníky (-), podtržítka (_) a volitelně příponu. Platný název odpovídá tomuto regulárnímu výrazu: ^[a-zA-Z0-9-_]+.?[a-zA-Z0-9-_]+$.
• Příklady: default.mp4, shortened-clip_5s

• Vstupní video musí mít méně než 100MB.
• Vstupní video by měl být formát MP4 s videem enkódovaným pomocí H.264 a zvukem enkódovaným pomocí AAC nebo MP3. Jiné formáty mohou fungovat, ale nejsou testované.
• Origin musí podporovat HTTP HEAD i range requesty a musí vracet hlavičku Content-Range.

• Maximální velikost vstupního souboru je 100 MB. Maximální délka vstupního videa je 10 minut.
• Media Transformations nejsou kompatibilní s Bring Your Own IP (BYOIP).
• Vstupní video by měl být formát MP4 s videem enkódovaným pomocí H.264 a zvukem enkódovaným pomocí AAC nebo MP3, případně animovaný GIF. Jiné formáty mohou fungovat, ale nejsou testované.

Při používání Media Transformations z Cloudflare Workeru doporučujeme použít vazby. V opačném případě, pokud Worker volá Media Transformations ve stejné zóně, která je použita jako jeho trigger, použijte global_fetch_strictly_public příznak kompatibility, abyste se vyhnuli chybám 404 u /cdn-cgi/media cest.

Od November 1st, 2025 budou Media Transformations a Image Transformations používat stejná předplatná a metriky využití.

• Vygenerování statického snímku (jednoho obrázku) z videa se počítá jako 1 transformace.
• Vygenerování optimalizovaného videa nebo extrakce zvuku se počítá jako 1 transformace za sekundu výstupu obsah.
• Každá jedinečná transformace, určená vstupem a jedinečnou kombinací příznaků, se účtuje jen jednou za kalendářní měsíc.
• Všechny Media Transformations a Image Transformations stojí $0.50 za 1,000 měsíčních jedinečných transformačních operací, s bezplatným měsíčním přídělem 5,000.