Görseller

Görüntü Varyasyonu Oluştur

Verilen bir görüntünün varyasyonunu oluşturur

POST
/v1/images/variations

Genel Bakış

Bu uç nokta, mevcut OpenAI Variations istemcilerini destekler. Yeni görüntüden görüntüye (image-to-image) özellikler için, güncel bir görüntüden görüntüye modeli ile /v1/images/edits veya /v1/images/generations uç noktalarını kullanın. İstekler multipart/form-data formatını kullanır.

İstek Gövdesi

Bu uç nokta senkrondur: yanıt nihai görüntüyü içerir ve asla bir görev (task) döndürmez. HTTP istemcinizin zaman aşımı süresini en az 120s olarak ayarlayın.

imagefilezorunlu

Multipart kaynak görüntü. Dosya ve tam istek gövdesinin her biri 50 MiB sınırına sığmalıdır (daha büyük yüklemeler 413 hatası döndürür). Desteklenen formatlar ve boyutlar seçilen modele bağlıdır. Yalnızca detaylarında image-to-image ile /v1/images/variations eşleşmesi bulunan modeller kabul edilir; diğer tüm modeller 400 hatası döndürür.

modelstringzorunlu

Model Kimliği. Bu uç noktanın varsayılan bir modeli yoktur. Örneklerde your-legacy-variation-model yer tutucusu kullanılmıştır: bunu, detaylarında bu uç noktanın listelendiği bir model ile değiştirin.

nintegervarsayılan: 1

Oluşturulacak görüntü sayısı (1-10 arası, modele bağlıdır).

sizestring

Oluşturulan görüntü boyutu. Desteklenen değerler seçilen modele bağlıdır.

response_formatstring

Oluşturulan görüntülerin döndürülme 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 bir tanımlayıcı.

Yanıt

createdinteger

Görüntülerin oluşturulduğu Unix zaman damgası.

dataarray

Oluşturulan görüntü varyasyonlarının dizisi.

Her nesne şunları içerir:

  • url (string): Varyasyon görüntüsünün URL'si (eğer response_format url ise)
  • b64_json (string): Base64 kodlu görüntü (eğer 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

Response
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Notlar

Bu, eski bir uyumluluk uç noktasıdır. Mevcut önerilen görüntü modeli kataloğuna dahil değildir. Yeni entegrasyonlar için gpt-image-2 ile /v1/images/edits uç noktasını veya operation: "image-to-image" ve güncel bir görüntüden görüntüye modeli ile /v1/images/generations uç noktasını 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

application/json

application/json