AI Agents
MCP araç referansı
SimpliGen MCP sunucusunun AI ajanlarına sunduğu araçlar ve bunların arkasındaki yerel Control API.
SimpliGen bir MCP sunucusu (@simpligen/mcp) ile birlikte gelir ve çalışan SimpliGen uygulamasını yerel, token ile doğrulanmış bir bağlantı üzerinden bir AI ajanına bağlar. Ajan MCP araçlarını çağırır; sunucu bunları uygulamanın yerel Control API'sine iletir. Bunu ayarlamak için Bir ajan bağlayın bölümüne bakın.
Araçlar
| Araç | Ne yapar |
|---|---|
list_capabilities | Ajanın oluşturabileceği her ön ayarı (resim 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 (etkin bayrağı, base/edit/i2v için yüklenmiş ön ayar sayıları ve enhancePresets, yüklenmiş ölçeklendirme ön ayarlarının sayısı) raporla. |
start_engine | Yerel motor zaten çalışmıyorsa başlat. Motor durumunu döndür; soğuk başlatma çağrıyı aştığında, engineStarting true olur ve get_status ne zaman hazır olduğunu raporlar. Motor zaten çalışıyorsa hiçbir şey yapmaz ve hiçbir zaman eksik olanı yüklemez (konnektör 0.3.0 veya daha yeni). |
stop_engine | Yerel motoru durdur ve VRAM'ini serbest bırak. Bulut oluşturma etkilenmez (konnektör 0.3.0 veya daha yeni). |
restart_engine | Motoru yeniden başlat, özel bir düğüm yükledikten veya kaldırdıktan sonra veya takıldığında (konnektör 0.3.0 veya daha yeni). |
list_projects | Projeleri (oluşturmaları tutan kapsayıcılar) listele. |
create_project | Yeni bir proje oluştur. |
upload_file | Yerel bir resim veya videoyu yükle ve generate içinde kullanmak için bir tanıtıcı al. |
list_loras | Yüklenmiş kullanıcı LoRA'larını (ad, temel model, tetikleyici sözcükler) listele böylece generate içine geçirebilirsin. |
generate | Bir resim veya video oluşturmaya başla. local, cloud veya auto seç. İsteğe bağlı olarak loras: [{ name, weight }] (yerel backend, ön ayarları inputs.supportsLoras true olan; adlar için list_loras kullan) ve bir negativePrompt geç. options, adlandırılmış alanları (steps, cfg, seed, resolution, aspectRatio, durationSeconds) ve ön ayarın list_capabilities → options.controls altında bildirdiği herhangi bir Advanced Control'ü (unlock, shift veya high_steps gibi) üst düzey bir anahtar olarak alır (konnektör 0.2.0 veya daha yeni). Bir iş kimliği döndür. |
get_job | Bir işin durumunu ve sonucunu (bitmeden sonra çıkış yolunu da içeren) al. |
wait_for_result | Bir iş bitene, başarısız olana veya zaman aşımına uğrayana kadar bekle. |
list_jobs | Son oluşturma işlerini listele. |
cancel_job | Sıraya alınmış veya çalışan bir işi iptal et. |
prepare_preset | Yerel bir ön ayarın modellerini indirmeye başla, böylece çalışmaya hazır hale gelsin. |
get_result_image | Bitmemiş bir işin resmini görüntülemek için satır içi olarak döndür. Video sonuçları bir dosya yolu döndürür. |
list_recipe_blocks | Bir reçete yazma için yapı taşlarını listele: giriş noktaları (resim veya video oluştur, resmi düzenle, ölçeklendir) ve adım olarak kullanılabilir her ön ayar, her biri bağlantı noktası kontratı (ihtiyaç duyduğu girdiler, ne üretir, hangi giriş noktalarına uyar). |
compose_recipe | Üst düzey bir spesifikasyondan yeni bir reçete yaz (ön ayarlara sabitlenmiş sıralı adımlar, artı herhangi bir giriş) ve taslak olarak kaydet. SimpliGen portları otomatik olarak bağlar, adımdan adıma medya zincirini ve adım başına bir bilgi girişini, sonra doğrular. Reçete kimliğini artı doğrulamayı döndür. |
validate_recipe | Kaydedilmeden bir reçete spesifikasyonunu (veya ham bir yapılandırmayı) çalıştır ve düzeltmeden önce kesin hatalar al. |
list_recipes | Bu cihazda kaydedilmiş reçete taslakları listele. |
get_recipe | Kaydedilmiş bir reçeteyi ve tam yapılandırmasını kimliğe göre al. |
publish_recipe | Kaydedilmiş bir reçeteyi Creator Marketplace'e gönder (insan incelemesi için sıraya alınır). Bağlı bir hesap gerekir; bir kerelik token fiyatı ayarlanmadıkça ücretsiz yayınla. |
run_recipe | Yüklenmiş bir reçeteyi (UGC Studio ve Product Studio'dakiler veya taslak) girdileri doldurulmuş olarak çalıştır. 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 sade değerleri alır. Studioda Generate'i tıklamakla aynı ardışık düzen. Bir çalıştırma kimliği döndür. |
get_recipe_run | Bir reçete çalıştırmasının durumu: genel durum, her adım kendi durumu ve sonucu ile ve tamamlandığında nihai sonuç yolu. |
wait_for_recipe_run | Bir reçete çalıştırması bitene (veya bir zaman aşımı geçene) kadar engelle ve nihai çalıştırmayı döndür. |
list_recipe_runs | Bir reçetenin son çalıştırmaları durumları ve sonuçları ile. |
cancel_recipe_run | Çalışan bir reçeteyi durdur. Başka adımlar başlamaz; yerel havadaki bir adım kesilir. |
list_subjects | Bir reçetenin konu girişinin alabildiği her konu: karakterler ve ürünler, kimlikler ile. |
list_products | Bu cihazda kaydedilmiş ürünler. |
create_product | Yüklenmiş bir fotodan ürün oluştur (ad, açıklama, kategori) böylece Product Studio ve UGC reçeteleri kullanabilsin. Ürün kimliğini döndür. |
remove_product | Bir ürünü ve fotoğrafını sil. |
list_characters | Character Studio'daki tüm etkin karakterleri listele. |
get_character | Tek bir karakter hakkında detayları ve resimleri kimliğe göre al. |
list_character_features | Tüm kimlik özelliklerini (cilt tonu, saç, vb.) ve seçeneklerini listele, bir karakteri açıklama ile oluştururken kullanmak için. |
list_character_presets | Her karakter rolü için yüklenmiş ön ayarları listele: temel portre oluşturma, kimlik düzenleme, görüntüden videoya animasyon ve iyileştirme (ölçeklendirme). Her iyileştirme ön ayarı bir supportedScales dizisi içerir. |
create_character | Yeni bir karakter oluştur. Üç yolu destekler: açıkla (özellik seçimlerinden temel portre oluştur), yükle (kendi resminizi temel olarak kullan) ve görme-yeniden oluştur (ajan tarafından açıklanan özellikler bir kullanıcı fotoğrafından). Oluşturma modunda, araç dahili olarak yoklar temel portre hazır olana kadar ve hazır karakter nesnesini döndürür. Yükleme modunda, karakter hemen hazırdır. |
generate_character_image | Mevcut bir karakter için bilgi isteminden bir sahne resmi oluştur. Bu çağrı için hangi kimlik düzenleme ön ayarını kullanacağını seçmek için isteğe bağlı presetId kabul et. wait_for_result aracılığıyla yoklamak için bir veya daha fazla iş kimliğini döndür. |
generate_character_video | Mevcut bir karakter için hareketli bir video klip oluştur. İsteğe bağlı framePresetId (kare adımı için kimlik düzenleme ön ayarı) ve videoPresetId (canlandırma adımı için i2v ön ayarı) kabul et. Hem çerçeve hem de animasyon adımları için iş kimliklerini döndür. |
generate_character_frame | Bir karakteri canlandırmadan tek bir sabit kare oluştur. Çerçeveyi incelemek veya animasyon yapmadan önce geliştirmek istediğinde kullanışlı. İsteğe bağlı presetId kabul et. { jobIds: [...] } döndür; jobIds[0] kare iş kimliği olarak kullan. |
animate_character | Tamamlanmış bir çerçeveden veya herhangi bir tamamlanmış görüntü işinden bir karakter 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ğini döndür. |
set_character_preset | Görüntü oluşturma (imagePresetId) ve/veya video oluşturma (videoPresetId) için karakter başına yapışkan varsayılan ön ayarı ayarla. Bir varsayılanı temizlemek için null geç. generate_character_image ve generate_character_video sonraki çağrıları, çağrı başına geçersiz kılınmadıkça bu varsayılanları kullanır. |
enhance_character_media | Bir karakter resmini veya videosunu ölçeklendir veya geliştir. Kaynak tamamlanmış bir iş (jobId), yüklenmiş bir dosya (filePath tanıtıcı) veya karakter temel portresi (target: 'base') olabilir. scale (ölçeklendirme faktörü), keepResolution (ölçeklendir sonra kaynak boyutlarına geri yeniden boyutlandır daha keskin aynı boyutlu sonuç için) ve applyAsBase (ölçeklendirilmiş sonucu karakter temel portresi ile değiştir) kabul et. Bir iş kimliğini döndür. |
regenerate_character_base | Mevcut bir karakter için temel portre yerinde yeniden oluştur, isteğe bağlı olarak farklı bir temel ön ayara geç veya kimliği güncelle. Yeni karakter oluşturulmaz. Dahili olarak yoklar, yeni tabanı otomatik olarak kabul eder ve hazır karakter nesnesini döndürür. Ajan bundan sonra bir iş kimliğini yoklamak zorunda değildir. |
remove_character | Bir karakteri ve ilişkili verilerini kalıcı olarak sil. |
Nasıl bağlanır
Ajan MCP sunucusunu npx -y @simpligen/mcp ile stdio üzerinden çalıştırır. Sunucu uygulamaya bir eşleştirme tokeni (SIMPLIGEN_TOKEN) ile doğrular ve uygulamanın yerel portunu otomatik olarak bulur. SimpliGen uygulaması çalışıyor olmalıdır. Ayarlar altında, "Bir ajan bağlayın" bölümünde bir token oluştur.
Özel bir entegrasyon yapıyor musun?
MCP araçları herhangi bir dilden doğrudan çağırabileceğin yerel bir HTTP Control API'ye iletir. Control API referansına bakın.
Harcama sınırları
Her token bir harcama sınırı taşıyabilir. Boş bir sınır sınırsız bulut kullanımı anlamına gelir, 0 yerel oluşturma yalnızca anlamına gelir ve pozitif bir sayı bulut harcamasını o kadar çok krediye sınırlandırır. Yerel oluşturma her zaman izin verilir ve hiçbir zaman sınıra karşı sayılmaz.