> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Video Üretimi

> Açık kamu işlemleri, asenkron anket ve modele özgü medya girdileri ile videolar oluşturun.

Video üretimi asenkron bir süreçtir. `POST /v1/videos/generations` bir kamu görev kimliği ve genellikle bir `poll_url` döner; nihai video daha sonraki durum yanıtlarında görünür.

Seçilen Seedance modeli TokenLab materyal kitaplığını kullanabiliyorsa, görsel URL’leri ve desteklenen inline data URL’leri oluşturma öncesinde yeniden kullanılabilir TokenLab materyalleri olarak hazırlanır. Hazırlık 60 saniyeyi aşarsa, dönen `auto_material_asset_ids` değerleri `ACTIVE` olduktan sonra tekrar deneyin. Seçilen model materyal kitaplığını kullanamıyorsa normal görsel girdileri standart görsel yolunda devam eder.

## Kamu Sözleşmesi

Üretimde açık `operation` kullanın. TokenLab bazı işlemleri girdilerden çıkarabilir, ancak açık işlem değerleri doğrulama, destek ve yeniden denemeleri daha net hale getirir.

| İşlem                | Gerekli veya tipik girdi                                                              | Kullanım durumu                                  |
| -------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------ |
| `text-to-video`      | `prompt`                                                                              | Sadece metinden oluşturma                        |
| `image-to-video`     | `image_url` veya uyumlu `image`                                                       | Başlangıç görüntüsünü canlandırma                |
| `reference-to-video` | `reference_images` ve desteklenen modellerde isteğe bağlı `video_urls` / `audio_urls` | Kimliği, tarzı veya varlık referanslarını koruma |
| `start-end-to-video` | `start_image`, `end_image`                                                            | İlk ve son kareleri kontrol etme                 |
| `video-to-video`     | `video_url` veya modele özgü `task_id`                                                | Mevcut bir klibi dönüştürme veya büyütme         |
| `motion-control`     | `image_url` artı `video_url`                                                          | Bir konuya hareket referansı uygulama            |
| `audio-to-video`     | `audio_url`                                                                           | Ses koşullu video akışları                       |
| `video-extension`    | `task_id`, `extend_at` veya modele özgü genişletme alanları                           | Oluşturulan bir videoyu devam ettirme            |

## Model Keşfi

```bash theme={null}
curl "https://api.tokenlab.sh/v1/models?recommended_for=video" \\
  -H "Authorization: Bearer sk-your-api-key"
```

`model` alanında TokenLab’da görünen model IDlerini kullanın; özellik varyantlarını `operation` ve ilgili medya girdileriyle seçin. Örnekler: `wan-2.7`, `happyhorse-1.0`, `viduq3`, `viduq3-mix`, `pixverse-v6`, `kling-3.0-video`, `veo3.1`, `seedance-2.0`; operasyona özel ekleri TokenLab model adı olarak kullanmayın.

`reference_images`, `kling_elements`, `output_audio`, `duration`, `resolution` veya `aspect_ratio` gibi özel alanlara güvenmeden önce seçilen model detayını okuyun.

## İstek Oluşturma

```bash theme={null}
curl https://api.tokenlab.sh/v1/videos/generations \\
  -H "Authorization: Bearer sk-your-api-key" \\
  -H "Content-Type: application/json" \\
  -d '{
    "model": "veo3.1",
    "operation": "text-to-video",
    "prompt": "Güneş ışığıyla aydınlatılmış bir bahçede yürüyen bir kedinin sakin sinematik görüntüsü",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'
```

Üretim medya girişi için satır içi `data:` URL’leri yerine herkese açık `https` URL’lerini tercih edin. Geçici URL kullanıyorsanız, TokenLab görevi oluşturmayı bitirene kadar geçerli tutun.

## Girdiler ve Modele Özgü Alanlar

* Veo 3 ailesi istekleri `output_audio` atlandığında varsayılan olarak sesli açılır. Model bu geçişi destekliyorsa ve kullanıcı deneyiminiz sese bağlıysa, bunu açıkça ayarlayın.
* `kling_elements`, `kling-3.0-video` görüntü koşullu istekler içindir. Her bir öğeyi `prompt` içinde `@name` olarak referans gösterin; bunu `output_audio=true` ile birleştirmeyin.
* Seedance 2.0 ailesinde 4K çıktı, Fast/Mini çözünürlük sınırları veya çok modlu referans girdileri kullanmadan önce [Seedance 2.0 video modelleri kılavuzunu](/tr/guides/seedance-2-video) okuyun.
* `grok-imagine-video` için, video-to-video bir kamuya açık `.mp4` `video_url` kullanır; modele özgü sınırlamalar, örneğin `duration` ve `resolution`, model sözleşmesinden gelmelidir.

## PixVerse ve HappyHorse

| Model                        | İşlemler                                                                      | Girdiler                                                                    | Çözünürlük              | Süre                                                                                      | Ses seçici                         |
| ---------------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------- | ---------------------------------- |
| `pixverse-c1`, `pixverse-v6` | `text-to-video`, `image-to-video`, `start-end-to-video`, `reference-to-video` | `prompt`; `image_url`; `start_image` + `end_image`; `reference_images`      | 360p, 540p, 720p, 1080p | 1 ile 15 saniye arasında herhangi bir tam sayı                                            | `output_audio`, varsayılan `false` |
| `pixverse-v5.6`              | `text-to-video`, `image-to-video`, `start-end-to-video`, `reference-to-video` | C1 ve V6 ile aynı alanlar                                                   | 360p, 540p, 720p, 1080p | 5, 8 veya 10 saniye; 1080p, 5 veya 8 saniyeyi destekler                                   | `output_audio`, varsayılan `false` |
| `happyhorse-1.0`             | `text-to-video`, `image-to-video`, `reference-to-video`, `video-to-video`     | `prompt`; `image_url`; `reference_images`; `video_url` + `reference_images` | 720p, 1080p             | Oluşturma işlemleri için 3 ila 15 saniye; video-to-video çıktısı 15 saniye ile sınırlıdır | `output_audio` göndermeyin         |

TokenLab'de, yukarıdaki PixVerse modelleri `operation=video-extension`'ı kabul etmez.

```bash theme={null}
curl https://api.tokenlab.sh/v1/videos/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "operation": "image-to-video",
    "prompt": "A slow camera move through a neon-lit street",
    "image_url": "https://example.com/start.jpg",
    "resolution": "1080p",
    "duration": 5,
    "output_audio": true
  }'
```

## Anket Sonuçları

Öncelikle döndürülen `poll_url`'yi kullanın. Sabit bir uç noktaya ihtiyacınız varsa, oluşturma yanıtındaki aynı `id` / `task_id` ile `GET /v1/tasks/{id}` kullanın.

Tamamlanan video görevleri, modele ve çıktı sayısına bağlı olarak `video_url`, `video` veya `videos` dönebilir. `billing_transaction_id` değerini görev tanımlayıcısı değil, faturalama tanımlayıcısı olarak değerlendirin.

## Yaygın Hatalar

* Eski video durum yollarını sabit kodlamayın; `poll_url`'yi tercih edin.
* Model sözleşmesi izin vermedikçe, ilk kare alanlarını özel referans-görüntü akışları ile birleştirmeyin.
* `duration`'ın girdi referans video uzunluğunu tanımladığını varsaymayın; genellikle üretilen çıktı uzunluğunu kontrol eder.
* Bir zaman aşımından sonra oluşturma isteklerini yeniden denemeden önce bir görevin zaten oluşturulup oluşturulmadığını kontrol etmeyin.

## API Referansı

| Konu                        | Referans                                                      |
| --------------------------- | ------------------------------------------------------------- |
| Video Oluştur               | [Video Oluştur](/tr/api-reference/video/create-video)         |
| Video Durumunu Al           | [Video Durumunu Al](/tr/api-reference/video/get-video-status) |
| Görev Durumunu Al           | [Görev Durumunu Al](/tr/api-reference/tasks/get-task-status)  |
| Görevi İptal Et             | [Görevi İptal Et](/tr/api-reference/tasks/cancel-task)        |
| Faturalama ve Fiyatlandırma | [Faturalama ve Fiyatlandırma](/tr/guides/billing)             |

## OpenAI tarzı ve Volc uyumlu video API’leri

Modeller arasında TokenLab birleşik video API’si için `/v1/videos/generations` kullanın. Zaten Volc tarzı `content[]` veya Action istekleri kullanan mevcut bir Seedance 2.0 entegrasyonunu taşıyorsanız `/api/v3` altındaki Seedance uyumluluk endpoint’lerini kullanabilirsiniz. İki stil de TokenLab Bearer API key ve asenkron polling kullanır, ancak istek ve yanıt şekilleri farklıdır.