Görsel Üretimi
image_generate aracı, ajanın yapılandırılmış sağlayıcılarınızı kullanarak görseller oluşturmasına ve düzenlemesine olanak tanır. Üretilen görseller, ajanın yanıtında medya eki olarak otomatik şekilde gönderilir.
Araç yalnızca en az bir görsel üretim sağlayıcısı kullanılabilir olduğunda görünür. Ajanınızın araçlarında image_generate görmüyorsanız, agents.defaults.imageGenerationModel yapılandırın veya bir sağlayıcı API anahtarı ayarlayın.
Hızlı başlangıç
- En az bir sağlayıcı için bir API anahtarı ayarlayın (örneğin
OPENAI_API_KEY veya GEMINI_API_KEY).
- İsteğe bağlı olarak tercih ettiğiniz modeli ayarlayın:
{
agents: {
defaults: {
imageGenerationModel: {
primary: "openai/gpt-image-1",
},
},
},
}
- Ajana şunu sorun: “Dost canlısı bir ıstakoz maskotu görseli oluştur.”
Ajan image_generate aracını otomatik olarak çağırır. Araç allow-list eklemesi gerekmez — bir sağlayıcı kullanılabilir olduğunda varsayılan olarak etkindir.
Desteklenen sağlayıcılar
| Sağlayıcı | Varsayılan model | Düzenleme desteği | API anahtarı |
|---|
| OpenAI | gpt-image-1 | Evet (en fazla 5 görsel) | OPENAI_API_KEY |
| Google | gemini-3.1-flash-image-preview | Evet | GEMINI_API_KEY veya GOOGLE_API_KEY |
| fal | fal-ai/flux/dev | Evet | FAL_KEY |
| MiniMax | image-01 | Evet (özne referansı) | MINIMAX_API_KEY veya MiniMax OAuth (minimax-portal) |
| ComfyUI | workflow | Evet (1 görsel, iş akışı yapılandırmalı) | bulut için COMFY_API_KEY veya COMFY_CLOUD_API_KEY |
| Vydra | grok-imagine | Hayır | VYDRA_API_KEY |
action: "list" kullanın:
/tool image_generate action=list
Araç parametreleri
| Parametre | Tür | Açıklama |
|---|
prompt | string | Görsel üretim istemi (action: "generate" için gereklidir) |
action | string | Sağlayıcıları incelemek için "generate" (varsayılan) veya "list" |
model | string | Sağlayıcı/model geçersiz kılması, ör. openai/gpt-image-1 |
image | string | Düzenleme modu için tek referans görsel yolu veya URL |
images | string[] | Düzenleme modu için birden çok referans görsel (en fazla 5) |
size | string | Boyut ipucu: 1024x1024, 1536x1024, 1024x1536, 1024x1792, 1792x1024 |
aspectRatio | string | En-boy oranı: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 |
resolution | string | Çözünürlük ipucu: 1K, 2K veya 4K |
count | number | Oluşturulacak görsel sayısı (1–4) |
filename | string | Çıktı dosya adı ipucu |
size, aspectRatio ve resolution değerleri gerçekten gönderilen değeri yansıtır ve details.normalization, istenenden uygulanana yapılan çeviriyi yakalar.
Yapılandırma
Model seçimi
{
agents: {
defaults: {
imageGenerationModel: {
primary: "openai/gpt-image-1",
fallbacks: ["google/gemini-3.1-flash-image-preview", "fal/fal-ai/flux/dev"],
},
},
},
}
Sağlayıcı seçim sırası
Bir görsel üretilirken OpenClaw sağlayıcıları şu sırayla dener:
- Araç çağrısından gelen
model parametresi (ajan bir tane belirtirse)
- Yapılandırmadaki
imageGenerationModel.primary
- Sırasıyla
imageGenerationModel.fallbacks
- Otomatik algılama — yalnızca auth destekli sağlayıcı varsayılanlarını kullanır:
- önce geçerli varsayılan sağlayıcı
- ardından sağlayıcı kimliği sırasına göre kalan kayıtlı görsel üretim sağlayıcıları
Bir sağlayıcı başarısız olursa (auth hatası, hız sınırı vb.), sıradaki aday otomatik olarak denenir. Hepsi başarısız olursa, hata her denemeden ayrıntılar içerir.
Notlar:
- Otomatik algılama auth farkındalıklıdır. Bir sağlayıcı varsayılanı yalnızca
OpenClaw o sağlayıcı için gerçekten kimlik doğrulaması yapabildiğinde aday listesine girer.
- Otomatik algılama varsayılan olarak etkindir. Görsel
üretiminin yalnızca açık
model, primary ve fallbacks
girdilerini kullanmasını istiyorsanız
agents.defaults.mediaGenerationAutoProviderFallback: false ayarlayın.
- Geçerli kayıtlı sağlayıcıları, bunların
varsayılan modellerini ve auth env-var ipuçlarını incelemek için
action: "list" kullanın.
Görsel düzenleme
OpenAI, Google, fal, MiniMax ve ComfyUI referans görselleri düzenlemeyi destekler. Bir referans görsel yolu veya URL’si geçin:
"Bu fotoğrafın sulu boya sürümünü oluştur" + image: "/path/to/photo.jpg"
images parametresi aracılığıyla en fazla 5 referans görseli destekler. fal, MiniMax ve ComfyUI 1 adet destekler.
MiniMax görsel üretimi, birlikte gelen her iki MiniMax auth yolu üzerinden de kullanılabilir:
- API anahtarı kurulumları için
minimax/image-01
- OAuth kurulumları için
minimax-portal/image-01
Sağlayıcı yetenekleri
| Yetenek | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra |
|---|
| Üretme | Evet (en fazla 4) | Evet (en fazla 4) | Evet (en fazla 4) | Evet (en fazla 9) | Evet (iş akışı tanımlı çıktılar) | Evet (1) |
| Düzenleme/referans | Evet (en fazla 5 görsel) | Evet (en fazla 5 görsel) | Evet (1 görsel) | Evet (1 görsel, özne ref.) | Evet (1 görsel, iş akışı yapılandırmalı) | Hayır |
| Boyut kontrolü | Evet | Evet | Evet | Hayır | Hayır | Hayır |
| En-boy oranı | Hayır | Evet | Evet (yalnızca üretme) | Evet | Hayır | Hayır |
| Çözünürlük (1K/2K/4K) | Hayır | Evet | Evet | Hayır | Hayır | Hayır |
İlgili
