AI Agents
MCP araç referansı
SimpliGen MCP sunucusunun AI aracılarına gösterdiği araçlar ve bunların arkasındaki yerel Control API.
SimpliGen bir MCP sunucusu (@simpligen/mcp) ile birlikte gelir ve bu sunucu bir AI aracısını çalışan SimpliGen uygulamasına yerel, token kimlik doğrulamalı bir bağlantı üzerinden bağlar. Araç, MCP araçlarını çağırır; sunucu bunları uygulamanın yerel Control API'sine iletir. Bunu ayarlamak için Bir aracıyı bağlayın bölümüne bakın.
Araçlar
| Araç | Yaptığı şey |
|---|---|
list_capabilities | Aracının oluşturabileceği her hazır ayarı (görüntü veya video), girdilerini ve seçeneklerini, yerel olarak hazır olup olmadığını, bulut uygunluğunu ve kredi maliyetini listele. |
get_status | Motor durumunu, buluta bağlı olup olmadığını, kredi bakiyesini, etkin projeyi ve characters yetenek bloğunu (etkinleştirme bayrağı, taban/düzenleme/i2v için yüklü hazır ayar sayıları ve enhancePresets, yüklü ölçeklendirme hazır ayar sayısı) bildir. |
start_engine | Yerel motor zaten çalışmıyorsa başlat. Motor durumunu döndür; soğuk bir önyükleme çağrıdan uzun sürerse engineStarting true olur ve get_status hazır olduğunda rapor eder. Motor zaten çalışıyorsa hiçbir şey yapmaz ve eksik olanı hiçbir zaman yüklemez (connector 0.3.0 veya daha yeni). |
stop_engine | Yerel motoru durdur ve VRAM'ini serbest bırak. Bulut üretimi etkilenmez (connector 0.3.0 veya daha yeni). |
restart_engine | Özel bir düğüm yükledikten veya kaldırdıktan sonra, ya da motor takılıp kaldığında yerel motoru yeniden başlat (connector 0.3.0 veya daha yeni). |
list_projects | Projeleri (nesilleri tutan konteynerleri) listele. |
create_project | Yeni bir proje oluştur. |
upload_file | Yerel görüntü veya videoyu yükle ve generate içine geçirmek için bir tanıtıcı al. |
list_loras | Yüklü kullanıcı LoRA'larını (ad, taban model, tetik kelimeleri) listele ve bunları generate içine geçirebilirsin. |
generate | Görüntü veya video üretimine başla. local, cloud veya auto seç. İsteğe bağlı olarak loras: [{ name, weight }] (yerel arka uç, hazır ayarlar burada inputs.supportsLoras true'dir; adlar için list_loras kullan) ve negativePrompt (ek terimler, hazır ayarın varsayılanının sonrasına eklenir; bulut çalıştırmalarında hazır ayarın varsayılanı olduğu gibi kullanılır) geç. options, adlandırılmış alanları (steps, cfg, seed, resolution, aspectRatio, durationSeconds) ve hazır ayarın list_capabilities → options.controls altında bildirdiği tüm Gelişmiş Kontrolleri, örneğin unlock, shift veya high_steps, üst düzey anahtar olarak alır (connector 0.2.0 veya daha yeni). Bir iş kimliği döndür. |
get_prompt_guide | Hazır ayarının istemini yazmadan önce (presetId) onun istemi kılavuzunu oku: model bir istemi nasıl okur, yapı, uzunluk, kamera ve hareket sözleşmesi, olumsuzlar, karakter sözleçmesi ve örnekler. Yanıt family, generic (model spesifik kılavuz yoksa true) ve kılavuz text taşır. Connector 0.6.0 veya daha yeni; generate aracılara önce çağrı yapmasını söyler. |
get_job | Bir işin durumunu ve sonucunu, sonlandırıldıktan sonra çıktı yolunu al. |
wait_for_result | Bir işin bitmesini, başarısız olmasını veya zaman aşımına uğramasını bekle. |
list_jobs | Son üretim işlerini listele. |
cancel_job | Sırada veya çalışan bir işi iptal et. |
prepare_preset | Yerel hazır ayarının modellerini indirmeye başla ve hazır hale getir. |
get_result_image | Tamamlanmış işin görüntüsünü görüntüleme için satır içinde döndür. Video sonuçları bir dosya yolu döndürür. |
list_recipe_blocks | Bir tarif yazması için yapı taşlarını listele: giriş noktaları (görüntü veya video oluştur, görüntüyü düzenle, ölçeklendir) ve bir adım olarak kullanılabilen her hazır ayar, her biri kendi bağlantı sözleşmesi ile (needing olduğu girdiler, ne ürettiği, hangi giriş noktalarına uyduğu). |
compose_recipe | Üst düzey bir belirtimden yeni bir tarif yazması yap (hazır ayarlara sabitlenmiş sıralı adımlar, artı herhangi bir giriş) ve bunu taslak olarak kaydet. SimpliGen bağlantı noktalarını otomatik kablolar, adım-adım medya zincirini ve adım başına bir istemi girişi, sonra doğrular. Tarif kimliği artı doğrulamayı döndür. |
validate_recipe | Kaydetmeden bir tarif belirtimini (veya ham bir yapılandırmayı) kuru çalıştır ve düzeltmek için kesin hatalar al. |
list_recipes | Bu cihazda kaydedilen tarif taslağını listele. |
get_recipe | Kaydedilen bir tarifi ve tam yapılandırmasını kimliğe göre al. |
publish_recipe | Kaydedilen bir tarifi Creator Marketplace'e gönder (insan incelemesi için sıraya alındı). Bağlı bir hesap gerekir; bir kerelik token fiyatı ayarlanmadığı sürece ücretsiz olarak yayınla. |
run_recipe | Yüklü bir tarifi (UGC Studio ve Product Studio'dakiler ya da bir taslak) girdileriyle doldurulmuş şekilde çalıştır. Bir konu girişi bir karakter veya ürün kimliği alır, medya girdileri yükleme tanıtıcılarını alır, metin ve seçim girdileri düz değerler alır. Studio'da Oluştur'u tıklamayla aynı işlem hattı. Bir çalıştırma kimliği döndür. |
get_recipe_run | Bir tarif çalıştırmasının durumu: genel durum, her adım kendi durumu ve sonucu ile, bittiğinde son sonuç yolu. |
wait_for_recipe_run | Bir tarif çalıştırmasının bitmesini (veya zaman aşımının geçmesini) engellemesi ve son çalıştırmayı döndür. |
list_recipe_runs | Bir tarifen son çalıştırmalar, durumları ve sonuçları. |
cancel_recipe_run | Çalışan bir tarifi durdur. Başka adım başlamaz; yerel uçak içi adım kesintiye uğratılır. |
list_subjects | Bir tarif konu girişinin alabileceği her konu: karakterler ve ürünler, kimlikleriyle. |
list_products | Bu cihazda kaydedilen ürünler. |
create_product | Yüklü bir fotoğraftan ürün kaydet (ad, açıklama, kategori), böylece Product Studio ve UGC tarifleri bunu kullanabilir. Ürün kimliğini döndür. |
remove_product | Bir ürünü ve fotoğrafını sil. |
list_characters | Karakter Studio'sunda tüm etkin karakterleri listele. |
get_character | Kimliğe göre tek bir karakterin ayrıntılarını ve görüntülerini al. |
list_character_features | Tüm kimlik özelliklerini (cilt tonu, saç, vb.) ve seçeneklerini listele, bir karakteri açıklama tarafından oluştururken kullanmak için. |
list_character_presets | Her karakter rolü için yüklü hazır ayarları listele: taban portre üretimi, kimlik düzenleme, görüntüden videoyu canlandırma ve iyileştirme (ölçeklendirme). Her iyileştirme hazır ayarı bir supportedScales dizisi içerir. |
create_character | Yeni bir karakter oluştur. Üç yolu destekler: tanımla (özellik seçimlerinden temel portre oluştur), yükle (kendi görüntünü taban olarak kullan) ve görü-yeniden oluştur (aracı tarafından tanımlanan özellikler bir kullanıcı fotoğrafından). Üretim modunda araç dahili olarak yoklama yapar ve temel portre hazır olana kadar değeri döndürür. Yükleme modunda karakter hemen hazırdır. |
generate_character_image | Mevcut bir karakter için isteme göre bir sahne görüntüsü oluştur. Bu çağrı için hangi kimlik düzenleme hazır ayarını kullanmak için seçmek üzere isteğe bağlı presetId kabul et. wait_for_result üzerinden yoklamak için bir veya daha fazla iş kimliği döndür. |
generate_character_video | Mevcut bir karakter için canlandırılmış bir video klip oluştur. İsteğe bağlı framePresetId (kare adımı için kimlik düzenleme hazır ayarı) ve videoPresetId (canlandırma adımı için i2v hazır ayarı) kabul et. Hem kare hem de canlandırma adımları için iş kimlikleri döndür. |
generate_character_frame | Bir karakter için canlandırmadan tek bir still kare oluştur. Karenin canlandırmadan önce gözden geçirmek veya iyileştirmek istediğinde yararlıdır. İsteğe bağlı presetId kabul et. { jobIds: [...] } döndür; kare iş kimliği olarak jobIds[0] kullan. |
animate_character | Tamamlanmış bir kareden veya herhangi bir tamamlanmış görüntü işinden karakteri canlandır. jobId (herhangi bir tamamlanmış üretimden bir iş kimliği) veya filePath (mutlak yerel görüntü yolu) geç. İsteğe bağlı videoPresetId kabul et. Bir video iş kimliği döndür. |
set_character_preset | Görüntü üretimi (imagePresetId) ve/veya video üretimi (videoPresetId) için karaktere özgü yapışkan varsayılan hazır ayarı ayarla. Bir varsayılanı temizlemek için null geç. Sonraki generate_character_image ve generate_character_video çağrıları çağrı başına geçersiz kılınmadıkça bu varsayılanları kullanır. |
enhance_character_media | Karakter görüntüsünü veya videosunu ölçeklendir veya iyileştir. Kaynak tamamlanmış işi (jobId), yüklenmiş dosyayı (filePath tanıtıcısı) veya karakter taban portresini (target: 'base') olabilir. scale (ölçeklendirme faktörü), keepResolution (ölçeklendir sonra aynı boyuta döndür daha keskin aynı boyuttlu sonuç için) ve applyAsBase (karakter taban portresini ölçeklendirilmiş sonuçla değiştir) kabul et. Bir iş kimliği döndür. |
regenerate_character_base | Mevcut bir karakterin taban portresini yerine yeniden oluştur, isteğe bağlı olarak farklı bir taban hazır ayarına geçiş yaparak veya kimliği güncelleyerek. Yeni karakter oluşturulmaz. Dahili olarak yoklama yapar, yeni tabanı otomatik olarak kabul eder ve hazır karakter nesnesini döndürür. Araç bundan sonra bir iş kimliğini yoklamak zorunda değildir. |
remove_character | Bir karakteri ve ilişkili verilerini kalıcı olarak sil. |
list_films | Bir projenin Video Studio filmlerini listele (connector 0.5.0 veya daha yeni, tüm film araçları da öyledir). |
create_film | Boş bir film oluştur: şekil, çözünürlük, nerede oluşturulacağı, her tür çekim için hazır ayarlar. Zaman çizelgesini yanıtla. |
get_film | Bir filmin zaman çizelgesini oku: tempo, desen, her klip kendi numarası, saniye ve barlarla başlama ve uzunluk, çekim ve alma durumu, izler, işaretçi ve dışa aktarma aralığı. |
update_film_settings | Filmin şeklini, çözünürlüğünü, nerede oluşturulacağını, hazır ayarlarını, Konu ve Stil'ini ve her klipin devral aldığı desen ve konumu değiştir. |
add_track | Yüklü ses dosyasını zaman çizelgesine koy: şarkı, müzik, diyalog veya efektler. |
move_track | İzin sesini taşı, sesini kapat veya hacmini ayarla. |
detect_tempo | Filmin temposunu ve bar çizgilerini şarkısından ayarla. Bundan sonra zamanlar barlarla verilebilir. |
add_clip | Bir anda boş bir klip ekle, bir uzunluk için. |
update_clip | Bir klipi tek adımda yaz: çekimler (istemi, uzunluk, konuşulan veya söylenen satır, kim söylüyor, çerçeveleme), desen, konum, nasıl başlıyor (yeni veya önceki klipten devam; none ve frame de kabul edilir, taze ve devam olarak), hangi izleri duyuyor, hazır ayar. |
move_clip | Klipi yeni bir başlangıca veya başka bir video şeridine taşı. |
trim_clip | Klipin uzunluğunu veya nerede başladığını değiştir, bunun içinde alınır. |
remove_clip | Bir klipi kaldır. |
apply_film_plan | Tüm taslağı tek adımda düzenle: klipler barlarla, çekimler, desen ve bağlantıları. Her sorun birdenbire geri gelir; geçerli olmaması dışında hiçbir şey değişmez. |
set_fades | Bir klipi veya bir izi içeri ve dışarı solarla. |
add_marker | Cetvel üzerine adlandırılmış bir işaretçi koy. |
set_export_range | Filmin yalnızca bir kısmını veya tamamını dışa aktar. |
render_clips | Gereken klipleri veya adlandırılmış olanları oluştur. Hemen neyin başladığını, neyin tutulduğunu ve bulut maliyetini yanıtla. |
wait_for_renders | Hiçbir klip oluşturulana kadar bekle ve zaman çizelgeyi yanıtla. |
list_takes | Bir klipin almalarını listele. |
use_take | Klipin bir alma göstermesini sağla. |
export_film | Filmi müziğiyle birlikte bir videoya dikiş ve dosya yolunu yanıtla. |
list_locations | Kütüphanenin konumlarını listele. |
create_location | Yüklü bir resimden veya tamamlanmış bir görüntü işinden bir konum kaydet. |
Video Studio'da film açıkken aracının yaptığı her değişiklik hemen görünür ve Ctrl+Z ile geri alınır. Tam bir örnek için Bir aracı bir müzik videosu yapıyor bölümüne bakın.
Nasıl bağlanır
Araç, MCP sunucusunu stdio üzerinden npx -y @simpligen/mcp ile çalıştırır. Sunucu uygulamaya bir eşleştirme belirteci (SIMPLIGEN_TOKEN) ile kimlik doğrulaması yapar ve uygulamanın yerel bağlantı noktasını otomatik olarak bulur. SimpliGen uygulaması çalışıyor olmalıdır. Ayarlar'ın altında "Bir aracıyı bağlayın" bölümünde bir belirteç çıkar.
Özel bir entegrasyon inşa ediyor musunuz?
MCP araçları herhangi bir dilden doğrudan çağırabileceğin yerel HTTP Control API'sine iletilir. Control API referansı bölümüne bakın.
Harcama sınırları
Her belirteç bir harcama sınırı taşıyabilir. Boş bir sınır sınırsız bulut kullanımı anlamına gelir, 0 yerel üretim anlamına gelir ve pozitif bir sayı bulut harcamasını o kadar çok krediye sınırlar. Yerel üretim her zaman izin verilir ve hiçbir zaman sınırına karşı sayılmaz.
Bir ajan müzik videosu oluşturuyor
Bir yapay zeka ajanına bir şarkı ve oyuncu kadrosu verin, Video Studio'da klip klip, canlı olarak müzik videosu oluştururken izleyin.
Control API referansı
SimpliGen'in makinenizde gösterdiği yerel HTTP API, özel entegrasyonlar oluşturmak ve nesli başsız çalıştırmak için.