Video Uretimi

/v1/video/generations, LLMTR uzerinden metin promptlarini video uretim islerine donusturur. Endpoint uzun suren provider islerini baslatir, sonuc tamamlanana kadar poll eder ve video URL'lerini OpenAI uyumlu yanit yapisinda dondurur.

Alibaba HappyHorse

HappyHorse modeli Alibaba uzerinden metinden video uretir. Model public katalog aktivasyonu oncesinde 5 saniyelik 720P canli dogrulama testinden gecirilmistir.

curl "$LLMTR_BASE_URL/v1/video/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/happyhorse-1.0-t2v",
    "prompt": "A miniature city built from cardboard and bottle caps comes alive at night. A cardboard train rolls slowly by with tiny lights.",
    "duration_seconds": 5,
    "resolution": "720P",
    "aspect_ratio": "16:9",
    "max_wait_seconds": 180,
    "max_budget_usd": 0.70
  }'

Alibaba Wan3.0-Video-Prime

alibaba/wan3.0-video-prime metinden video uretir ve ayni istekte referans medya kabul eder. Sure 2-30 saniye arasindadir; resolution degeri 480P, 720P veya 1080P olabilir. ratio icin kabul edilen degerler 16:9, 4:3, 1:1, 3:4, 9:16 ve adaptive. negative_prompt desteklenir.

curl "$LLMTR_BASE_URL/v1/video/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan3.0-video-prime",
    "prompt": "Ay isiginda cati uzerinde kosan bir kedi, uzakta sehir isiklari",
    "duration_seconds": 5,
    "resolution": "480P",
    "ratio": "adaptive",
    "max_wait_seconds": 180,
    "max_budget_usd": 0.50
  }'

Referans medya ile uretim

Model tek istekte birden fazla referans alir ve her referans turludur: first_frame ve last_frame baslangic/bitis karesini, reference_image genel bir gorsel referansi, reference_video bir kaynak videoyu, reference_audio bir ses parcasini belirtir.

last_frame tek basina kullanilamaz; bir interpolasyonun bitis karesi oldugu icin ayni istekte bir first_frame bulunmalidir. Yalniz gonderilirse 400 unsupported_input doner. Bu yuzden referanslar tekil image_url alaninda degil, media dizisinde gonderilir; image_url bu modellerde 400 unsupported_input doner.

media[].url icin hem https:// baglantisi hem de data:image/...;base64,... bicimi kabul edilir.

curl "$LLMTR_BASE_URL/v1/video/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan3.0-video-prime",
    "prompt": "Kamera yavasca yaklasiyor, karakter kameraya donuyor",
    "duration_seconds": 4,
    "resolution": "720P",
    "media": [
      { "type": "first_frame", "url": "https://ornek.com/kare.png" },
      { "type": "reference_audio", "url": "https://ornek.com/muzik.mp3" }
    ]
  }'

Referans medya gonderildiginde prompt alani istege baglidir; ikisi birden bos birakilamaz.

MiniMax H3

minimax/minimax-h3 metinden video uretir ve ayni istekte referans materyal kabul eder: ilk kare, son kare veya referans gorsel. Sure 5-15 saniye arasindadir; resolution yalnizca 2K olabilir.

minimax/minimax-h3-max yalnizca metinden video ve gorselden video calisir: baslangic karesi, bitis karesi veya ikisi birden verilebilir, baska referans turu kabul etmez. Sure 5-15 saniye arasindadir; resolution degeri 480P veya 768P olabilir.

Iki modelde de prompt zorunludur ve en fazla 7000 karakter olabilir. negative_prompt desteklenmez; gonderilirse 400 unsupported_input doner.

curl "$LLMTR_BASE_URL/v1/video/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/minimax-h3",
    "prompt": "Sabah sisinin icinde ilerleyen bir tren, kamera yavasca yaklasiyor",
    "duration_seconds": 5,
    "resolution": "2K",
    "aspect_ratio": "16:9",
    "max_wait_seconds": 300,
    "max_budget_usd": 0.70
  }'

max_budget_usd istegin tahmini maliyetinin altinda kalirsa istek upstream'e hic gitmeden 400 budget_too_low doner. Yukaridaki ornek 5 saniye x $0.13 = $0.65 tutuyor, bu yuzden butce $0.70.

resolution gondermezseniz modelin en ucuz kademesi kullanilir: minimax/minimax-h3 icin 2K (tek kademe), minimax/minimax-h3-max icin 480P.

Referans medya ile uretim

Referanslar tekil image_url alaninda degil, media dizisinde gonderilir; image_url bu iki modelde 400 unsupported_input doner. Her referans turludur ve tur modele gore degisir:

Tur	minimax/minimax-h3	minimax/minimax-h3-max
first_frame	En fazla 1	En fazla 1
last_frame	En fazla 1	En fazla 1
reference_image	En fazla 9	Desteklenmiyor

minimax/minimax-h3 bir istekte toplam 11 dosyaya kadar kabul eder.

Kare ile referans ayni istekte gonderilemez. first_frame/last_frame ile reference_image bir arada verilirse 400 unsupported_input doner; upstream bu kombinasyonu kabul etmiyor. Ya kareleri gonderin ya referanslari.

media[].url icin hem https:// baglantisi hem de data: bicimi gonderilebilir; ikisi de dogrulandi. Buyuk dosyalar icin baglanti onerilir.

curl "$LLMTR_BASE_URL/v1/video/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/minimax-h3",
    "prompt": "Karakter kameraya donuyor ve gulumsiyor",
    "duration_seconds": 5,
    "resolution": "2K",
    "max_budget_usd": 0.70,
    "media": [
      { "type": "first_frame", "url": "https://ornek.com/kare.png" },
      { "type": "last_frame", "url": "https://ornek.com/son-kare.png" }
    ]
  }'

first_frame bir videonun ilk karesini sabitler; reference_image ise kareyi sabitlemeden konuyu tasir — ayni karakter, farkli sahne. Ikisi farkli islerdir ve ayni istekte birlestirilemez.

Referans gorsellerin ilk besi ucretsizdir; alti ve sonrasi icin gorsel basina $0.04 ucretlenir.

Referans ses (reference_audio) ve referans video (reference_video) su an kabul edilmiyor; gonderilirse 400 unsupported_input doner. Bu iki girdi sessizce yok sayilacagi icin kapali tutuluyor: kabul edilseler video ucretlenir ama referansin uretime hicbir etkisi olmaz.

Oran secimi

aspect_ratio istege baglidir. Gondermezseniz oran modele birakilir; baslangic karesi verdiyseniz oran o kareden gelir. Gonderirseniz su degerlerden biri olmalidir: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Baska bir deger 400 invalid_request doner.

adaptive bu iki modelde gecerli bir deger degildir; oranin gorselden gelmesini istiyorsaniz aspect_ratio alanini hic gondermeyin.

Google Veo

Google Veo modelleri ayni endpoint uzerinden calisir: google/veo-3.1-generate-001, google/veo-3.1-fast-generate-001, google/veo-3.1-lite-generate-001, google/veo-3.0-generate-001, google/veo-3.0-fast-generate-001 ve google/veo-2.0-generate-001. Veo 3.x ciktilari sesli uretilir.

Veo 3.0 ve Veo 2 kullanimdan kaldiriliyor

Google, 3.1 oncesi Veo uc noktalarini 28 Agustos 2026 tarihinde kapatiyor. Bu tarihe kadar uc model de normal calisir; sonrasinda bu kimliklere gelen istekler 410 model_retired doner ve yanit govdesi halefi adiyla soyler. Otomatik yonlendirme yoktur: entegrasyonunuzdaki model kimligini o tarihten once elinizle degistirin.

Kapanan kimlik	Halef	Fiyat farki
google/veo-3.0-generate-001	google/veo-3.1-generate-001	720p/1080p ayni ($0.40/s), 4k $0.40 yerine $0.60/s
google/veo-3.0-fast-generate-001	google/veo-3.1-fast-generate-001	Birebir ayni ($0.10 / $0.12 / $0.30)
google/veo-2.0-generate-001	google/veo-3.1-generate-001	$0.35/s yerine $0.40/s; cikti artik sesli uretilir

Veo 2'den geciste maliyet onceliginiz varsa google/veo-3.1-lite-generate-001 ayni sesli ciktiyi 720p $0.05, 1080p $0.08/saniye ile verir; 4k desteklemez.

curl "$LLMTR_BASE_URL/v1/video/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3.1-fast-generate-001",
    "prompt": "A cinematic drone shot over Cappadocia at sunrise",
    "duration_seconds": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "max_wait_seconds": 180,
    "max_budget_usd": 1.00
  }'

Gorsel referans ile video (image-to-video)

Veo modelleri image_url alaninda base64 data URL olarak verilen bir referans karesinden video uretebilir. Remote URL desteklenmez; data:image/...;base64,... bicimi zorunludur ve remote URL gonderilirse 400 unsupported_input doner.

curl "$LLMTR_BASE_URL/v1/video/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3.1-fast-generate-001",
    "prompt": "The person smiles and looks around, subtle camera push-in.",
    "image_url": "data:image/png;base64,iVBORw0KGgo...",
    "duration_seconds": 4,
    "resolution": "720p",
    "max_wait_seconds": 180
  }'

Veo yanitlarinda video, data[].b64_json alaninda base64 MP4 olarak doner; url alani bu modellerde null olur.

xAI Grok Imagine

xai/grok-imagine-video metin promptundan video uretir. xai/grok-imagine-video-1.5 ise image-to-video calisir: bir baslangic karesi zorunludur ve prompt hareketi tanimlar. Grok Imagine Video 1.5 ses efektleri, ambiyans ve konusmayi ayni geçişte uretir. Desteklenen sure 1-15 saniye; cozunurlukler 480p, 720p ve 1080p (1080p yalniz image-to-video).

Baslangic karesi image_url alaninda base64 data URL olarak gonderilir. Model yalniz image-to-video oldugu icin image_url olmadan gonderilen istek 400 invalid_request doner; metinden videoya grok-imagine-video modeline image_url gonderilirse 400 unsupported_input doner.

curl "$LLMTR_BASE_URL/v1/video/generations" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "xai/grok-imagine-video-1.5",
    "prompt": "Yavas sinematik push-in, korlar dagiliyor, hafif kamera hareketi",
    "image_url": "data:image/png;base64,iVBORw0KGgo...",
    "duration_seconds": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "max_wait_seconds": 180,
    "max_budget_usd": 1.00
  }'

xAI yanitlarinda video data[].url alaninda barindirilan MP4 olarak doner. Saglayici gercek maliyeti bildirdiginde ucretlendirme o maliyet uzerinden yapilir; bildirmediginde asagidaki saniye bazli fiyat uygulanir.

Parametreler

Alan	Aciklama
model	Video uretim modelinin kanonik ID'si.
prompt	Uretilecek videonun metin aciklamasi.
duration_seconds	Uretilecek video suresi. HappyHorse icin pozitif tam sayi kullanin. Wan3.0 icin 2-30 saniye. MiniMax H3 ve MiniMax H3 Max icin 5-15 saniye (tam sayi). Veo icin 4-8 saniye araligi desteklenir. Grok Imagine icin 1-15 saniye.
resolution	HappyHorse icin 720P veya 1080P. Wan3.0 icin 480P, 720P veya 1080P. MiniMax H3 icin yalnizca 2K, MiniMax H3 Max icin 480P veya 768P. Veo icin 720p, 1080p veya 4k (Veo 3.1 Lite 4k desteklemez). Grok Imagine icin 480p, 720p veya 1080p.
aspect_ratio	Oran degeri. Varsayilan 16:9.
negative_prompt	Videoda istenmeyen ogelerin aciklamasi (Veo ve Wan3.0). HappyHorse ve MiniMax H3 modelleri desteklemez.
image_url	Image-to-video referans karesi, base64 data URL. Google Veo (tum Veo modelleri) destekler ve xai/grok-imagine-video-1.5 icin zorunludur. MiniMax H3 modelleri kabul etmez; kareyi media dizisinde gonderin.
media	Referans medya dizisi (alibaba/wan3.0-video-prime, minimax/minimax-h3, minimax/minimax-h3-max). Her oge type ve url alanlarini tasir. Wan3.0 icin first_frame, last_frame, reference_image, reference_video veya reference_audio; MiniMax H3 icin first_frame, last_frame veya reference_image; MiniMax H3 Max icin yalnizca first_frame ve last_frame. Wan3.0'da last_frame yalnizca bir first_frame ile birlikte gecerlidir.
max_wait_seconds	Uzun suren is icin bekleme ust siniri. Varsayilan 300, en fazla 600 saniye.
max_budget_usd	Gateway'in istegi baslatmadan once kontrol ettigi harcama ust siniri.

Uretim suresi ve bekleme

Video uretimi saniyeler degil dakikalar surer. Wan3.0 icin olculen degerler (2026-08-25): 480P 2 saniyelik klip 88 sn, 480P 3 saniyelik 110 sn, 720P 2 saniyelik 83 sn, 480P 10 saniyelik 83 sn. Yani sure ne cozunurlukle ne klip uzunluguyla olcekleniyor; fark saglayici tarafindaki yuk dalgalanmasindan geliyor.

max_wait_seconds gondermezseniz 300 saniye kullanilir; bu olculen en yavas kosunun yaklasik uc kati. Kendi isinizin uzun surdugunu biliyorsaniz 600 saniyeye kadar cikabilirsiniz.

Bekleme suresi asilirsa istek 504 provider_timeout doner ve hesabinizdan ucret alinmaz; ancak saglayici tarafinda uretim tamamlanmis olabilir. Bu yuzden sureyi gereginden kisa tutmayin.

Yanit

{
  "id": "task_xxx",
  "object": "video.generation",
  "model": "alibaba/happyhorse-1.0-t2v",
  "status": "completed",
  "data": [
    {
      "url": "/media/generated-video.mp4",
      "mime_type": "video/mp4",
      "duration": 5
    }
  ],
  "usage": {
    "duration": 5,
    "resolution": "720P"
  }
}

data[].url her zaman dogrudan indirilebilir bir baglantidir. MiniMax H3 satirlarinda bu baglanti LLMTR uzerinden sunulur:

GET $LLMTR_BASE_URL/v1/video/generations/{id}/content

Bu adres API anahtariniz ile cagrilir ve yalnizca isi baslatan hesaba acilir; baska bir hesabin isi 404 doner. Yaniti dogrudan video baytlaridir, yani tarayicida acabilir veya curl -L -o video.mp4 ile indirebilirsiniz:

curl -L "$LLMTR_BASE_URL/v1/video/generations/ePzVZ4WJzbTK1un5FiGx/content"   -H "Authorization: Bearer llmtr-your_key"   -o video.mp4

Uretilen videolar saglayici tarafinda kalicidir denemez; isi tamamladiktan sonra indirmeniz onerilir. Baglanti gecerliligini yitirmisse 404 not_found doner.

Fiyatlandirma

Video modelleri saniye bazli fiyatlanir; model fiyatina platform marji eklenmez.

Model	480p	720p	768p	1080p	2K	4k
xai/grok-imagine-video	-	$0.05/s	-	$0.05/s	-	-
xai/grok-imagine-video-1.5	-	$0.08/s	-	$0.08/s	-	-
alibaba/happyhorse-1.0-t2v	-	$0.14/s	-	$0.24/s	-	-
alibaba/wan3.0-video-prime	$0.068/s	$0.14/s	-	$0.28/s	-	-
minimax/minimax-h3	-	-	-	-	$0.13/s	-
minimax/minimax-h3-max	$0.05/s	-	$0.08/s	-	-	-
google/veo-3.1-generate-001	-	$0.40/s	-	$0.40/s	-	$0.60/s
google/veo-3.1-fast-generate-001	-	$0.10/s	-	$0.12/s	-	$0.30/s
google/veo-3.1-lite-generate-001	-	$0.05/s	-	$0.08/s	-	-
google/veo-3.0-generate-001 (28 Agustos 2026'da kapaniyor)	-	$0.40/s	-	$0.40/s	-	$0.40/s
google/veo-3.0-fast-generate-001 (28 Agustos 2026'da kapaniyor)	-	$0.10/s	-	$0.12/s	-	$0.30/s
google/veo-2.0-generate-001 (28 Agustos 2026'da kapaniyor)	-	$0.35/s	-	$0.35/s	-	-