GPT Image modelleri, güvenlik nedenleriyle bir isteği reddedebilir. Red kararı; isteminizden (prompt), girdi görselinden veya oluşturulan görselden kaynaklanabilir. TokenLab'de bu durum, content_policy_violation koduyla bir HTTP 400 hatası olarak gelir. Bu kılavuz; moderation ayarının ne işe yaradığını, bir engellemenin nasıl okunacağını, olası bir hatalı pozitifin (false positive) nasıl inceleneceğini, nelerin günlüğe kaydedilmesi gerektiğini, kullanıcıya ne söylenmesi gerektiğini ve nasıl itiraz edileceğini açıklar.
Bu kılavuz, filtreyi aşmanın yollarını tarif etmez. Bir istek izin verilmiyorsa, kelimeleri değil ürünü değiştirin.
Önemli Noktalar
moderationparametresiauto(varsayılan) veyalowdeğerlerini alır.low, daha az kısıtlayıcı filtreleme anlamına gelir. Filtrelemeyi tamamen kapatmaz.- Engelleme,
error.codedeğericontent_policy_violationveretryabledeğerifalseolan bir HTTP 400 hatasıdır. Asenkron bir görevde ise aynı kodfaileddurumundaki görevde görünür. - Engellenen bir isteği değiştirmeden tekrar denemeyin. Önce bir insanın incelemesini sağlayın.
request_iddeğerini günlüğe kaydedin, kullanıcıya kısa ve tarafsız bir mesaj gösterin ve kullanıcıya bir hata bildirme yolu sunun.- İtiraz etmek için, Runs içindeki destek eylemi aracılığıyla Request ID'yi gönderin.
Moderasyon ayarı ne işe yarar?
moderation, gpt-image-2 gibi GPT Image modelleri için bir istek alanıdır. POST /v1/images/generations ve POST /v1/images/edits üzerinde çalışır. Create Image referansı iki değer listeler.
| Değer | Sağlayıcının açıklaması |
|---|---|
auto (varsayılan) |
Yaşa uygun olmayan içerik kategorilerini sınırlayan standart filtreleme |
low |
Daha az kısıtlayıcı filtreleme |
Her iki değer de filtreleme yapar. Açıklamalar, 2026-11-11 tarihinde okunan sağlayıcının görsel oluşturma kılavuzundan alınmıştır.
Ürününüz için bir değer seçin. Seçiminizi, ürünü kimlerin kullandığına ve kendi içerik kurallarınıza dayandırın. Engellenen bir isteği geçirmek için isteğe bağlı olarak değer değiştirmeyin.
Bu istek, değeri ayarlar ve user alanında karma (hashed) bir son kullanıcı kimliği gönderir. Edit Image referansı, user alanını kötüye kullanım izleme için bir tanımlayıcı olarak tanımlar. İçinde isim veya e-posta adresi göndermeyin.
curl https://api.tokenlab.sh/v1/images/generations \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "Studio photo of a ceramic coffee mug on a white background, soft light",
"size": "1024x1024",
"moderation": "auto",
"user": "u_7f3a9c"
}'
TokenLab'de engelleme nasıl görünür?
Sağlayıcının kendi API'si bir engellemeyi image_generation_user_error hata tipiyle moderation_blocked olarak raporlar. TokenLab kendi genel kodunu döndürür. Mesaj metnine değil, bu koda göre dallanma yapın.
Senkron bir istek HTTP 400 döndürür. Gövde şu şekildedir:
{
"error": {
"code": "content_policy_violation",
"hint": "Review the prompt and media for disallowed content, then submit a revised request.",
"message": "The request was rejected by the safety system.",
"request_id": "req_example",
"retryable": false,
"type": "invalid_request_error"
}
}
async: true ile oluşturma çağrısı bir görev döndürür. Engelleme, sorgulama (polling) yaptığınızda görünür. Durum okuma, başarısız bir görev için bile HTTP 200 döndürür, bu nedenle Get Image Status referansında gösterildiği gibi status ve error_details alanlarını okuyun:
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "failed",
"error": "The request was rejected by the model's content policy.",
"error_details": {
"status": 400,
"type": "invalid_request_error",
"code": "content_policy_violation",
"retryable": false
},
"data": []
}
Resmi bir rotada hata, sağlayıcının kendi mesajını ve kodunu içeren bir upstream nesnesi de taşıyabilir. Hata işleme kılavuzu, code ve type üzerinden dallanmaya devam etmenizi söyler, çünkü upstream.code değerleri sağlayıcıya aittir ve değişebilir.
Sağlayıcının API'si ayrıca bir engellemenin girdiden mi yoksa çıktıdan mı kaynaklandığını da belirtebilir. TokenLab'in referansı bu alanı listelemez, bu nedenle mantığınızı bunun üzerine kurmayın.
Bu bir engelleme mi yoksa başka bir hata mı?
Birçok 400 hatasının güvenlikle ilgisi yoktur. Bir başarısızlığı moderasyon olarak ele almadan önce kodu kontrol edin.
| Gördüğünüz | Anlamı | Ne yapmalı |
|---|---|---|
content_policy_violation içeren 400 |
Güvenlik sistemi isteği reddetti | Değiştirmeden tekrar denemeyin. İsteği inceleyin. |
unsupported_parameter, invalid_image_url veya başka bir istek kodu içeren 400 |
İstek hatalı, güvensiz değil | param içinde belirtilen alanı düzeltin. |
429 rate_limit_exceeded |
Çok fazla istek | Retry-After süresini bekleyin, sonra tekrar deneyin. |
500 - 504, all_channels_failed |
Hizmet veya tedarik sorunu | Sadece retryable değeri true ise tekrar deneyin. |
Olası bir hatalı pozitifi inceleme
Hatalı pozitif, okuduğunuz ve açıkça izin verilen ancak yine de engellenen bir istektir. Bir program bunu yargılayamaz. Bir insan yargılayabilir.
- Kodu onaylayın. Kod mutlaka
content_policy_violationolmalıdır. - Tam isteği okuyun. İstem metninin tamamını okuyun ve her girdi görseline bakın. İçindeki herhangi bir şey sağlayıcının kullanım politikası veya kendi kurallarınız altında izin verilmiyorsa durun. Geçirmek için kelimeleri değiştirmeyin.
- Açıkça zararsız bir isteği hassas bir şekilde yazın. Konuyu, ortamı, stili ve görselin ne için olduğunu belirtin. Hassas bir istemin bir insan tarafından incelenmesi ve model tarafından takip edilmesi daha kolaydır. Politikanın neye izin verdiğini değiştirmez.
- Bir kez gönderin. Tekrar engellenirse durun ve itiraz edin. Döngüye girmeyin.
Bu istemler, hedeflenmesi gereken detay düzeyini gösterir. Her biri yaygın ve meşru bir kullanım için basit bir istektir:
- Ürün çekimi: "Studio photo of a matte black wireless earbud case on a white acrylic surface, soft top light, no people, clean background, for an online store listing."
- Tıbbi diyagram: "Textbook-style anatomical diagram of the human knee joint, side view, flat vector style, neutral gray and blue colors, each part labelled in English, for a patient education leaflet."
- Tarihi görsel: "Museum-style illustration of a 19th-century steam locomotive at a railway station, workers in period clothing, muted colors, for a history education site."
Bir düzenleme (edit) için, sadece düzenlemenin ihtiyaç duyduğu görseli gönderin ve değişikliği tek bir net cümleyle açıklayın. GPT Image edit API kılavuzu istek biçimini kapsar.
Neleri günlüğe kaydetmeli
Günlükler ve sorun giderme kılavuzu, içerik yerine kimlikleri (ID) saklamanızı söyler. Engellenen her istek için şunları saklayın:
- Hata gövdesinden veya yanıt başlıklarından
request_id. - Asenkron işler için
task_idvepoll_url. - Endpoint, model, zaman, HTTP durumu ve
error.code. - Gönderdiğiniz alanların adları.
- Kendi iş kimliğiniz (job ID) ve karma son kullanıcı kimliği.
Asla API anahtarlarını günlüğe kaydetmeyin. İstemleri ve görselleri sadece kendi gizlilik kurallarınız izin veriyorsa saklayın.
Son kullanıcıya ne söylenmeli
Mesajı kısa ve tarafsız tutun. Sınıflandırıcı detaylarını göstermeyin, kullanıcıyı suçlamayın ve bir isteği filtreyi aşacak şekilde yeniden ifade etmenin yollarını önermeyin. Örneğin:
Bu görsel, istek içerik güvenliği kurallarımıza uymadığı için oluşturulamadı. İsteği değiştirip tekrar deneyebilirsiniz. Bunun bir hata olduğunu düşünüyorsanız, Sorun bildir'i seçin ve req_example referansını belirtin.
req_example yerine gerçek Request ID'yi yazın. Rapor düğmesi, bir insanın inceleyebilmesi için bu kimliği istekle birlikte kaydetmelidir.
Engellemeye itiraz etme
İtiraz, Request ID kullanılarak TokenLab desteği aracılığıyla yapılır.
- İsteğin sahibi olan çalışma alanında Runs kısmını açın. Request ID'yi bulun ve satırı seçin.
- İnsan desteği eylemini seçin. Bağlantılı istekle birlikte bir önizleme açılır.
- Özeti okuyun ve özel içeriği kaldırın. Ardından Submit (Gönder) seçeneğini seçin. Sadece önizleme yapmak hiçbir şey göndermez.
- Aynı konuşmaya Support (Destek) kısmında devam edin. Mükerrer gönderim yapmayın.
Ne beklediğinizi ve kullanıcının ne gördüğünü söyleyin. request_id, endpoint, model, zaman, durum kodu, alan adları ve güvenli hata gövdesini ekleyin. API anahtarlarını, özel medyayı veya tam istemleri göndermeyin.
SSS
GPT Image'da moderation="low" ne yapar?
Varsayılan auto değerinden daha az kısıtlayıcı bir filtreleme ister. Filtrelemeyi kapatmaz. Ürününüz için bir değer seçin ve onu kullanmaya devam edin.
Hangi hata kodu bir GPT Image isteğinin engellendiği anlamına gelir?
TokenLab'de, error.code değeri content_policy_violation olan HTTP 400 hatasını kontrol edin. Asenkron bir görev için, failed durumundaki bir görevde error_details içindeki aynı kodu arayın. Sağlayıcının kendi API'si buna moderation_blocked der.
Engellenen bir isteği tekrar denemeli miyim?
Hayır. Hata retryable: false değerini döndürür ve sağlayıcının rehberliği, isteği değiştirmeden bu hataları tekrar denememeniz yönündedir. Önce bir insanın isteği incelemesini sağlayın. Bir denemeden sonra durun.
Engellenen bir istek ücretlendirilir mi?
Başarısız bir asenkron görev ücretlendirilmez ve rezerve edilen tutar serbest bırakılır. 400 ile sonuçlanan bir istek tamamlanmamıştır ve her tamamlanan istek bir kez ücretlendirilir. Usage (Kullanım) kısmındaki herhangi bir isteği Request ID'si ile onaylayın.
Hatalı pozitif durumunda ne yapmalıyım?
Bir insanın isteği okumasını sağlayın. Eğer açıkça izin veriliyorsa; konuyu, ortamı, stili ve amacı açıkça belirtin ve bir kez gönderin. Eğer tekrar engellenirse, Request ID ile Runs üzerinden itiraz edin.
GPT Image'ı denemek için gpt-image-2 model sayfasını açın. Asenkron işler ve sorgulama kılavuzu, görev yaşam döngüsünü kapsar.
Kaynaklar
- OpenAI: image generation guide2026-11-11 tarihinde gözlendi
- TokenLab Docs: Create Image2026-11-11 tarihinde gözlendi
- TokenLab Docs: Get Image Status2026-11-11 tarihinde gözlendi
- TokenLab Docs: Handle API errors2026-11-11 tarihinde gözlendi
- TokenLab Docs: Logs and troubleshooting2026-11-11 tarihinde gözlendi
