Yapay Zeka Ajan Görevleriyle Görsel Üretimi: Tek Seferde Gönderi ve Başlık Görselleri

Kısa cevap: Yapay zekâ ajanı görevleriyle blog görselleri üretmek için özeti (brief), görsel teknik özelliklerini ve inceleme sorumlusunu tek bir Task içinde toplayın. Ajan yazının taslağını çıkarır, kendi ortamındaki anahtarla MiniMax H3-Image gibi bir görsel API'sini çağırır, her iki dosyayı da tekrar Task'a iliştirir ve inceleme adımında durur. Ardından bir insan çalışmayı onaylar ya da değişiklik talep eder.

Bugün ayrı bir içerik platformu inşa etmek zorunda kalmadan, yapay zekâ ajanı çalıştırmalarıyla blog görselleri üretebilirsiniz. İşin model tarafı bu hafta daha da kolaylaştı: 10.11.2026 tarihinde MiniMax, 16 megapiksel çözünürlükte görseller üreten açık ağırlıklı görsel modeli H3-Image'ı yayımladı. MiniMax'in belirttiğine göre bu işlem yaklaşık 10 saniye sürüyor. Ancak asıl zor kısım hiçbir zaman API çağrısı olmadı. Zor olan; taslağı, görseli, onu oluşturan istemi ve her ikisine dair alınan kararları tek bir yerde tutabilmektir.

Bu rehberde söz konusu iş akışını tek bir Task üzerinden nasıl yürüteceğinizi göreceksiniz. Özette nelerin yer alması gerektiğini, API anahtarının nereye ekleneceğini, Ajanın çalıştıracağı betiği ve inceleyenin neleri kontrol edeceğini adım adım ele alıyoruz. Ajanlara hâlihazırda kodlama görevleri atıyorsanız, Sharkly bu içerik çalışmasına da aynı Task, çalıştırma ve inceleme döngüsünü kazandırır.

İki işi neden tek bir ajan üstlenmeli?

Yazı yazma ve görsel hazırlama adımları birbirinden koptuğunda, başlık görseli içerikten uzaklaşır. Yazar üçüncü taslakta yazının odağını değiştirir ama görsel hâlâ ilk taslağı yansıtmaya devam eder. Birisi bir web uygulamasına bir istem yapıştırır, dosyayı indirir, adını değiştirir ve paylaşılan bir klasöre atar. Sonrasında ise kimse hangi görselin hangi istemle üretildiğini bulamaz.

Tek bir Task kullanmak, her iki çıktıya da tek bir sahip ve tek bir kayıt sağlayarak bu sorunu çözer:

• Ajan görsel istemini yazmadan önce son taslağı okur; böylece başlık görseli yayımlanacak nihai yazıyla tam uyum sağlar.
• İstem, model kimliği, boyut ve maliyet bilgileri taslakla birlikte aynı Task içinde yer alır.
• İncelemeyi yapan kişi metin ile görseli bir arada görür ve tek seferde karar verir.
• Revizyon talebi Ajana sıfırdan bir sohbetle değil, tüm bağlam korunarak ulaşır.

İnsan ile ajan arasındaki iş bölümü yalın kalır: Ajan taslağı yazar, görseli üretir, dosyaları ekler ve raporlar. İnsanlar ise karar verir, düzenler ve yayımlar.

MiniMax H3-Image neler sunuyor?

H3-Image, MiniMax'in metinden görsele ve görsel düzenleme modelidir. Tek bir denetim noktası her iki modu da destekler ve düzenleme modu 1 ila 16 referans görsel kabul eder. MiniMax'in görsel üretim rehberi ve model kartında paylaştığı veriler şunlardır:

Lansman indirimi, teslim edilen görsel en az 16.600.000 piksel olduğunda %50 indirim sağlamaktadır. MiniMax'in fiyatlandırma sayfası, bu kampanyanın 17 Kasım 2026 saat 16:00 UTC'ye kadar geçerli olduğunu belirtiyor. Bir blog başlık görseli nadiren 16 megapiksele ihtiyaç duyar; bu nedenle 16:9 oranında 2K, en mantıklı varsayılan seçenektir.

Açık ağırlıkları kendi sunucunuzda barındırmalı mısınız?

Çoğu ekip için yanıt hayır. Ağırlıklar standart bir açık kaynak lisansı yerine MiniMax-H3-Image Topluluk Lisansı ile dağıtılmaktadır. Lisansı kendiniz de inceleyebilirsiniz: lisans kapsamındaki bölgelerden bazı coğrafyaları hariç tutar ve yıllık 1 milyon ABD dolarının üzerindeki gelirlerde veya herhangi bir barındırılan hizmet için ayrıca yazılı izin gerektirir. Ayrıca indirme boyutu da oldukça büyüktür: difüzyon transformatörü için 66,28 GB ve metin kodlayıcı için 66,7 GB. Dolayısıyla bir blog iş akışı için API en pratik yoldur.

1. Adım: Özeti bir Task olarak yazın

Task açıklaması sizin özetinizdir. Ajanın soru sormadan işi tamamlaması için gereken her şey buraya yazılır. Başarılı bir özet örneği şöyledir:

**Post:** How we cut CI time by 40% with test sharding
**Audience:** platform engineers
**Length:** 1,400 words
**Header image:** 16:9, 2K, MiniMax-H3-Image
**Image direction:** abstract, no text in the image, brand blues
**Deliver:** article.md + header.jpg + prompt.txt attached to this Task
**Reviewer:** Maria (approves both before anything is published)

Tek seferlik detayları Task içinde tutun. Ton, görsel stili ve dosya adları gibi her yazıda tekrarlanan kuralları ise bir Skill içerisine taşıyın. Sharkly'de bir Skill, yeniden kullanılabilir talimatları ve destekleyici dosyaları paketler; Ajan ise kendisine atanan Skill'leri her çalıştırmada yükler. Bu formatla ilgili ayrıntıları kodlama ajanı becerisinin ne olduğunu açıklayan rehberimizde bulabilirsiniz.

2. Adım: Ajana görsel API anahtarını verin

Çalıştırmanın ortamında MINIMAX_API_KEY değerinin bulunması gerekir. Sharkly'nin Ajan ayarları hem düz metin hem de gizli ortam değişkenlerini barındırır; bir göreve bağlı çalıştırma başladığında yapılandırılmış değişkenleri ve gizli anahtar bağlamalarını otomatik olarak alır.

O paneldeki nota dikkat edin: Düz metin değerler yetkili Ajan yöneticileri tarafından görülebilir ve güvenli gizli anahtar deposu değildir; bu nedenle hesabınızı faturalandıracak bir API anahtarı mutlaka gizli yapılandırmada yer almalıdır. Bir anahtarı asla Task açıklamasına veya yoruma yazmayın. Geri kalan ayrıntıları kodlama ajanları için gizli bilgi kontrol listemizde bulabilirsiniz.

Sharkly içinde yerleşik bir MiniMax görsel bağlayıcısı bulunmaz. Ajan, herhangi bir HTTP servisini çağırdığı gibi API'yi de çalıştığı Computer üzerindeki bir betikten çağırır. Sharkly, 26.10.2026 tarihli değişiklik günlüğünden bu yana MiniMax Code'u (mcode) bir Runtime olarak listelemektedir; böylece hâlihazırda MiniMax Code kullanan ekipler Ajanı orada çalıştırabilir. İş akışınızı buna bağlamadan önce görsel üretimini başsız bir çalıştırmada test edin.

3. Adım: Ajanın çalıştıracağı betik

Her çalıştırmanın aynı isteği kullanması için bu betiği Skill içinde sunun. Betik, MiniMax rehberindeki istek yapısını takip eder:

# make_header.py: generate one 16:9 header with MiniMax H3-Image
import os, sys, json, requests

prompt = open(sys.argv[1]).read().strip()   # prompt.txt written by the Agent
resp = requests.post(
    "https://api.minimax.io/v1/images/generations",
    headers={"Authorization": f"Bearer {os.environ['MINIMAX_API_KEY']}"},
    json={
        "model": "MiniMax-H3-Image",
        "prompt": prompt,
        "aspect_ratio": "16:9",
        "area": "2K",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
resp.raise_for_status()
result = resp.json()
item = result["data"][0]
if "error" in item:
    sys.exit(f"Image failed: {item['error']['message']}")

with open(f"header.{result['output_format']}", "wb") as f:
    f.write(requests.get(item["url"], timeout=120).content)

json.dump({"size": item["size"], "revised_prompt": item["revised_prompt"]},
          open("image-meta.json", "w"), indent=2)

Ekip ortamında üç ayrıntı önem taşır:

1. Otomatik yeniden deneme yapmayın. MiniMax rehberi bu çağrının eşgüçlü olmadığı konusunda uyarır; dolayısıyla bir yeniden deneme ikinci bir görsel olarak faturalandırılabilir. Ajanın bir döngüye girmesi yerine hatayı bildirmesini sağlayın.
2. revised_prompt alanını saklayın. İstem iyileştirme varsayılan olarak açıktır ve yanıt, kullanılan istemi döndürür. Bunu kaydederseniz inceleyen kişi tahmin yürütmek zorunda kalmadan düzenleme isteyebilir.
3. Dosyayı indirin. Rehber, görselleri indirip kendiniz depolamanızı söyler; bu nedenle inceleyenlere yalnızca dönen URL'yi iletmeyin.

4. Adım: Her iki dosyayı da ekleyin ve inceleme adımında durun

Taslak ve görsel hazır olduğunda Ajan bunları Task'a iliştirir ve yaptıklarını raporlar. Sharkly CLI her iki işlemi tek bir komutla halleder:

sharkly task comment "$TASK_ID" \
  --body-file run-summary.md \
  --attachment article.md \
  --attachment header.jpg \
  --attachment image-meta.json

Özet; kelime sayısını, model kimliğini, görsel boyutunu, yanıttaki usage bloğunu ve doğrulayamadığı her türlü noktayı listeler. Ardından Ajan, inceleme gerektiğini belirterek görüşmeyi geri devreder. Bu devir işlemi kenar çubuğundaki Task Chats modülüne düşer, böylece gözden kaçmaz.

Sonuçlar doğrudan Task'a döner. İnceleyen kişi terminalde, indirilenler klasöründe veya sohbet günlüklerinde arama yapmak zorunda kalmaz.

5. Adım: Yazıyı ve görseli birlikte inceleyin

İncelemeyi yapacak kişi tek bir Task açar ve her iki çıktıyı da özete göre kontrol eder:

• Başlık görseli yazının eski bir taslağına değil, nihai bakış açısına uygun mu?
• Görselde üretilmiş herhangi bir metin var mı? Görsel modelleri hâlâ kelimeleri hatalı yazabildiğinden özet metin içermemesini ister.
• Görsel gerçek bir ürün ekranını mı gösteriyor? Öyleyse bunu gerçek bir ekran görüntüsüyle değiştirin; yapay zekâ tarafından üretilen arayüzler sadece birer taslaktır.
• Yazıdaki olgusal bilgiler atıfta bulunulan kaynaklarla uyuşuyor mu?

Değişiklik istemek için Task üzerine bir yorum yazın. Ajan; taslak, görsel ve kaydedilen istem bağlamda hazır olacak şekilde işi kaldığı yerden devralır. İnsanların sürece nerede dahil olduğu hakkında daha fazla bilgi için insan denetimli kodlama ajanları rehberimize göz atabilirsiniz.

Bu iş akışı ne zaman kullanılmamalı?

Tek seferlik görseller için bu yöntemi atlayın. Bir slayt için tek bir resme ihtiyacınız varsa web uygulamasını açmak bir özet yazmaktan daha hızlıdır.

Ürün ekran görüntüleri, gerçek veriler içeren grafikler ve gerçek kişilerin veya etkinliklerin fotoğrafları için görsel üretimini tamamen es geçin. Bunlar için gerçek kaynaklar gerekir. Yapay zekâ ile üretim; konsept çizimleri, soyut başlık görselleri ve zaten elle yeniden çizeceğiniz diyagramlar için uygundur. Birçok blog yazısında görsel tutarlılığı koruma konusunda bilgi edinmek için yapay zekâ ajanlarıyla marka görsellerini tutarlı tutma rehberimizi okuyabilirsiniz.

Sonuç

Görsel modeli işin kolay kısmıdır. MiniMax H3-Image, kendi fiyatlandırma tablosuna göre yaklaşık iki sent karşılığında 2K çözünürlükte bir başlık görseli oluşturur. Asıl zaman kazandıran şey, bunun etrafına kurulan yapıdır: tek bir Task, tek bir özet, tek bir Ajan çalıştırması ve tek bir inceleme.

Kurulumu bir kez yapın: Bir Computer bağlayın, gizli yapılandırmasına görsel anahtarı eklenmiş bir Ajan oluşturun, ona yukarıdaki Skill'i ve betiği verin ve önümüzdeki haftanın yazısını atayın. Sharkly'yi kullanmaya başlamak ücretsizdir; güncel planlar için sharkly.ai adresini ziyaret edin.

Sıkça Sorulan Sorular

Bir yapay zekâ ajanı blog görsellerini tek başına üretebilir mi?

Evet; çalıştırma bir görsel API anahtarına ve API'yi çağıran bir betiğe veya araca sahipse bunu yapabilir. Ajan istemi taslaktan yola çıkarak yazar, uç noktayı çağırır, dosyayı kaydeder ve incelenmek üzere Task'a ekler.

MiniMax H3-Image nedir?

H3-Image, MiniMax'in 10.11.2026 tarihinde yayımladığı metinden görsele ve görsel düzenleme amaçlı açık ağırlıklı modelidir. Yaklaşık 16 megapiksel boyutunda görseller üretir ve düzenleme modunda 16 adede kadar referans görsel kabul eder.

Bir H3-Image başlık görselinin maliyeti ne kadardır?

MiniMax'in fiyatlandırma sayfası, örnek bir 2K metinden görsele üretim için $0.02333, 4K için ise $0.06879 belirtmektedir. Geliştirilmiş istem belirteçleri de faturalandırıldığından, gerçek maliyetler istem uzunluğuna göre değişiklik gösterir.

Sharkly'de yerleşik bir MiniMax görsel entegrasyonu var mı?

Hayır. Sharkly, Ajanınızı sizin Computer'ınızda çalıştırır ve Ajan sizin anahtarınızla MiniMax API'sini çağırır. MiniMax Code bir Sharkly Runtime'ı olarak mevcuttur ancak bu durum bir görsel bağlayıcısıyla aynı şey değildir.

API anahtarı nerede saklanmalıdır?

Ajanın gizli yapılandırmasında saklanmalıdır. Sharkly'nin düz ortam değişkenleri Ajan yöneticileri tarafından görülebilir; Task açıklamaları ve yorumları ise ilgili Task'ı açabilen herkes tarafından görüntülenebilir.

Yazıyı da Ajan mı yayımlamalı?

Hayır. Yayımlama sürecini bir insanda tutun. Ajan taslağı hazırlar ve ekler; inceleyen kişi ise onaylar ve yayımlar.