Görsel Oluştur

Genel BakışCopy Anchor Link

Kod üreten ajanlar için önce GET /v1/models?recommended_for=image ile mevcut önerilen görsel shortlist’ini keşfedin, ardından seçilen modeli bu endpoint’e açıkça gönderin.

gpt-image-2, token bazlı ücretlendirilen bir GPT Image modelidir. TokenLab; metin girdisi, görsel girdisi, raporlandığında önbellek girdisi ve görsel çıktı token’ları için OpenAI’ın resmi usage dökümünü izler; sabit görüntü başı fiyat olarak faturalandırılmaz.

gpt-image-2 görüntü oluşturma için desteklenen herkese açık parametreler prompt, n, size, quality, response_format, async, background, output_format, output_compression veya compression, moderation ve user alanlarıdır. background, auto veya opaque kabul eder; transparent desteklenmez. size veya quality gönderilmezse TokenLab auto kullanır; özel size değerleri aşağıda belgelenen esnek WIDTHxHEIGHT sözleşmesini izlemelidir.

input_fidelity, TokenLab'in mevcut gpt-image-2 herkese açık sözleşmesinin parçası değildir; bu alanı atlayın, aksi halde istek 400 unsupported_parameter döner.

Model davranışı notlarıCopy Anchor Link

Google Gemini görsel aileleri aynı selector sözleşmesini paylaşmaz:

• gemini-3.1-flash-image, gemini-3-pro-image ve nano-banana-pro, public text-to-image ve image-edit/image-to-image işlemlerinde aspect_ratio ile birlikte resolution (1k, 2k, 4k) destekler.
• nano-banana-2, hem text-to-image hem de image-to-image için aspect_ratio ve resolution (1k, 2k, 4k) destekler.
• gemini-2.5-flash-image, nano-banana ve nano-banana-edit, aspect_ratio destekler fakat public resolution seçimi sunmaz.
• Nano Banana referans görsel istekleri için bu endpointte (/v1/images/generations) nano-banana-edit veya nano-banana-pro kullanın ve operation: "image-to-image" ile image_urls gönderin. Nano Banana referans görsel isteklerini /v1/images/edits endpointine göndermeyin.
• Bu endpointte referans görseller JSON image_url / image_urls olarak veya multipart image dosyası olarak gönderilebilir. /v1/images/generations, images[] ya da file_id kabul etmez; /v1/files referansları yalnızca images[].file_id dokümante eden /v1/images/edits modelleri için kullanılır.

Google görsel aileleri için aspect_ratio kullanmayı tercih edin ve resolution'ı yalnızca model açıkça destekliyorsa gönderin.

xAI Grok Imagine görsel modelleri (grok-imagine-image, grok-imagine-image-quality ve legacy grok-imagine-image-pro) aspect_ratio ile birlikte resolution (1k, 2k) destekler. grok-imagine-image-pro, grok-imagine-image-quality için uyumluluk ID’si olarak korunur.

İstek GövdesiCopy Anchor Link

Senkron istek zaman aşımı: Bazı görsel istekleri 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.

YanıtCopy Anchor Link

Senkron YanıtCopy Anchor Link

Asenkron görev yanıtıCopy Anchor Link

gpt-image-2 veya resmi FLUX/BFL görüntü modelleriyle async: true kullanarak oluşturma isteğinde nihai görüntüyü beklemek yerine bir görev oluşturun. Yanıt status: "pending", task_id ve poll_url içerir. Görev completed veya failed durumuna gelene kadar /v1/tasks/{task_id} adresini sorgulayın.

Asenkron görüntü görevleri yalnızca nihai görüntü URL’lerini döndürür. Ham b64_json görüntü verisi gerekiyorsa senkron istek kullanın.

Görev oluşturulurken tahmini tutar rezerve edilebilir. Tamamlanan görevler gerçek kullanıma göre ücretlendirilir; başarısız olan veya zaman aşımına uğrayan görevlerin rezervi serbest bırakılır veya iade edilir.

status: "pending" aldığınızda, sonucu almak için poll_url veya GET /v1/tasks/{task_id} kullanın.

curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "prompt": "A cinematic portrait of a white cat sitting on a rainy windowsill",
    "aspect_ratio": "16:9",
    "resolution": "2k"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokenlab.sh/v1"
)

response = client.images.generate(
    model="gemini-3-pro-image",
    prompt="A cinematic portrait of a white cat sitting on a rainy windowsill",
    extra_body={"aspect_ratio": "16:9", "resolution": "2k"}
)

print(response.data[0].url)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.tokenlab.sh/v1'
});

const response = await client.images.generate({
  model: 'gemini-3-pro-image',
  prompt: 'A cinematic portrait of a white cat sitting on a rainy windowsill',
  aspect_ratio: '16:9',
  resolution: '2k'
});

console.log(response.data[0].url);

<?php
$ch = curl_init('https://api.tokenlab.sh/v1/images/generations');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer sk-your-api-key'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'model' => 'gemini-3-pro-image',
        'prompt' => 'A cinematic portrait of a white cat sitting on a rainy windowsill',
        'aspect_ratio' => '16:9',
        'resolution' => '2k'
    ])
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $data['data'][0]['url'];

{
  "model": "gemini-2.5-flash-image",
  "prompt": "A clean editorial product shot of a citrus soda can",
  "aspect_ratio": "16:9"
}

{
  "model": "nano-banana-pro",
  "prompt": "Create a clean cinematic character image based on the reference images",
  "operation": "image-to-image",
  "image_urls": ["https://example.com/reference-1.png"],
  "aspect_ratio": "1:1",
  "resolution": "2k"
}

curl -X POST "https://api.tokenlab.sh/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=nano-banana-pro" \
  -F "prompt=Create a clean cinematic character image based on this reference" \
  -F "operation=image-to-image" \
  -F "image=@reference.png" \
  -F "aspect_ratio=1:1" \
  -F "resolution=2k"

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "A fluffy white cat with bright eyes sitting peacefully on a wooden windowsill, watching raindrops stream down the glass window..."
    }
  ]
}

Kullanılabilir ModellerCopy Anchor Link

Güncel görsel modelleri, yetenekleri ve fiyatları için GET /v1/models?recommended_for=image kullanın.

Bir modeli her zaman senkron ya da her zaman asenkron olarak hard-code etmeyin. Create yanıtı status: "pending" döndürürse, poll_url'ı takip edin ve tamamlanana kadar polling yapın.

Task Tabanlı Yanıtları İşlemeCopy Anchor Link

Görsel modeller için, yanıtın status: "pending" içerip içermediğini her zaman kontrol edin:

{
  "model": "hy-image-v3.5-preview",
  "prompt": "A yellow lemon on a white table",
  "size": "1024x1024",
  "n": 1,
  "response_format": "url"
}