Referansv1.0.0 Kararlı

AI Video to Prompt API belgeleri

Yüksek performanslı yapay zeka görsel üretim yeteneklerini entegre edin. Bu dokümantasyon, geliştiricilerin hızlı bir şekilde yapay zeka görsel uygulamaları oluşturmasına yardımcı olmak için eksiksiz API referansı, entegrasyon rehberleri ve kod örnekleri sunar.

https://aivideotoprompt.com

Hızlı başlangıç

İlk API çağrınızı yalnızca iki adımda tamamlayın: bir üretim görevi gönderin ve ardından durumu sorgulayın.

Görev gönder

Bir görev kimliği (Task ID) almak için generate uç noktasına POST isteği gönderin.

Durumu sorgula

Görsel URL’sini alana kadar ilerlemeyi kontrol etmek için görev kimliğini kullanın.

Kimlik doğrulama

Not: Lütfen API anahtarınızı güvenli tutun ve istemci tarafı kodda ortaya çıkarmayın.

HTTP başlığı

Authorization: Bearer {YOUR_API_KEY}

POST

https://aivideotoprompt.com/api/generate

Yeni bir görsel üretim görevi oluşturur. Bu uç nokta asenkron çalışır ve task_id ile ilk durumu döndürür; tamamlanan görselleri almak için /api/status çağrısı yapın.

Bu uç nokta hemen task_id döndürür. Görsel URL’lerini almak için durum SUCCESS olana kadar /api/status uç noktasını düzenli aralıklarla sorgulayın.

Gövde parametreleri

Parametre adı	Tür	Zorunlu	Açıklama
`prompt`	string	Evet	Üretim için metin promptu (en fazla 1000 karakter).
`aspect_ratio`	string	Evet	Üretilen görselin en boy oranı. İzin verilen değerler: 1:1, 4:3, 3:4, 16:9, 9:16.

Yanıt (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://aivideotoprompt.com/api/status

Bir görevin yürütme durumunu ve sonuçlarını sorgular.

Sorgu parametreleri

Parametre adı	Zorunlu	Açıklama
`task_id`	Evet	Görev gönderilirken döndürülen kimlik.

Yanıt örneği

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

Faturalandırma

Üretim başına maliyet

$0.02 / istek

Başarısız görevler için ücret alınmaz.

Hata yönetimi

401 YetkisizGeçersiz API anahtarı
402 Ödeme gerekliYetersiz bakiye
429 Çok fazla istekÇok fazla istek

AI Video to Prompt hakkında

AI Video to Prompt, yüklenen referans klipleri zaman kodlu çekim listelerine ve düzenlenebilir promptlara dönüştürür. Bir çekimi seçtiğiniz video modeline uyarlayın veya öznesini değiştirin, ardından yeni sürüm üretmek için video çalışma alanını açın. Görsel aracı da sabit bir görseli aynı prompttan çalışma alanına geçiş akışıyla işler.

Z-Image-Turbo — 6B parametreli, ultra hızlı metinden görsele model

Z-Image-Turbo, gecikme ve throughput’un kritik olduğu üretim iş yükleri için tasarlanmış, Tongyi-MAI tarafından geliştirilen 6 milyar parametreli bir metinden görsele modeldir. Tam bir görseli oluşturmak için yalnızca 8 örnekleme adımı kullanır; veri merkezi GPU’larında saniyenin altında gecikmeye ulaşır ve 16 GB VRAM’e sahip birçok tüketici kartında rahatça çalışır.

Üretime hazır kaliteyle ultra hızlı üretim

Pek çok difüzyon modeli düzinelerce adıma ihtiyaç duyarken, Z-Image-Turbo 8 adımlı bir örnekleyici etrafında agresif biçimde optimize edilmiştir. Bu, çıkarımı son derece hızlı tutarken fotorrealistik görseller ve güvenilir görsel üzeri metin sunar; böylece yalnızca offline toplu işler için değil, etkileşimli ürünler, panolar ve büyük ölçekli backend’ler için de güçlü bir seçenek haline gelir.

Neden bu kadar iyi görünüyor?

Yüksek hızda fotorrealistik çıktı — Ürün fotoğrafları, kahraman görselleri ve arayüz görselleri için, çok saniyelik beklemeler olmadan yüksek sadakatli, gerçekçi görseller üretir.
İki dilli prompt ve metin — İngilizce ve Çince prompt’ları anlar ve görselin içine doğrudan çok dilli metin yerleştirebilir; bu da çok pazarlı kampanyalar, posterler ve ekran görüntüleri için kullanışlıdır.
Düşük adım sayısıyla düşük gecikme — Görsel başına yalnızca 8 fonksiyon değerlendirmesi, sohbet botları, yapılandırma araçları, tasarım asistanları ve herhangi bir “tıkla → görsel” deneyimi için ideal, son derece düşük gecikme sunar.
VRAM dostu ayak izi — 16 GB VRAM’li ortamlarda iyi çalışır, donanım maliyetlerini düşürür ve yerel ya da edge dağıtımlarını daha gerçekçi kılar.
Toplu üretim için ölçeklenebilir — Verimliliği; kataloglar, sürekli görsel akışları veya otomatik oluşturulan küçük resimler gibi büyük işleri, hesaplama bütçesini aşmadan pratik hale getirir.
Yeniden üretilebilir çıktılar — Kontrol edilebilir tohum parametresi, önceki bir görseli yeniden üretmenize veya marka güvenliği ve denemeler için küçük, kontrollü varyasyonlar oluşturmanıza imkân tanır.

Nasıl kullanılır

promptprompt – sahneyi, stili ve görsel üzerindeki metni (İngilizce veya Çince) anlatan doğal dilde açıklama.
sizesize (genişlik / yükseklik) – çıktı çözünürlüğünü seçin; kare ve dikdörtgen görselleri, yüksek çözünürlüklere kadar (örneğin 1536 × 1536) destekler.
seedseed – rastgele sonuçlar için -1 olarak ayarlayın veya çıktıları yeniden üretilebilir kılmak için sabit bir tam sayı kullanın.

Görsel üretim çalışma alanı Görselden prompt