Görüntü Üretimi

​

Her Uç Noktayı Ne Zaman Kullanmalısınız

​

Bir Model Seçin

curl "https://api.tokenlab.sh/v1/models?recommended_for=image" \
  -H "Authorization: Bearer sk-your-api-key"

• Desteklenen işlem, örneğin text-to-image, image-to-image veya image-edit.
• Modelin beklediği istek uç noktası.
• Referanslar için hangi şeklin kullanılacağı, örneğin image_url, image_urls, reference_image_urls, çok parçalı image veya JSON images[].
• Modelin size, aspect_ratio, resolution, quality, background, output_format veya response_format kabul edip etmediği.

​

İstek Şekli Kuralları

• gpt-image-2 tarzı istekler, OpenAI benzeri size, quality ve düzenleme alanlarını kullanır. Oluşturma ve düzenlemede background, auto veya opaque kabul eder; transparent desteklenmez. Modelin veya TokenLab’ın otomatik varsayılanları kullanmasını istiyorsanız isteğe bağlı alanları dışarıda bırakın.
• Gemini ve Nano Banana görüntü aileleri genellikle aspect_ratio kullanır; yalnızca model sözleşmesi bunu açığa çıkardığında resolution gönderin.
• Nano Banana görüntüden görüntüye, operation: "image-to-image" ve referans görüntü URL’leri ile /v1/images/generations üzerinde yer alır.
• /v1/images/generations üst düzey images[] veya file_id kabul etmez; bunlar düzenleme akışı şekilleridir.
• Uzaktan görüntü referansları, kamuya açık http veya https URL’leri olmalıdır. Özel ağ URL’leri, gömülü kimlik bilgileri, URL parçaları veya işleme başlamadan önce süresi dolabilecek imzalı URL’ler göndermeyin.

​

Metinden Görüntüye Örneği

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Ceviz masasında bir seramik kahve fincanının temiz bir ürün fotoğrafı",
    "size": "1024x1024",
    "response_format": "url"
  }'

​

Referans-Görüntü Örneği

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "operation": "image-to-image",
    "prompt": "Ürün şekli korunmalı, arka plan parlak bir stüdyo düzenine değiştirilmelidir",
    "image_urls": ["https://example.com/input/product.png"],
    "aspect_ratio": "1:1"
  }'

​

Sonuçları Yönetme

• Senkron yanıtlar, url veya b64_json ile nihai data[] döner.
• Asenkron yanıtlar id, task_id, status ve genellikle poll_url döner.
• poll_url mevcut olduğunda tercih edin. Sabit bir yol gerekiyorsa, GET /v1/tasks/{id} ile sorgulayın.
• Özellikle b64_json gerektiğinde senkron istekler kullanın; asenkron görüntü sonuçları URL odaklıdır.

curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"

​

Üretim Kontrol Listesi

• TokenLab’ı çağırmadan önce kullanıcı girdilerini doğrulayın: istem uzunluğu, görüntü sayısı, URL erişilebilirliği ve dosya türü.
• Senkron yüksek çözünürlüklü istekler için HTTP zaman aşımını yeterince yüksek ayarlayın. Uzun işler için mevcut olan yerlerde asenkron modu kullanın.
• Destek için request_id, task_id, poll_url, model, uç nokta ve temizlenmiş istek şekli saklayın.
• İstemci zaman aşımında, yeniden oluşturma isteğini denemeden önce bir görevin oluşturulup oluşturulmadığını kontrol edin.
• Maliyetleri kullanım kayıtları ve mevcutsa billing_transaction_id ile uzlaştırın, sağlayıcı görev kimlikleri ile değil.

​

Yaygın Hatalar

​

API Referansı