TokenLab
API anahtarı al
DokümantasyonAPI ReferansıEntegrasyonlar

Görseller

Görsel Varyasyonu Oluştur

Verilen bir görselin varyasyonunu oluşturur

POST
/v1/images/variations

Genel Bakış

Bu endpoint, eski OpenAI uyumlu variation istemcileri için korunur. Güncel image-to-image iş akışları için önerilen yol değildir; mümkünse /v1/images/edits ile gpt-image-2 veya /v1/images/generations ile nano-banana-pro gibi bir image-to-image modeli kullanın. multipart/form-data gerektirir.

İstek Gövdesi

Senkron istek zaman aşımı: Bazı yönlendirilmiş görsel sağlayıcıları son görseli inline döndürür ve üretimin tamamlanmasını bekler. Yüksek çözünürlüklü veya yüksek kaliteli istekler bir dakikaya yakın ya da daha uzun sürebilir; bu yüzden HTTP istemcisi zaman aşımını en az 120s olarak ayarlayın. Oluşturma yanıtı status: "pending", task_id veya poll_url içeriyorsa, dönen poll_url ile polling yapın.

imagefilezorunlu

Multipart kaynak görsel. Dosya ve isteğin tamamı ayrı ayrı 50 MiB sınırını aşmamalıdır. Biçim ve boyutlar modele bağlıdır; güncel model ayrıntıları /v1/images/variations yolunu açıkça listelemelidir.

modelstringzorunlu

Eski variation uyumlu rotalar için zorunlu model kimliği. Örtük varsayılan yoktur; güncel image-to-image iş akışları için güncel bir modelle /v1/images/edits veya /v1/images/generations tercih edin.

nintegervarsayılan: 1

Üretilecek görsel sayısı (1-10, modele bağlı).

sizestring

Eski variation uyumlu rotalarda üretilen görüntülerin boyutu. Desteklenen değerler seçilen modele bağlıdır.

response_formatstring

Oluşturulan görsellerin döndürüleceği format. url veya b64_json olmalıdır.

userstring

Kötüye kullanım izleme için son kullanıcınızı temsil eden benzersiz tanımlayıcı.

Yanıt

createdinteger

Görsellerin oluşturulduğu Unix zaman damgası.

dataarray

Oluşturulan görsel varyasyonları dizisi.

Her nesne şunları içerir:

  • url (string): Varyasyon görselinin URL'si (response_format url ise)
  • b64_json (string): Base64 kodlu görsel (response_format b64_json ise)

İstek

curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-legacy-variation-model" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

Yanıt

Yanıt
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Notlar

Bu, legacy uyumluluk endpointidir. Güncel önerilen görüntü modeli kataloğuna dahil değildir. Yeni entegrasyonlar için /v1/images/edits ile gpt-image-2 veya /v1/images/generations içinde operation: "image-to-image" ve güncel bir image-to-image modeli kullanın.

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Başlıklar

X-TokenLab-Delivery-Policy?string

İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

  • "auto"
  • "verified"
  • "official"

İstek gövdesi

multipart/form-data

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json

Görsel Düzenle

Önceki

Görüntü Durumunu Al

Sonraki