Resim istekleri
Tahmin edilebilir bir API isteğiyle resim yanıtlarını kullanın.
İstemleri güvende tutarken, sunucu tarafında kimlik bilgilerini ve görüntü kullanımını görünür tutarken, döndürülen URL'ler veya b64_json yükleriyle OpenAI uyumlu görüntüler uç noktası aracılığıyla görüntü isteği işlemeyi kontrol edin.
Son güncelleme: July 12, 2026. Examples kullanım safe placeholders ve yap değil içerir real API anahtarıs, gizli bilgiler, customer yükler, veya hassas promptlar.
Varsayılan yol
Tek bir resim, standart bir kare boyut ve URL yanıt biçimiyle başlayın. Yalnızca iş akışının gerektirdiği durumlarda daha büyük boyutları veya base64'ü ekleyin.
Kurulum yolu
İstemden döndürülen varlık şekline dört adım.
Step 1
Sunucu tarafı kimlik doğrulaması
Görüntüler için bir API anahtarı kullanın: güvenilir sunucu tarafı kodundan yazma kapsamı.
Bölümü açStep 2
Bir istem gönder
Görüntülerin uç noktasına güvenli bir bilgi istemi, görüntü sayısı, boyut ve yanıt biçimi gönderin.
Bölümü açStep 3
İade edilen varlıkları okuyun
Uygulamanızın talep ettiği yanıt_formatına göre döndürülen URL'leri veya b64_json veri yüklerini kullanın.
Bölümü açStep 4
Resim kullanımını izleyin
Görüntü istekleri, günlükler ve hız sınırı incelemesi için istek hacmini, bilgi istemi belirteçlerini ve döndürülen görüntü öğelerini kaydeder.
Bölümü açUç nokta
Görüntülerin uç noktasına istemler gönderin.
Görüntü iş akışları müşterilere ulaşmadan önce, kapsamlı sunucu tarafı anahtarıyla /v1 görüntü rotasını kullanın. Anlık içeriği güvende tutun ve görsel isteklerine hassas veriler yerleştirmekten kaçının.
| Öğe | Değer | Notlar |
|---|---|---|
| Yöntem | POST | Görüntünün uç noktasına JSON gönderin. |
| Uç nokta | https://unlimitedcodex.com/v1/images/generations | OpenAI uyumlu /v1 resim yolunu kullanın. |
| Yetkilendirme | Hamiline ait jeton | Kapsamlı bir API anahtarını resimler:yazma erişimiyle kullanın. |
| İçerik türü | uygulama/json | İstek gövdesi geçerli olmalıdır: JSON. |
Şekil iste
İlk isteği küçük tutun.
Akışı doğrularken tek bir resim ve URL çıkışıyla başlayın. Sayımı, boyutu veya satır içi base64'ü yalnızca kullanıcı arayüzünüz ve ücret işlemeniz hazır olduktan sonra artırın.
| Alan | Durum | Notlar |
|---|---|---|
| modeli | Önerilen | Bir görüntü modeli değerini açıkça iletin. Teslim ettiğiniz kurulum ayrıntılarındaki model değerini kullanın. |
| istem | Gerekli | 4000 karaktere kadar boş olmayan bir istem gönderin. Sırlardan, düzenlemeye tabi verilerden ve müşteriyi tanımlayan ayrıntılardan kaçının. |
| n | İsteğe bağlı | 1 ila 4 resim isteyin. Varsayılan 1'dir. |
| boyut | İsteğe bağlı | 256x256, 512x512, 1024x1024, 1024x1792 veya 1792x1024'ü kullanın. Varsayılan 1024x1024'tür. |
| yanıt_formatı | İsteğe bağlı | Alınabilir bir varlık referansı için url'yi veya satır içi base64 verileri için b64_json'u kullanın. |
const response = await fetch("https://unlimitedcodex.com/v1/images/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.UCX_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "ucx-image-1",
prompt: "A clean product illustration of an API usage dashboard.",
n: 1,
size: "1024x1024",
response_format: "url"
})
});
const body = await response.json();
if (!response.ok) {
throw new Error(body.error?.code ?? "image_request_failed");
}
const firstImageUrl = body.data[0].url;Tepki şekli
Uygulamanızın istediği varlık biçimini okuyun.
Yanıt, istek meta verilerini ve döndürülen görüntü başına bir veri öğesini içerir. Response_format'a göre url veya b64_json kullanın.
| Alan | Anlamı | Notlar |
|---|---|---|
| kimlik | resim isteği kimliği | Günlükler ve destek yükseltme için kullanın. |
| yaratıldı | Unix zaman damgası | Yanıtın ne zaman oluşturulduğunu belirtir. |
| modeli | modeli dize | İstenen model değeriyle eşleşir. |
| boyut | talep edilen boyut | Uç nokta tarafından kabul edilen boyutla eşleşir. |
| veri[].url | varlık URL | Response_format url olduğunda döndürülür. |
| veri[].b64_json | base64 varlık verileri | Response_format, b64_json olduğunda döndürülür. |
{
"id": "img_example",
"created": 1783372800,
"model": "ucx-image-1",
"size": "1024x1024",
"data": [
{
"url": "https://unlimitedcodex.com/v1/images/example.png",
"revised_prompt": "A clean product illustration of an API usage dashboard."
}
]
}{
"model": "ucx-image-1",
"prompt": "A simple square app icon for an internal tool.",
"n": 1,
"size": "512x512",
"response_format": "b64_json"
}Sınırlar ve hatalar
Görüntü kullanımını ve yanıtların tamamını planlayın.
Görüntü isteği iş akışları, salt metin isteklerinden daha keskin kullanım artışları yaratabilir. Kampanyaları veya toplu işleri başlatmadan önce paketin uygunluğunu ve 429 işlemeyi kontrol edin.
Geçerli görüntü uç noktası kısmi ilerleme akışını sağlamaz; yanıt, istek tamamlandıktan sonra geri döner.
Döndürülen her resim öğesi kullanım görünürlüğü açısından günlüğe kaydedilir ve her çağrı bir istek olarak sayılır.
Bilgi istemi metni ayrıca belirteç ve maliyet tahminlerine de katkıda bulunur.
Bir iş akışını doğrularken küçük n değerleri kullanın ve ardından yalnızca ürünün birden fazla varyasyona ihtiyacı olduğunda artırın.
Arka plan görüntüsü işleri kullanıcının görebileceği bir hata yaratmadan önce 429 oranlı yanıtı yönetin.
SSS
Resim isteği soruları.
Hangi görüntü uç noktasını aramalıyım?
POST /v1/images/generations'yi Taşıyıcı API anahtarı, JSON istek gövdesi, model, bilgi istemi, isteğe bağlı görüntü sayısı, isteğe bağlı boyut ve isteğe bağlı yanıt_formatı ile kullanın.
Bir resim anahtarının hangi kapsama ihtiyacı vardır?
Images:write kapsamıyla bir API anahtarı kullanın. Sunucu tarafında tutun ve asla tarayıcı kodunda, mobil paketlerde, günlüklerde veya destek mesajlarında göstermeyin.
Görüntü istekleri akışı ilerleyebilir mi?
Hayır. Geçerli uç nokta, istek bittikten sonra tam bir yanıt döndürür. Uygulamanızda kullanıcıya yönelik yükleme durumları ve zaman aşımı yönetimi oluşturun.
URL mi yoksa b64_json mu istemeliyim?
Uygulamanız bir varlık referansını getirebildiğinde veya saklayabildiğinde URL'yi kullanın. Uygulamanız satır içi görüntü verilerine ihtiyaç duyduğunda ve daha büyük yanıt gövdelerini işleyebildiğinde b64_json'u kullanın.
Ücretsiz araçlar
Resim isteği hacmini planlayın
Lansmandan önce yükleri doğrulayın, kota etkisini tahmin edin, paket maliyetlerini karşılaştırın ve istek parçacıkları oluşturun.
Doğrulayıcı Talep Et
Sohbet, yerleştirmeler ve resim JSON verilerini unlimitedcodex OpenAI uyumlu kurallara göre doğrulayın.
Kota Tahmincisi
MAU ve bilgi istemi varsayımlarını aylık belirteçlere, isteklere ve kota eşiği uyarılarına dönüştürün.
Maliyet Hesaplayıcı
OpenAI aylık harcamayı tahmin edin ve bunu sabit unlimitedcodex haftalık veya aylık paketlerle karşılaştırın.
Oluşturucu İste
Sohbet tamamlamayı JSON görsel olarak oluşturun ve cURL, JavaScript veya Python parçacıklarını dışa aktarın.
Sonraki adım
Görüntü isteği işlemeyi hız sınırları ve hata işlemeyle eşleştirin.
Müşteriler görüntü çıktısına güvenmeden önce bilgi istemi politikasını, görüntü kullanımını, yeniden deneme davranışını ve yanıt depolamayı onaylayın.