Catatan penulis: Jika antarmuka gambar mengembalikan HTTP 451 dengan kode kesalahan image_safety, yang difilter adalah gambar hasil generasi, bukan karena kunci API tidak lolos. Berdasarkan penjelasan di dokumentasi APIYI dan pengujian ulang, artikel ini menjelaskan perbedaannya dengan 401 dan 429, serta apa yang perlu diubah dan cara menghindari percobaan ulang yang keliru.
Saat menggunakan antarmuka gambar, tiba-tiba Anda menerima HTTP 451 dengan error.code bernilai image_safety. Banyak orang langsung mengira kunci API tidak valid, saldo tidak cukup, atau ada kata sensitif dalam petunjuk. Mereka lalu mengganti kunci API, mengisi saldo, atau mencoba lagi berkali-kali—tetapi hasilnya tetap gagal. Intinya, 451 image_safety memblokir gambar hasil generasi; pemeriksaan keamanan dilakukan setelah gambar dibuat. Jadi, fokuslah memeriksa deskripsi visual, bukan akun Anda.
Artikel ini bukan sekadar penjelasan umum tentang keamanan konten. Isinya mengacu pada penjelasan APIYI tentang 451 dan pengujian ulang anonim yang dipublikasikan di sana. Kami tidak membuat data pengujian sendiri.
Manfaat utama: Setelah membaca artikel ini, Anda bisa membedakan 451 dari 401 dan 429 dalam 1 menit, lalu membuat permintaan menghasilkan gambar kembali dengan mengubah petunjuk satu variabel setiap kali.
Poin Penting tentang Error 451 image_safety pada Pembuatan Gambar
Berikut beberapa kesimpulan terpenting. Semuanya bersumber langsung dari pesan error dan penjelasan di dokumentasi, jadi tidak perlu menebak-nebak.
| Poin | Penjelasan | Manfaat bagi Anda |
|---|---|---|
| Yang ditinjau adalah gambar keluaran | Pesannya berbunyi The generated image was filtered by the safety policy |
Anda tidak perlu lagi mencurigai kunci API atau saldo |
| Peninjauan dilakukan setelah gambar dibuat | API mungkin membuat gambar terlebih dahulu, lalu meninjau keamanannya. Jika tidak lolos, gambar tidak akan dikembalikan | Anda jadi paham mengapa petunjuk yang tampaknya tidak bermasalah pun bisa diblokir |
| Bukan berarti input melanggar aturan | Gagal dalam peninjauan setelah pembuatan tidak berarti petunjuk atau gambar referensi mengandung kata-kata yang jelas melanggar aturan | Anda tidak perlu menghapus banyak kata atau mengganti gambar referensi |
| Solusinya adalah mengubah isi gambar | Menjelaskan unsur visual seperti pakaian dan komposisi dengan lebih jelas biasanya lebih efektif daripada menambahkan kalimat negatif | Anda bisa melakukan perubahan yang tepat sasaran dan menghindari langkah yang tidak perlu |
| Jangan langsung mencoba ulang dengan input yang sama | Jika kombinasi yang sama terus gagal, kemungkinan besar percobaan berikutnya juga akan menghasilkan 451 | Menghemat waktu dan biaya pemanggilan |
Kenali Kode Error: Perbedaan 451 image_safety, 401, dan 429
Saat menerima error, langkah pertama adalah memeriksa kode status dan error.code, bukan langsung mengubah kode. Berikut penjelasan APIYI tentang 451, yang juga tersedia di FAQ dan bagian pembaruan di pusat dokumentasi apiyi.com: responsnya adalah HTTP 451, error.code bernilai image_safety, dan pesannya berbunyi The generated image was filtered by the safety policy. Kata kuncinya adalah generated image, yang berarti “gambar yang sudah dibuat” disaring oleh kebijakan keamanan.
Ini berbeda sepenuhnya dari masalah autentikasi dan pembatasan laju. Error 401 biasanya berarti permintaan gagal melewati verifikasi identitas sebelum mencapai model. Error 429 berarti permintaan terlalu sering atau saluran sedang sibuk. Sementara itu, error terkait saldo berhubungan dengan penagihan. Ketiganya tidak berkaitan dengan “gambar apa yang dibuat”, sedangkan 451 justru berkaitan langsung dengan hal tersebut.
| Error | Arti yang umum | Tahap terjadinya | Penanganan yang tepat | Apakah cocok dicoba ulang dengan input yang sama? |
|---|---|---|---|---|
HTTP 451 image_safety |
Gambar yang dihasilkan tidak lolos peninjauan keamanan pada sisi keluaran | Setelah gambar dibuat | Ubah deskripsi gambar dan periksa satu variabel setiap kali | Tidak. Jika kombinasi yang sama gagal berulang kali, jangan coba lagi tanpa perubahan |
| HTTP 401 | Kunci API tidak valid atau tidak dikirim dengan benar | Saat permintaan masuk | Periksa kunci API dan header permintaan | Tidak. Mencoba lagi tidak ada gunanya jika kunci API salah |
| HTTP 429 | Terkena pembatasan laju atau saluran sedang sibuk | Saat permintaan masuk atau dalam antrean | Coba lagi setelah jeda bertahap; jika perlu, ganti saluran | Ya, coba lagi dengan strategi jeda bertahap |
| Error terkait saldo | Kuota tidak mencukupi | Pemeriksaan penagihan | Isi saldo atau sesuaikan kuota | Tidak |
Perlu diperhatikan: 451 dan 401 tidak bisa ditangani dengan logika percobaan ulang yang sama. Untuk 401, perbaiki konfigurasi kunci API. Untuk 451, ubah petunjuk. Jika keduanya dimasukkan ke cabang umum “jika gagal, coba ulang 3 kali”, proses penelusuran masalah justru akan makin membingungkan.
Mengapa 451 image_safety baru muncul setelah gambar dibuat
Dokumentasi menyebut mekanisme ini sebagai moderasi pascapembuatan, atau moderasi sisi keluaran. Alurnya sederhana: permintaan lolos autentikasi, model membuat gambar berdasarkan petunjuk dan gambar referensi, lalu sistem memeriksa keamanan gambar tersebut. Jika gambar tidak lolos pemeriksaan, gambar tidak akan dikembalikan dan sistem langsung memberikan 451.
Karena itu, Anda mungkin pernah mengalami situasi ketika permintaan diblokir meskipun petunjuknya tidak mengandung satu pun kata sensitif. Penyebabnya bukan satu kata tertentu, melainkan kombinasi beberapa kondisi yang membuat gambar hasil buatan model memicu filter. Dengan memahami hal ini, Anda bisa beralih dari mencari “kata terlarang” ke mengendalikan tampilan akhir gambar.
Interpretasi Pengujian Ulang Dokumentasi 451 image_safety
Dokumentasi APIYI menyajikan serangkaian pengujian ulang yang telah dianonimkan dengan model gpt-image-2.5-sunburst-vip. Skenarionya menggunakan gambar referensi seseorang untuk kebutuhan penetapan tampilan karakter, mencakup close-up wajah serta tampilan seluruh tubuh dari depan, samping, dan belakang, dengan latar putih. Semua data berikut berasal dari pengujian ulang dalam dokumentasi; artikel ini hanya membahas interpretasinya.
| Kombinasi pengujian ulang dalam dokumentasi | Hasil | Durasi | Keterangan |
|---|---|---|---|
| Petunjuk dan gambar referensi asli | 3/3 gagal | 81.8–95.9 detik | Kelompok dasar, konsisten menghasilkan 451 |
| Gambar referensi yang sama, diubah menjadi potret setengah badan dengan pakaian kasual netral | 1/1 berhasil | 35.7 detik | Berhasil setelah tampilan dari berbagai sudut seluruh tubuh dihilangkan |
| Petunjuk asli, gambar referensi dihilangkan, lalu menggunakan endpoint teks ke gambar | 1/1 berhasil | 29.1 detik | Berhasil setelah ciri-ciri orang dalam gambar referensi dihilangkan |
| Hanya menambahkan “pakaian lengkap, tidak tembus pandang, dan tidak diseksualisasi” | 1/1 tetap menghasilkan 451 | 216.8 detik | Kalimat negatif tidak efektif |
| Secara spesifik menyebutkan orang dewasa, atasan berlengan panjang berkerah tinggi, celana panjang, dan sepatu olahraga | 3/3 berhasil | 65.1–238.6 detik | Berhasil secara konsisten setelah pakaian dijelaskan secara positif |
Cara 451 image_safety terpicu berdasarkan pengujian ulang dalam dokumentasi
Hal yang paling menarik dari pengujian ini adalah kelompok kedua dan ketiga: permintaan berhasil menghasilkan gambar jika salah satu dari dua unsur—“ciri-ciri orang dalam gambar referensi” atau “tampilan seluruh tubuh dari berbagai sudut”—dihilangkan. Berdasarkan hasil tersebut, dokumentasi menyimpulkan bahwa penjelasan yang paling didukung adalah: filter terpicu saat ciri-ciri orang dalam gambar referensi dipadukan dengan tampilan seluruh tubuh dari berbagai sudut.
Dokumentasi juga menegaskan kesimpulan yang tidak bisa ditarik dari hasil ini: kita tidak bisa menyatakan bahwa gambar referensinya melanggar aturan, ataupun bahwa ada satu kata tertentu yang menjadi pemicu. Ini penting. Banyak developer yang melihat 451 langsung mengganti gambar referensi atau menghapus banyak kata, sehingga informasi visual yang sebenarnya dibutuhkan ikut terhapus.
Mengapa kalimat negatif tidak berhasil mengatasi 451 image_safety
Pada kelompok keempat, hanya ditambahkan “pakaian lengkap, tidak tembus pandang, dan tidak diseksualisasi”, tetapi hasilnya tetap 451. Pada kelompok kelima, deskripsinya diubah menjadi positif dan spesifik: orang dewasa, atasan berlengan panjang berkerah tinggi, celana panjang, dan sepatu olahraga. Ketiga percobaan berhasil.
Alasannya sederhana. Kalimat negatif hanya memberi tahu model “apa yang tidak boleh dibuat”, tanpa menjelaskan “apa yang harus digambar”. Akibatnya, gambar yang dihasilkan tetap tidak pasti. Deskripsi positif menetapkan atasan, bawahan, dan sepatu secara spesifik, sehingga hasilnya lebih mudah dikendalikan dan lebih mudah lolos pemeriksaan di sisi output.
Terkait durasi, dokumentasi secara khusus mengingatkan bahwa durasi hanya bisa dijadikan acuan tambahan dan tidak bisa digunakan sendirian untuk menentukan di lapisan mana pemeriksaan berlangsung. Rentang durasi keberhasilan dan kegagalan dalam pengujian ini saling tumpang tindih. Jadi, hindari logika seperti “kalau lebih dari X detik, berarti diblokir oleh pemeriksaan”.
Catatan perbandingan: Data dalam tabel dan gambar perbandingan di atas berasal dari pengujian ulang dokumentasi APIYI. Artikel aslinya dapat dibaca di FAQ pemeriksaan keamanan output gambar pada pusat dokumentasi apiyi.com, sehingga kamu bisa membandingkannya dengan error yang kamu alami.
Panduan cepat mengatasi respons 451 image_safety saat membuat gambar
Periksa kembali ID model: pastikan model gpt-image yang Anda gunakan
Setelah memastikan responsnya 451, langkah kedua adalah memeriksa ID model. Pengujian ulang dalam dokumentasi menggunakan gpt-image-2.5-sunburst-vip. Untuk mengetahui model apa saja yang tersedia dalam seri gpt-image dan nama masing-masing, lihat daftar model APIYI. Anda bisa memeriksanya di daftar model pada konsol apiyi.com.
Ada dua alasan untuk memeriksa ID model. Pertama, model harus tetap sama selama proses pemeriksaan agar Anda bisa mengetahui variabel mana yang berpengaruh. Kedua, langkah ini mencegah kesalahan seperti “nama model salah” disalahartikan sebagai masalah moderasi. Nama model yang salah biasanya menghasilkan jenis kesalahan lain, bukan image_safety.
Parameter permintaan saat menelusuri masalah 451 image_safety
Artikel ini tidak menyertakan blok kode panjang, tetapi hanya mencantumkan parameter yang perlu dipertahankan saat menelusuri masalah. Antarmukanya kompatibel dengan format OpenAI. Isi base_url dengan https://api.apiyi.com/v1, lalu ganti api_key di SDK dengan Key Anda sendiri.
| Parameter | Contoh nilai | Boleh diubah saat penelusuran masalah? |
|---|---|---|
base_url |
https://api.apiyi.com/v1 |
Jangan diubah |
model |
Ikuti daftar model APIYI, misalnya gpt-image-2.5-sunburst-vip yang digunakan dalam pengujian ulang dokumentasi |
Jangan diubah |
| Endpoint | Edit gambar (dengan gambar referensi) atau teks ke gambar | Jangan diubah, kecuali jika sedang menguji dampak gambar referensi secara khusus |
| Gambar referensi | Gambar referensi asli | Jangan diubah |
| Parameter ukuran, jumlah, dan lainnya | Pertahankan nilai asli | Jangan diubah |
prompt |
Petunjuk asli | Ubah hanya satu variabel setiap kali |
Di tingkat kode, sebaiknya tambahkan cabang khusus untuk 451: baca kode status respons dan error.code. Jika statusnya 451 dengan kode image_safety, catat petunjuk yang digunakan saat itu, hentikan percobaan ulang otomatis, lalu lanjutkan dengan proses penulisan ulang secara manual atau berdasarkan aturan. Untuk 401, gunakan cabang pemeriksaan Key; untuk 429, gunakan cabang percobaan ulang dengan jeda bertahap. Ketiga jalur ini tidak boleh dicampur.
Langkah penelusuran masalah 451 image_safety dengan satu variabel
Metode penelusuran masalah dalam dokumentasi dapat disusun menjadi langkah-langkah berikut:
- Pertahankan kondisi lainnya: model, endpoint, gambar referensi, dan semua parameter tetap sama; hanya ubah petunjuk.
- Ubah satu variabel setiap kali: misalnya, hanya ubah pakaian atau jumlah tampilan. Jangan mengubah tiga hal sekaligus.
- Ganti kalimat negatif dengan deskripsi positif: jelaskan atasan, bawahan, dan sepatu secara spesifik, misalnya “lengan panjang berkerah tinggi, celana panjang, sepatu olahraga”. Jika perlu, tegaskan bahwa tokohnya adalah “orang dewasa”.
- Ulangi pengujian 2–3 kali: satu kali berhasil bukan berarti hasilnya stabil. Dalam pengujian ulang dokumentasi, kombinasi yang stabil berhasil 3/3 kali.
- Hentikan percobaan ulang jika kombinasi asli terus gagal: jika kelompok baseline gagal 3/3 kali, mengulangi permintaan yang sama tidak ada gunanya.
- Pisahkan kombinasi hanya jika perlu mencari penyebabnya: uji secara terpisah dengan “menghapus tampilan seluruh tubuh dari beberapa sudut” dan “menghapus gambar referensi” untuk mengetahui kombinasi mana yang memicu penyaringan.
🚀 Mulai cepat: Jika ingin mereproduksi dan memvalidasi masalah terlebih dahulu di lingkungan yang bersih, Anda bisa mendapatkan kuota uji coba gratis melalui APIYI apiyi.com. Gunakan Key yang sama dan pertahankan model serta parameternya untuk membandingkan satu variabel setiap kali. Setelah validasi selesai, barulah integrasikan ke alur produksi.
451 Contoh penulisan ulang petunjuk image_safety
Berikut beberapa arah penulisan ulang berdasarkan pendekatan pengujian ulang sesuai dokumentasi. Silakan sesuaikan dengan kebutuhan bisnis Anda.
| Arah penulisan ulang | Penulisan yang kurang efektif | Penulisan yang disarankan |
|---|---|---|
| Pakaian | Jangan terbuka, pakaian harus lengkap | Atasan lengan panjang berkerah tinggi, celana panjang, sepatu olahraga |
| Tokoh | Seorang model | Tokoh dewasa yang dinyatakan secara jelas |
| Tampilan | Sekali buat close-up wajah serta tampilan seluruh tubuh dari depan, samping, dan belakang | Buat potret setengah badan terlebih dahulu, atau buat tampilan secara bertahap |
| Gaya | Jangan dibuat seksi | Pakaian sehari-hari bergaya netral, pose berdiri yang natural |
Inti penulisan ulang adalah mempersempit ruang tafsir yang ambigu. Semakin spesifik deskripsinya, semakin sedikit ruang bagi model untuk berimprovisasi, sehingga kemungkinan gambar yang dihasilkan terkena filter pun makin rendah.
FAQ
Q1: Apa itu 451 image_safety?
Artinya gambar sudah dibuat, tetapi hasilnya tidak lolos pemeriksaan keamanan. Karena itu, API tidak mengembalikan gambar dan justru memberikan HTTP 451 dengan `error.code` bernilai `image_safety`. Ini adalah pemeriksaan setelah pembuatan, yang juga disebut pemeriksaan di sisi keluaran.
Q2: Apa perbedaan 451 image_safety dan 401? Apakah keduanya perlu dicoba ulang?
401 terjadi saat permintaan masuk dan berkaitan dengan validitas kunci API. Sementara itu, 451 terjadi setelah gambar dibuat dan berkaitan dengan isi gambar. Keduanya tidak bisa ditangani dengan logika percobaan ulang yang sama: untuk 401, perbaiki konfigurasi kunci API; untuk 451, ubah deskripsi gambar. Mencoba ulang tanpa perubahan tidak akan membantu untuk keduanya.
Q3: Bagaimana membedakan 451 image_safety dan 429?
429 berarti permintaan terkena pembatasan laju atau kanal sedang sibuk. Biasanya, permintaan bisa berhasil setelah dicoba ulang dengan jeda bertahap; jika perlu, Anda juga bisa beralih kanal. Sementara itu, 451 berarti konten telah difilter. Jika kombinasi yang sama terus dicoba, permintaan akan tetap gagal. Periksa `error.code` untuk membedakannya. Jika nilainya `image_safety`, tangani sebagai masalah konten.
Q4: Jika menerima 451 image_safety, apakah itu berarti gambar referensi saya melanggar aturan?
Tidak bisa langsung disimpulkan begitu. Dalam pengujian ulang yang didokumentasikan, gambar referensi yang sama berhasil menghasilkan gambar setelah deskripsinya diubah menjadi potret setengah badan dengan pakaian sehari-hari yang netral. Kesimpulan dokumen lebih mendukung dugaan bahwa kombinasi ciri-ciri tokoh dalam gambar referensi dengan beberapa tampilan seluruh tubuh memicu filter pada gambar yang dihasilkan. Ini bukan berarti gambar referensinya sendiri melanggar aturan, dan kita juga tidak bisa menyimpulkan bahwa ada kata tertentu yang menjadi pemicunya.
Q5: Bagaimana memastikan model gpt-image yang saya gunakan dan mereproduksi 451?
Ikuti langkah-langkah berikut:
1. Daftar di APIYI apiyi.com untuk mendapatkan kunci API dan kuota uji coba gratis.
2. Periksa ID model gpt-image yang tepat di daftar model.
3. Atur `base_url` ke `https://api.apiyi.com/v1`, tetapkan model dan parameternya, lalu lakukan pemeriksaan dengan mengubah satu variabel pada setiap percobaan, sesuai langkah-langkah dalam artikel ini.
Q6: Bisakah saya mengetahui apakah permintaan terhalang pemeriksaan dengan melihat durasinya?
Tidak disarankan. Dokumen menjelaskan bahwa durasi hanya bisa menjadi petunjuk tambahan dan tidak cukup untuk menentukan lapisan pemeriksaan secara pasti. Dalam pengujian ulang, rentang durasi untuk permintaan yang berhasil dan gagal saling tumpang tindih. Logika yang menentukan hasil berdasarkan ambang durasi berisiko menghasilkan kesimpulan yang keliru.
Q7: Jika petunjuk sudah berhasil setelah diubah, apakah sudah aman untuk dirilis?
Belum cukup. Dokumen menyarankan pengujian regresi sebanyak 2 hingga 3 kali karena keberhasilan satu kali belum tentu stabil. Dalam pengujian ulang, kombinasi yang stabil berhasil 3/3 kali. Sebaiknya gunakan standar yang sama untuk pengujian penerimaan sebelum merilisnya.
Poin Utama image_safety 451
- Objek yang diperiksa: Filter
image_safety451 memeriksa gambar yang dihasilkan, bukan kunci API. - Periksa kode error terlebih dahulu: 451, 401, dan 429 masing-masing berkaitan dengan konten, autentikasi, dan pembatasan laju. Cara menanganinya berbeda.
- Jangan samakan strategi percobaan ulang: Perbaiki kunci API untuk 401, coba lagi dengan jeda bertahap untuk 429, dan ubah deskripsi gambar untuk 451.
- Lakukan pemeriksaan dengan satu variabel: Tetapkan model, endpoint, gambar referensi, dan parameter. Ubah satu bagian petunjuk saja setiap kali.
- Deskripsi positif lebih efektif: Jelaskan atasan, bawahan, dan sepatu secara spesifik. Cara ini lebih andal daripada menambahkan kalimat negatif.
- Lakukan pengujian regresi: Setelah menulis ulang, lakukan pengujian regresi 2–3 kali dan pastikan hasilnya konsisten sebelum dirilis.
- Cara memulai: Gunakan daftar model APIYI sebagai acuan untuk ID model, lalu manfaatkan kuota gratis untuk melakukan pengujian perbandingan.
Ringkasan
Inti yang perlu diketahui saat pembuatan gambar menghasilkan error 451 image_safety:
- Pahami jenis errornya: Ini adalah pemeriksaan di sisi output yang memblokir gambar hasil pembuatan, bukan masalah kunci API, saldo, atau pembatasan laju.
- Pisahkan penanganannya: Bedakan 451 dari 401 dan 429 berdasarkan kode status dan
error.code. Jangan gunakan strategi percobaan ulang yang sama untuk semuanya. - Ubah pendekatannya: Tetapkan variabel lainnya, lalu ganti kalimat negatif dengan deskripsi positif yang spesifik tentang pakaian dan komposisi gambar. Setelah itu, lakukan pengujian regresi 2–3 kali.
Saat menemui error 451, jangan buru-buru mengganti kunci API. Coba tulis deskripsi gambar yang lebih spesifik. Sebaiknya gunakan APIYI apiyi.com dengan kunci API yang sama dan model yang tetap untuk melakukan pengujian perbandingan dengan satu variabel, sehingga Anda bisa menemukan deskripsi yang hasil gambarnya konsisten.
📚 Referensi
- FAQ APIYI: Tinjauan Keamanan Output Gambar: Definisi
image_safety451 dan cara menelusuri masalahnya - Tautan:
docs.apiyi.com/faq/image-output-safety-review.md -
Keterangan: Mencakup bentuk respons, penjelasan tinjauan pascaproses, dan saran penelusuran dengan mengubah satu variabel setiap kali
-
Pembaruan APIYI: Tinjauan Keamanan Output Gambar (2026-11): Catatan pengujian ulang dokumentasi
- Tautan:
docs.apiyi.com/live/2026-11/image-output-safety-review.md - Keterangan: Berisi pengujian ulang anonim pada
gpt-image-2.5-sunburst-vipbeserta batasan kesimpulannya
Penulis: Tim Teknologi APIYI
Diskusi teknis: Hubungi kami melalui beranda APIYI di apiyi.com. Informasi selengkapnya tentang kode kesalahan antarmuka gambar tersedia di pusat dokumentasi docs.apiyi.com.
