Stream

Stream nedir?

“Cloudflare Stream lets you or your end users upload, store, encode, and deliver live and on-demand video with one API, without configuring or maintaining infrastructure.” “Stream automatically encodes and delivers videos using the H.264 codec with adaptive bitrate streaming, supporting resolutions from 360p to 1080p.”

Video işinin normalde ayrı ayrı çözülen beş parçası — depolama, kodlama, paketleme, dağıtım ve oynatıcı — tek bir API’nin arkasında. Canlı yayında bunun anlamı daha da büyük: Cloudflare’in kendi ifadesiyle “live video must be re-encoded in real-time into multiple resolutions… running a fleet of virtual machines doesn’t come cheap.”

“R2’ye bir MP4 koysam olmaz mı?”

Bu sorunun cevabı çoğu zaman olur — ve bunu söyleyen Cloudflare’in kendisi:

“For customers with a huge volume of short video, such as generative AI output, e-commerce product videos, social media clips, or short marketing content, uploading those assets to Stream is not always practical. Furthermore, Stream’s key features like adaptive bitrate encoding and HLS packaging offer diminishing returns on short content or small files.”

Maliyet tarafında bir not daha: “Video stored in Stream does not incur additional storage fees from other storage products such as R2.”

Nasıl çalışır?

Yükleme yolları

Kabul edilen kaynak formatlar: MP4, MKV, MOV, AVI, FLV, MPEG-2 TS, MPEG-2 PS, MXF, LXF, GXF, 3GP, WebM, MPG, QuickTime. Dosya 30 GB’ın altında olmalı.

Önerilen girdi: “MP4 containers, AAC audio codec, H264 video codec, 60 or fewer frames per second.” Kare hızı serbest ama “Stream re-encodes videos for a maximum of 90 FPS playback” ve değişken kare hızlı içerikte fazla kareler düşürülüyor.

Canlı yayın

Akış dört adımda işliyor: her yayın için bir live input oluşturuluyor, her input’un bir Stream Key’i oluyor, yayıncı RTMPS veya SRT ile bağlanıyor, Cloudflare çoklu çözünürlükte kodlayıp izleyiciye dağıtıyor.

rtmps://live.cloudflare.com:443/live/<STREAM_KEY>

SRT’nin farkı: “SRT supports newer video codecs and makes using accessibility features, such as captions and multiple audio tracks, easier.” Ama tek modda — “Stream only supports the SRT caller mode.”

Live input’un dikkat edilmesi gereken parametreleri:

Gecikme — belgelenmiş rakamlar

Oynatma

<iframe src="https://customer-<CODE>.cloudflarestream.com/<VIDEO_UID>/iframe"
  style="border: none" height="720" width="1280"
  allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;"
  allowfullscreen="true"></iframe>

Kendi oynatıcını kullanacaksan:

https://customer-<CODE>.cloudflarestream.com/<UID>/manifest/video.m3u8
https://customer-<CODE>.cloudflarestream.com/<UID>/manifest/video.mpd
https://customer-<CODE>.cloudflarestream.com/<UID>/manifest/video.m3u8?protocol=llhls

Oynatıcı parametreleri querystring ile veriliyor: autoplay, controls, muted, loop, preload, poster, primaryColor, letterboxColor, startTime (?startTime=1h12m27s biçimini de kabul ediyor), defaultTextTrack, ve reklam için ad-url (VAST tag). Renk ve poster değerleri URI-encoded olmalı. Hata ayıklama menüsü: video oynarken Shift-D.

Erişim kontrolü

requireSignedURLs açıldığında “This option will prevent any public links… from working.”

Token üretmenin üç yolu var ve seçim ölçeğe bağlı:

Token içinde exp (“Cannot be greater than 24 hours in the future”), accessRules (en fazla 5 kural; IP ve ISO ülke kodu ile) ve downloadable alanları var. Ayrıca allowedOrigins ile hotlink engellenebiliyor — ama kuralı bilmek şart: “example.com does not cover www.example.com or any subdomain of example.com” ve “There is no path support.”

Ne zaman kullanılır, ne zaman kullanılmaz

Uygun olduğu işler

• Uzun form video kütüphanesi — kurs, konferans kaydı, arşiv
• Canlı yayın: RTMPS/SRT girdi, otomatik ABR, otomatik kayıt, 50 hedefe simulcast
• Kullanıcı yüklemeli video (Direct Creator Upload) — API token’ı istemciye vermeden
• Ülke veya IP bazlı erişim kısıtı gereken içerik
• Altyazı gereken içerik — Türkçe dahil, tr kodu belgelenmiş

Uygun olmadığı işler

• Kısa ve küçük klipler. Cloudflare’in kendi ifadesiyle ABR ve HLS paketlemesi bu içerikte azalan getiri veriyor; R2 + Media Transformations daha doğru.
• Orijinal dosyayı geri istemek. Yüklediğin dosya geri verilmiyor.
• HDR teslim. Yüklenen HDR video SDR’a yeniden kodlanıyor.
• Chromium. “Cloudflare Stream is not available on Chromium, as Chromium does not support H.264 videos.”
• DRM gerektiren içerik. Belgelenmemiş — imzalı URL ve erişim kuralları var, DRM yok.
• Canlıda watermark. “Watermarks cannot yet be used with live videos.”
• Türkiye’de veri yerelleştirme. Uyumluluk matrisinde Stream, Regional Services için ✘.

Somut örnekler

1. R2’deki bir videoyu Stream’e almak

curl -X POST \
  -H "Authorization: Bearer $CF_API_TOKEN" \
  -d '{"url":"https://depo.ornek.com/tanitim.mp4","meta":{"name":"Tanıtım videosu"}}' \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream/copy"

2. tus ile büyük dosya

tus-upload --chunk-size 52428800 \
  --header Authorization "Bearer $CF_API_TOKEN" \
  ./konferans-kaydi.mp4 \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream"

Upload-Metadata ile geçilebilen anahtarlar: name, requiresignedurls, scheduleddeletion, allowedorigins, thumbnailtimestamppct, watermark. Yükleyeni işaretlemek için Upload-Creator başlığı.

3. Kayıtlı canlı yayın açmak

curl -X POST \
  -H "Authorization: Bearer $CF_API_TOKEN" \
  -d '{"meta":{"name":"webinar"},"recording":{"mode":"automatic"},"deleteRecordingAfterDays":30}' \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream/live_inputs"

recording.mode varsayılanı off — bunu yazmazsan yayın kaydedilmiyor ve HLS/DASH ile izlenemiyor.

4. Ülke bazlı erişim kuralı

{
  "exp": 1788300000,
  "accessRules": [
    { "type": "ip.geoip.country", "action": "allow", "country": ["TR"] },
    { "type": "any", "action": "block" }
  ]
}

En fazla 5 kural; sıra önemli ve son kural genellikle catch-all oluyor.

5. Thumbnail ve hareketli önizleme

.../thumbnails/thumbnail.jpg?time=12s&height=270&fit=crop
.../thumbnails/thumbnail.gif?time=12s&height=200&duration=4s&fps=8

“Viewing animated thumbnails does not count toward billed minutes delivered.” Ama bir kısıt var: “Stream thumbnails are not supported for videos with non-square pixels.”

6. Anahtar rotasyonu

curl -X POST -H "Authorization: Bearer $CF_API_TOKEN" \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream/live_inputs/$INPUT_ID/rotate_keys"

“old credentials are revoked, broadcasts using stale credentials are disconnected, and refreshed credentials are returned in the API response.”

Demo 1: Ubuntu’dan canlı yayın ve codec hatasını üretmek

Ön koşullar: Ubuntu sunucu, ffmpeg, jq, Stream aboneliği olan bir Cloudflare hesabı.

sudo apt update && sudo apt install -y ffmpeg jq curl
export CF_ACCOUNT_ID="<hesap-id>"
export CF_API_TOKEN="<Stream:Edit yetkili token>"

Adım 1 — Live input oluştur

curl -s -X POST \
  -H "Authorization: Bearer $CF_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"meta":{"name":"ubuntu-demo"},"recording":{"mode":"automatic"}}' \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream/live_inputs" \
  | tee /tmp/input.json | jq '{uid:.result.uid, rtmps:.result.rtmps.url, key:(.result.rtmps.streamKey[0:12]+"…")}'

export INPUT_UID=$(jq -r '.result.uid' /tmp/input.json)
export STREAM_KEY=$(jq -r '.result.rtmps.streamKey' /tmp/input.json)

Terminal — jq çıktısında uid, rtmps.url (rtmps://live.cloudflare.com:443/live/) ve kısaltılmış stream key. Anahtarın tamamı ekranda olmasın

Adım 2 — Doğru codec ile yayın aç

ffmpeg -re -f lavfi -i testsrc2=size=1280x720:rate=30 \
       -f lavfi -i sine=frequency=440:sample_rate=48000 \
  -c:v libx264 -preset veryfast -tune zerolatency -b:v 3000k -maxrate 3000k -bufsize 6000k \
  -pix_fmt yuv420p -g 120 -keyint_min 120 -sc_threshold 0 \
  -c:a aac -b:a 128k -ar 48000 -ac 2 \
  -f flv "rtmps://live.cloudflare.com:443/live/$STREAM_KEY"

Parametrelerin karşılıkları: -g 120 -keyint_min 120 -sc_threshold 0 → 30 fps’te 4 saniyelik sabit closed GOP (zorunluluk); -c:v libx264 → H.264 (zorunluluk); -c:a aac → AAC (zorunluluk); -b:v 3000k → 12 Mbps’in çok altında (öneri).

Terminal — ffmpeg çıktısında Stream mapping satırları ve ilerleyen frame= / bitrate= sayacı

Adım 3 — Yayının canlıya geçtiğini doğrula

Başka bir bölmede:

CODE=$(curl -s -H "Authorization: Bearer $CF_API_TOKEN" \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream/live_inputs/$INPUT_UID" \
  | jq -r '.result.uid')

curl -s "https://customer-$CUSTOMER_CODE.cloudflarestream.com/$INPUT_UID/lifecycle" | jq .
curl -s "https://customer-$CUSTOMER_CODE.cloudflarestream.com/$INPUT_UID/views"     | jq .

lifecycle çıktısında "live": true ve bir videoUID görmelisin.

İki bölmeli terminal — solda ffmpeg akmaya devam ediyor, sağda lifecycle çıktısında live: true ve videoUID, altında liveViewers sayacı

Adım 4 — Tarayıcıda izle

https://customer-<CODE>.cloudflarestream.com/<INPUT_UID>/watch

Tarayıcı — Stream oynatıcısında test görüntüsü oynuyor, canlı göstergesi ve kalite seçimi görünür durumda

Adım 5 — Belgelenmiş hatayı üret: desteklenmeyen codec

Ctrl+C ile durdur, sonra MP3 ses ve VP8 video ile dene — ikisi de belgelenmiş zorunlulukları ihlal ediyor:

ffmpeg -re -f lavfi -i testsrc2=size=640x360:rate=30 \
       -f lavfi -i sine=frequency=440 \
  -c:v libvpx -b:v 1000k -c:a libmp3lame -b:a 128k \
  -f flv "rtmps://live.cloudflare.com:443/live/$STREAM_KEY"

Bağlantı kuruluyor ama yayın izlenebilir hâle gelmiyor. lifecycle live: false kalıyor.

İki bölmeli terminal — solda ffmpeg'in bağlantı kurup veri göndermesi, sağda lifecycle çıktısında live: false; ikisinin aynı anda olduğu net görünsün

Adım 6 — Değişken keyframe aralığını da sına

# -g ve -sc_threshold YOK: x264 sahne degisimine gore keyframe koyar
ffmpeg -re -f lavfi -i testsrc2=size=1280x720:rate=30 -f lavfi -i sine=frequency=440 \
  -c:v libx264 -preset veryfast -b:v 3000k -pix_fmt yuv420p \
  -c:a aac -b:a 128k -ar 48000 \
  -f flv "rtmps://live.cloudflare.com:443/live/$STREAM_KEY"

# Uretilen akisin keyframe araligini olc
ffprobe -v error -select_streams v -show_entries frame=key_frame,pts_time \
  -of csv=p=0 -read_intervals '%+20' /tmp/ornek.flv | grep '^1' | head

Terminal — ffprobe çıktısında keyframe zaman damgaları; sabit GOP'ta düzenli aralıklar, değişken GOP'ta düzensiz aralıklar yan yana

Adım 7 — Kaydı doğrula ve temizle

Doğru yayını 2–3 dakika akıtıp durdur, sonra:

sleep 70
curl -s -H "Authorization: Bearer $CF_API_TOKEN" \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream/live_inputs/$INPUT_UID/videos" \
  | jq '.result[] | {uid, status:.status.state, duration, created}'

Kayıt “within 60 seconds after a live stream ends” hazır oluyor.

# Temizlik
curl -s -X DELETE -H "Authorization: Bearer $CF_API_TOKEN" \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream/live_inputs/$INPUT_UID"

Terminal — kayıt listesinde status ready, süre ve oluşturma zamanı; panelde Stream Analytics'te üretilen dakikalar da eklenebilir

Demo 2: İmzalı URL ve ülke kuralını Türkiye’den kanıtlamak

Bu demo iki şeyi aynı karede gösteriyor: erişim kuralının çalıştığı, ve isteğin gerçekten Türkiye’den, İstanbul PoP’undan gittiği.

Adım 1 — Videoyu imzalı hâle getir

export VID="<video-uid>"
curl -s -X POST -H "Authorization: Bearer $CF_API_TOKEN" \
  -H "Content-Type: application/json" -d '{"uid":"'"$VID"'"}' \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream/$VID" \
  --data '{"requireSignedURLs": true}' | jq '.result.requireSignedURLs'

# Imzasiz erisimin kapandigini kanitla
curl -s -o /dev/null -w "imzasiz: %{http_code}\n" \
  "https://customer-$CUSTOMER_CODE.cloudflarestream.com/$VID/manifest/video.m3u8"

Terminal — requireSignedURLs true yanıtı ve altında imzasız manifest isteğinin döndürdüğü HTTP kodu

Adım 2 — İmzalama anahtarı üret

curl -s -X POST -H "Authorization: Bearer $CF_API_TOKEN" \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream/keys" \
  | tee /tmp/key.json | jq '{id:.result.id}'

Yanıttaki PEM’i sakla — bir daha gösterilmiyor.

Terminal — anahtar id'si görünür, PEM içeriği bulanıklaştırılmış veya kadraj dışında

Adım 3 — Türkiye’yi engelleyen token üret

pip install --quiet pyjwt cryptography

python3 - <<'PY'
import jwt, json, time, base64, os
d = json.load(open('/tmp/key.json'))['result']
pem = base64.b64decode(d['pem']).decode()
payload = {
  "sub": os.environ["VID"],
  "kid": d["id"],
  "exp": int(time.time()) + 3600,
  "accessRules": [
    {"type": "ip.geoip.country", "action": "block", "country": ["TR"]},
    {"type": "any", "action": "allow"},
  ],
}
print(jwt.encode(payload, pem, algorithm="RS256", headers={"kid": d["id"]}))
PY

Terminal — python çıktısında üretilen JWT'nin ilk ve son bölümleri; payload'daki accessRules bloğu da ayrıca gösterilebilir

Adım 4 — Türkiye’den dene ve iki şeyi birden kanıtla

export BLOCKTOK="<uretilen-jwt>"

curl -s -o /dev/null -w 'TR''den: http=%{http_code}\n' \
  "https://customer-$CUSTOMER_CODE.cloudflarestream.com/$BLOCKTOK/manifest/video.m3u8"

curl -s https://speed.cloudflare.com/meta | jq '{country: .country, colo: .colo, ip: .clientIp}'

Terminal, tek kare — üstte http=403, altında country: TR ve colo: IST. Bu iki satırın aynı görüntüde olması demonun bütün değeri

Adım 5 — Tersini kanıtla

Aynı betiği "action": "allow", "country": ["TR"] ve sondaki kuralı {"type":"any","action":"block"} yapıp tekrar çalıştır — bu kez 200 dönmeli.

Terminal — aynı formatta http=200 ve country: TR / colo: IST satırları

Adım 6 — Hotlink engelini kur

curl -s -H "Authorization: Bearer $CF_API_TOKEN" -H "Content-Type: application/json" \
  --data "{\"uid\":\"$VID\",\"allowedOrigins\":[\"ornek.com\"]}" \
  "https://api.cloudflare.com/client/v4/accounts/$CF_ACCOUNT_ID/stream/$VID" \
  | jq '.result.allowedOrigins'

curl -s -o /dev/null -w "yabanci origin: %{http_code}\n" \
  -H "Origin: https://baska-site.com" \
  "https://customer-$CUSTOMER_CODE.cloudflarestream.com/$VID/manifest/video.m3u8"

curl -s -o /dev/null -w "dogru origin:   %{http_code}\n" \
  -H "Origin: https://ornek.com" \
  "https://customer-$CUSTOMER_CODE.cloudflarestream.com/$VID/manifest/video.m3u8"

Terminal — iki HTTP kodu alt alta; yabancı origin reddedilmiş, doğru origin geçmiş

Adım 7 — Faturaya etkisini gör

Panel: Stream → Analytics. Bu demonun ürettiği Minutes Delivered rakamına bak.

Panel ekran görüntüsü — Minutes Delivered grafiği ve bu demoya karşılık gelen artış

Ölçüm tablosu

Fiyatlandırma

Rakamlar 1 Eylül 2026’da Stream pricing sayfasından alındı; workers.cloudflare.com/pricing, ürün sayfası ve Stream Live dokümanı aynı rakamları veriyor — dört resmî kaynak tutarlı.

“Stream bills on two dimensions only: Minutes of video stored… Minutes of video delivered… Ingress (sending your content to us) and encoding are always free. Bandwidth is already included in ‘video delivered’ with no additional egress (traffic/bandwidth) fees.”

Depolama tüketenler: yüklenen orijinal videolar, RTMP/SRT canlı yayın kayıtları, ve tamamlanmamış Direct Creator / tus yüklemeleri için ayrılan maxDurationSeconds.

Depolama tüketmeyenler: hatalı veya oynatılamaz videolar, süresi dolmuş Direct Creator linkleri, silinen videolar, MP4 indirme için üretilen dosyalar, ve Stream’in her orijinal için ürettiği çoklu kalite seviyeleri.

Cloudflare’in kendi örneği: iki kişi otuz dakikalık bir videoyu izlerse “This will result in 60 minutes of Minutes Delivered usage (or $0.06).”

Media Transformations — aynı kotayı paylaşıyor

Stream dışındaki videoları dönüştürmek (/cdn-cgi/media/…) Stream metriklerinden değil, Images kotasından yiyor:

“Media Transformations and Image Transformations use the same subscriptions and usage metrics.” “Generating a still frame (single image) from a video counts as 1 transformation.” “Generating an optimized video or extracting audio counts as 1 transformation per second of the output content.” “All Media and Image Transformations cost $0.50 per 1,000 monthly unique transformation operations, with a free monthly allocation of 5,000.”

Sınırları: girdi en fazla 100 MB ve 10 dakika; çıktı boyutu 10–2000 piksel; duration 1s–60s; time 0–10m. Ve “Media Transformations are not compatible with Bring Your Own IP (BYOIP).”

Lisanslama ve hukuki çerçeve

Stream tescilli bir hizmettir ve Cloudflare Hizmet Şartlarına tabidir.

Veri yerelleştirme — Stream için yol yok. Data Localization uyumluluk matrisi:

¹ “Logs / Analytics not available outside US region when using Customer Metadata Boundary.”

Saklama ve silme. Abonelik yenilenmezse “Videos are removed if the subscription is not renewed within 30 days.” Otomatik silme için scheduleddeletion veya deleteRecordingAfterDays kullanılıyor — ikisi de minimum 30, maksimum 1.096 gün.

Analitik saklama. GraphQL Analytics API için: tek sorguda en fazla 31 günlük aralık, veri saklama 90 gün.

Altyazı ve erişilebilirlik. WebVTT zorunlu, dil kodu BCP 47. Türkçe için Cloudflare’in kendi tablosunda tr kodu açıkça listelenmiş — erişilebilirlik yükümlülüğü olan kurumsal projeler için kullanılabilir bir dayanak.

Sık yapılan hatalar

recording.mode değerini yazmamak

Varsayılan off. Bunu automatic yapmazsan yayın kaydedilmiyor ve HLS/DASH ile izlenemiyor — yayın canlıda görünse bile.

Değişken keyframe aralığı bırakmak

OBS ve benzeri araçlarda varsayılan çoğu zaman otomatik. Cloudflare sabit değer istiyor: “change it to a specific value such as four seconds.” Bu, “Connected ama izlenemiyor” arızasının bir numaralı sebebi.

AAC yerine başka bir ses codec’i göndermek

“Stream Live only supports H.264 video and AAC audio codecs as inputs.” MP3 gönderirsen bağlantı kurulur ama yayın izlenebilir hâle gelmez.

Manifest’i önbelleğe almak

Manifest dinamik. Kendi CDN’inde tutarsan segment formatı değiştiğinde 404 almaya başlarsın.

Location başlığından video ID ayrıştırmak

stream-media-id başlığını kullan.

allowedOrigins’in alt alan adlarını kapsadığını sanmak

ornek.com yazmak www.ornek.com’u kapsamıyor, ve yol desteği hiç yok.

Direct Creator Upload rezervasyonunu hesaba katmamak

maxDurationSeconds değeri anında depolamandan düşülüyor. Cömert bir değer verip çok sayıda link açarsan kotanı kullanılmayan rezervasyonlarla doldurabilirsin.

Yedi günden uzun yayın yapmak

“If a live video exceeds seven days in length, the recording will be truncated to seven days.”

Kısa klipler için Stream kullanmak

ABR ve HLS paketlemesi kısa içerikte azalan getiri veriyor, ama depolama ve teslim faturası işlemeye devam ediyor. R2 + Media Transformations daha uygun.