Görüntü Üretimi

TokenLab, kamuya açık görüntü uç noktaları aracılığıyla metinden görüntüye, görüntüden görüntüye ve görüntü düzenleme desteği sunar. Görüntü modelleri tek bir evrensel parametre setini paylaşmaz, bu nedenle üretim istemcileri önce uç noktasını seçmeli, ardından modeli seçmeli ve yalnızca o model tarafından desteklenen alanları göndermelidir.

Her Uç Noktayı Ne Zaman KullanmalısınızCopy Anchor Link

Her zaman model gönderin. Görüntü uç noktaları, üretim trafiği için kasıtlı olarak tarihsel bir örtük varsayılan modele dayanmaz.

Bir Model SeçinCopy Anchor Link

Model keşfine başlayın, ardından seçilen modelin TokenLab sözleşmesini inceleyin:

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

Sohbet dışı modeller için, liste yanıtı GET /v1/models içerebilir. Model detay sayfaları daha kapsamlı GET /v1/models/{model} sunabilir. Bu alanları doğrulamak için kullanın:

• 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ıCopy Anchor Link

• 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ğiCopy Anchor Link

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ğiCopy Anchor Link

curl https://api.tokenlab.sh/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "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önetmeCopy Anchor Link

Görüntü yanıtları senkron veya asenkron olabilir:

• 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"

Dönen görüntü URL'sini, görev kimliğini, modeli ve kendi kullanıcı/görev kimliğinizi saklayın. Terminal durumu sonrasında sorgulamayı sürdürmeyin.

Üretim Kontrol ListesiCopy Anchor Link

• 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 HatalarCopy Anchor Link

API ReferansıCopy Anchor Link