Bir aracı kullanma

View as Markdown Open in ChatGPT Open in Claude

Bağlandıktan sonra aracınıza düz dille sorular sorun. Örneğin: "SimpliGen'in görüntü ön ayarlarını listele, ardından kar içindeki kırmızı bir tilki oluştur ve dosyayı bana göster."

Bir aracı neler yapabilir

Mevcut olanları görmek: oluşturabileceği her ön ayarı, görüntü veya video olarak, ve modellerin yerel olarak kurulu olup olmadığını.
Oluşturmak: bir isteniş için bir görüntü veya video işi başlatmak, isteğe bağlı referans görüntüler veya başlangıç görüntüsü ile. Yerel olarak, SimpliGen Cloud'da veya otomatik olarak seçerek çalıştırabilir.
İşleri izlemek: durumu kontrol etmek ve sonuç beklemek.
Sonuçları sunmak: bitmiş dosya yolunu döndürmek veya görüntüyü sohbette göstermek.
Ön ayarları hazırlamak: yerel bir ön ayarın modellerini indirmeye başlamak, böylece kullanıma hazır hale gelmesi.
Stüdyoları çalıştırmak: UGC Studio ve Product Studio'da kurulu olan reçeteleri listeleme, girdilerini doldurma (bir karakter, bir ürün, birkaç seçim) ve bunları çalıştırma, tıpkı Generate'e tıklamak gibi. Aşağıdaki UGC Studio ve Product Studio bölümüne bakın.

Oluşturmalar varsayılan olarak yerel olarak çalışır ve hiçbir zaman kredi maliyeti olmaz. Bulut, yalnızca SimpliGen Cloud bağlı olduğunda ve iyi davranışlı bir aracı kredi harcamadan önce sorduğunda sunulur (veya çalıştırdığınız herhangi bir otomatik onay modunu takip eder).

Bir aracıyı sınırlar içinde tutmak

Harcama üst sınırı. Bir aracı bağlandığında, isteğe bağlı bir bulut harcama üst sınırı ayarlayabilirsiniz. Aracı ne sorulursa sorulsun, bulut kredilerinde o tutardan fazla harcayamaz. Yerel oluşturma her zaman izin verilir ve hiçbir zaman bu tutara karşı sayılmaz. Sınırı boş bırakın sınırsız için, veya bulut tamamen engellemek için 0'a ayarlayın (yalnızca yerel).
Belirteçler yerel ve iptal edilebilir. Bir eşleştirme belirteci yalnızca kendi makinenizde SimpliGen'e karşı çalışır ve Bağlı aracılardan herhangi bir zaman iptal edebilirsiniz. İptal etmek anındır.
Uygulama kontrol altında kalır. Aracı SimpliGen ile iletişim kurar; bulut hesabınıza veya anahtarınıza doğrudan ulaşamaz.

Önce birkaç küçük olanı deneyin

Bir aracıya büyük bir grup vermeden önce, isteğini nasıl ifade ettiğini ve ne döndürdüğünü görebilmek için birkaç tekli yerel oluşturma deneyin.

Aracınız farklı bir makinede çalışırsa, Uzak erişim bölümüne bakın.

UGC Studio ve Product Studio

Her iki stüdyo da reçetelerin koleksiyonudur: ön üzerinde küçük bir form ile çok adımlı işlem hatları (bir düzenleme, bir ölçeklendirme, bir video). Bir aracı run_recipe aracılığıyla aynı reçeteleri çalıştırabilir.

Bir reçete bulun. list_recipes bu cihazda kurulu olan her şeyi döndürür, bir category (ugc veya product) ve her reçetenin istediği inputs ile: anahtar, türü, zorunlu olup olmadığı ve seçimler için izin verilen seçenekler.
Konuları getirin. Bir subject girdisi bir karakter kimliğini (list_characters'dan) veya bir ürün kimliğini alır. Bir ürün eklemek için, fotoğrafını upload_file ile yükleyin ve create_product ürünü bir ad ve kısa açıklamada arayın; açıklama reçetenin istemlerine dokunulmuş haldedir.
Çalıştırın. run_recipe reçete kimliği ve doldurulmuş girdiler ile. Hemen bir çalıştırma kimliği döndürür. engine her adımın ön ayarı kurulu olduğunda varsayılan olarak local veya bağlı olduğunda cloud'dur; get_recipe aracının önceden söyleyebilmesi için adım başına hazırlık gösterir.
Bekleyin. wait_for_recipe_run çalıştırma bitene kadar bloklanır ve her adımın sonucu artı son dosyayı döndürür. cancel_recipe_run bir çalıştırmayı erken durdurur.

Bir aracı tarafından başlatılan bir çalıştırma, Galeriye bir stüdyo çalıştırması gibi gruplandırılmış şekilde iner ve reçetenin çalıştırma geçmişinde görünür, böylece daha sonra uygulamada yeniden açabilir, yeniden kullanabilir veya tekrar yapabilirsiniz. Bulut çalıştırmaları başlamadan önce fiyatlandırılır ve aracının harcama sınırı karşısında sayılır.

Karakter Studio

Bir aracı, yeniden kullanılabilir karakterler oluşturabilir ve bunlardan sahne görüntüleri veya animasyonlu videolar oluşturabilir. Başlamadan önce get_status çağrısı yapın ve characters.enabled kontrol edin: motor çalışırken ve gerekli karakter ön ayarları kurulu olduğunda true değerindedir. characters.basegenPresets ve characters.editPresets her türün kaç ön ayarının hazır olduğunu rapor eder.

Oluşturma yolu 1: açıkla

Aracı list_character_features çağrısı yaparak mevcut kimlik özelliklerini alır (cilt tonu, saç rengi, göz şekli, vb.), her biri için değerler seçer, ardından mode: 'generate' ve { featureId: optionId } kimlik haritası ile create_character çağrısı yapır. Araç, temel portre hazır olana kadar dahili olarak sonuç bekler, ardından hazır karakter nesnesini döndürür (characterId ve base_image_url ile). Aracı bir iş kimliğini yoklamasına gerek yoktur; karakter araç döndür dönmez kullanıma hazırdır. Her özellik ve seçenek kendi id si ile anahtarlanır (API çağrılarında bunu kullanın); her seçenek üzerindeki label düz İngilizce bir açıklamadır, böylece aracı seçimleri kullanıcıya okunabilir bir şekilde sunabilir.

create_character({
  name: "Mara",
  gender: "woman",
  mode: "generate",
  identity: { skinTone: "tan", hairColor: "black", eyeShape: "almond" }
})

Oluşturma yolu 2: tabana yükle

Kullanıcının doğrudan kullanmak istediği bir görüntüsü varsa, aracı mode: 'upload' ile create_character çağrısı yaparak ve görüntüye mutlak yerel yolu baseFilePath içinde iletir. Araç yüklemeyi dahili olarak işler. Oluşturma adımı çalışmaz; karakter hemen hazır hale gelir.

create_character({
  name: "Mara",
  gender: "woman",
  mode: "upload",
  baseFilePath: "/absolute/path/to/photo.jpg"
})

Oluşturma yolu 3: vizyon-yeniden oluştur

Aracı (vizyon ile) bir kullanıcı fotoğrafına bakarak, kişinin görünür özelliklerini okur, onları list_character_features tarafından döndürülen seçeneklere eşler, ardından yol 1'i (açıkla) takip eder. Fotoğraf temel görüntü olarak kullanılmaz. Açıklanan özelliklerden görünümü yeniden oluşturmak için yeni bir portre oluşturulur. Bu, kullanıcı kendisinin veya başka birinin fotoğrafik benzerliğinden ziyade stillenmiş bir versiyonunu istediğinde yararlıdır.

Örnek aracı akıl yürütme akışı:

Kullanıcı bir fotoğraf paylaşır.
Aracı list_character_features çağrısı yaparak seçenek kimliklerini gözden geçirir.
Aracı fotoğrafı inceler ve bir identity haritasını doldurur: { skinTone: "light", hairColor: "red", hair: "longWaves" }.
Aracı mode: 'generate' ve doldurulmuş identity ile create_character çağrısı yapır.
Araç hazır karakter nesnesini döndürür (yoklamaya gerek yoktur; dahili olarak bekler). Aracı temel portresi kullanıcıya gösterir.

Sahneler ve videolar oluşturma

Bir karakter hazır olduğunda (taban kabul edilmiş), kendi characterId değerini generate_character_image veya generate_character_video öğesine geçirin:

generate_character_image({
  characterId: "char-abc123",
  prompt: "standing on a beach at golden hour",
  aspect: "16:9"
})

generate_character_video({
  characterId: "char-abc123",
  prompt: "standing in a park",
  motion: "waving at the camera"
})

Her ikisi de iş kimliklerini döndürür. Çıktıyı almak için wait_for_result kullanarak sonuç bekleyin, ardından get_result_image (görüntüler) veya get_job den dosya yolu (videolar) kullanın.

Not: Karakter oluşturma v1'de yalnızca yereldir. Motor çalışıyor olmalı (get_status içinde characters.enabled: true) ve gerekli karakter ön ayarları kurulu olmalıdır. Karakter araçları için bulut dağıtımı desteklenmiyor.

Çağrı başına ön ayarları değiştirme

Kurulu olan ön ayarları ve bunların kimliklerini görmek için list_character_presets çağrısı yapın. generate_character_image ve generate_character_video her çağrısı isteğe bağlı bir ön ayar geçersiz kılması kabul eder:

generate_character_image, identityEdit listesinden bir kimlik-düzenleme ön ayar kimliği olan presetId değerini kabul eder.
generate_character_video, framePresetId (çerçeve adımı için kimlik-düzenleme ön ayarı) ve videoPresetId (animasyon adımı için i2v ön ayarı) değerlerini kabul eder.

Geçersiz kılma işlemini atlarsanız, karakterin yapışkan varsayılanı kullanılır (veya hiçbiri ayarlanmamışsa sistem varsayılanı).

Yapışkan karakter başına varsayılan ayarlama

Bir karaktere ilgili ön ayarı kaydetmek için set_character_preset kullanın, böylece her çağrıda presetId iletmeniz gerekmez:

set_character_preset({
  characterId: "char-abc123",
  imagePresetId: "flux-character-edit",
  videoPresetId: "ltx-i2v-standard"
})

Bu varsayılanı temizlemek için her iki alan için de null iletin:

set_character_preset({
  characterId: "char-abc123",
  imagePresetId: null
})

Bir görüntü veya videoyu geliştirme

enhance_character_media herhangi bir karakter varlığı üzerinde bir ölçeklendirme ön ayarı çalıştırır. Çağırmadan önce, get_status içinde characters.enhancePresets öğesini kontrol edin (veya bir ölçeklendirme ön ayarının kurulu olduğunu doğrulamak için list_character_presets öğesinden enhanceImage/enhanceVideo dizilerini inceleyin). Her geliştirme ön ayarı, supportedScales içinde kullanılabilir ölçeklendirme faktörlerini listeler.

Kaynak seçenekleri:

Tamamlanan bir iş: jobId içinde iş kimliğini iletin. Medya türü işten çıkarılır.
Yüklenen bir dosya: önce upload_file ile yükleyin, ardından tutamacını filePath içinde iletin. mediaType: "image" veya mediaType: "video" ekleyin.
Karakter temel portresi: target: "base" iletin. Bu her zaman kaynağı görüntü olarak kabul eder.

Ek parametreler:

scale: ölçeklendirme faktörü (örn. 2 veya 4; ön ayarın supportedScales içinde olmalıdır).
keepResolution: true ise, sonuç ölçeklendirile sonra orijinal kaynak boyutlarına geri boyutlandırılır, çıktı piksel sayısını değiştirmeden daha keskin bir aynı boyutlu görüntü üretir.
applyAsBase: true ise, ölçeklendirilen sonuç, iş tamamlandıktan sonra karakterin temel portresinin yerini otomatik olarak alır.

enhance_character_media({
  characterId: "char-abc123",
  jobId: "gen-xyz",
  scale: 2
})

enhance_character_media({
  characterId: "char-abc123",
  target: "base",
  scale: 4,
  keepResolution: true,
  applyAsBase: true
})

Çerçeve inceleme akışı: oluştur -> geliştir -> canlandır

Video oluşturmayı gerçekleştirmeden önce statik çerçeveyi inceleyebilir ve geliştirebilirsiniz:

Statik bir çerçeve üretmek için generate_character_frame çağrısı yapın. Bu { jobIds: [...] } döndürür; jobIds[0] öğesini çerçeve iş kimliği olarak kullanın.
wait_for_result ile jobIds[0] öğesini yoklayın ve get_result_image ile görüntüyü gözden geçirin.
İsteğe bağlı olarak, çerçeveyi ölçeklendirmek için jobId: jobIds[0] ile enhance_character_media çağrısı yapın. Bu yeni bir iş kimliği döndürür; tamamlanana kadar yoklayın.
Tamamlanmış geliştirme iş kimliğine jobId ayarlanmış olarak (veya geliştirmemeyi atladıysanız jobIds[0] öğesi) animate_character çağrısı yapın. animate_character herhangi bir tamamlanmış görüntü işini kaynağı olarak kabul eder.

// Step 1: generate frame
generate_character_frame({
  characterId: "char-abc123",
  prompt: "walking through a city street"
})
// -> { jobIds: ["gen-frame-111"] }

// Step 3: upscale the frame
enhance_character_media({
  characterId: "char-abc123",
  jobId: "gen-frame-111",
  scale: 2
})
// -> { jobId: "gen-enhance-222" }

// Step 4: animate from the upscaled frame
animate_character({
  characterId: "char-abc123",
  jobId: "gen-enhance-222",
  motion: "walking confidently"
})

Temelli yeniden oluşturma

Yeni bir karakter kaydı oluşturmadan mevcut bir karakter için yeni bir temel portre oluşturmayı sıralamak için regenerate_character_base kullanın. Aynı zamanda farklı bir temel ön ayara geçiş yapabilir veya kimlik özelliklerini güncelleyebilirsiniz:

regenerate_character_base({
  characterId: "char-abc123",
  basePresetId: "flux-character-base-v2",
  identity: { skinTone: "light", hairColor: "blonde", hair: "bob" }
})

Araç dahili olarak sonuç bekler, iş tamamlandıktan sonra yeni portre otomatik olarak kabul edilir ve hazır karakter nesnesini döndürür. Aracı daha sonra bir iş kimliğini yoklamasına gerek yoktur.