xAI API görsel üretimi: aspect_ratio ve b64_json

Kısa yanıt: xAI ile görsel üretimi

LLMTR (llmtr.com), Türkiye'de ve global sağlayıcılarda barındırılan dil modellerine tek, OpenAI uyumlu API'den erişim veren bir gateway'dir. xAI görselleri için model değerini xai/grok-imagine-image-quality olarak gönderin ve POST https://llmtr.com/v1/images/generations adresini kullanın. aspect_ratio ve resolution alanlarını isteğe ekleyin; response_format için b64_json seçtiğinizde görsel data[0].b64_json içinde base64 olarak döner.

Başlangıç için 16:9, resolution: 1k ve n: 1 içeren tek görsellik bir istektir. response_format alanında url da kabul edilir; ancak bağlantı xAI tarafından barındırılır ve kısa ömürlüdür. Kalıcı dosya akışı için b64_json kullanın, yanıtı base64 çözün ve baytları uygun dosyaya yazın. İstek, Authorization: Bearer biçiminde API anahtarıyla gönderilir. aspect_ratio xAI'ye yazıldığı gibi iletilir; resolution için yalnızca 1k veya 2k kullanılmalıdır.

xAI API ile görsel üretimi: aspect_ratio, grok-imagine-image-quality ve b64_json nasıl kullanılır?

xAI API görsel üretiminde aspect_ratio değerini 16:9 veya 1:1 gibi bir metin olarak gönderin; LLMTR bunu xAI'ye değiştirmeden iletir. resolution alanı 1k veya 2k kabul eder, response_format ise b64_json ya da url olabilir; 2026-10-06 tarihli xAI fiyat sayfasında kalite modeli 0,05 $, standart model 0,02 $ / görsel olarak listelenir.

Başka bir aspect_ratio değerinin kabul edip edilmediğini xAI görsel üretim belgelerindeki listeden kontrol edin. resolution alanı 1k veya 2k kabul eder; 1K/2K biçimleri de geçerlidir. Farklı bir değer 400 döndürür ve hata, xAI görsel çözünürlüğünün 1k veya 2k olması gerektiğini söyler. response_format için başka bir değer de 400 döndürür. Kalite modelinin fiyatı standart modelin 2,5 katı olduğu için model seçimi toplam görsel maliyetini etkiler.

• xAI Docs, Image generation · 2026-10-06
• xAI Docs, Pricing · 2026-10-06

Tam curl isteği: 16:9, 1k ve b64_json

Aşağıdaki curl örneği, xai/grok-imagine-image-quality modeline 16:9 oranında, 1k resolution ve b64_json yanıt biçimiyle tek bir görsel ister. Yetkilendirme için LLMTR_API_KEY ortam değişkenini Authorization başlığında Bearer olarak gönderin. model, prompt, aspect_ratio, resolution, response_format ve n alanlarını istek gövdesinde görüldüğü gibi aynen iletin.

Bu curl isteği, 16:9, 1k ve b64_json değerleriyle tek görsel ister.

curl https://llmtr.com/v1/images/generations \
  -H "Authorization: Bearer $LLMTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "xai/grok-imagine-image-quality",
    "prompt": "Product photo of a ceramic coffee cup on a wooden table, soft morning light",
    "aspect_ratio": "16:9",
    "resolution": "1k",
    "response_format": "b64_json",
    "n": 1
  }'

b64_json yanıtını Python ile cup.jpg dosyasına yazmak

Yukarıdaki Python kodu, POST isteğini gönderdikten sonra data[0].b64_json değerini base64 olarak çözer. Çözülen baytları cup.jpg adlı dosyaya ikili modda yazar. Böylece API yanıtındaki base64 metni, uygulamada kullanılabilen bir görsel dosyasına dönüşür. model, prompt, aspect_ratio, resolution, response_format ve n değerleri JSON gövdesinde tanımlanır.

response_format: url seçildiğinde yanıt, xAI tarafından barındırılan kısa ömürlü bir adrese yönlendirir; dosyayı hemen indirin. LLMTR'nin önerdiği b64_json seçeneği ise görsel verisini doğrudan JSON içinde döndürür. Kodda LLMTR_API_KEY ortam değişkeni okunur ve istek, JSON gövdesiyle 120 saniyelik timeout değeriyle istemci tarafından gönderilir.

Bu Python örneği, data[0].b64_json verisini çözüp cup.jpg dosyasına yazar.

import base64
import os

import requests

response = requests.post(
    "https://llmtr.com/v1/images/generations",
    headers={"Authorization": f"Bearer {os.environ['LLMTR_API_KEY']}"},
    json={
        "model": "xai/grok-imagine-image-quality",
        "prompt": "Product photo of a ceramic coffee cup on a wooden table, soft morning light",
        "aspect_ratio": "16:9",
        "resolution": "1k",
        "response_format": "b64_json",
        "n": 1,
    },
    timeout=120,
)
response.raise_for_status()
image_bytes = base64.b64decode(response.json()["data"][0]["b64_json"])
with open("cup.jpg", "wb") as file:
    file.write(image_bytes)

Kalite mi standart mı: görsel başına fiyat ve düzenleme

xai/grok-imagine-image-quality görsel başına 0,05 $, xai/grok-imagine-image ise 0,02 $ alır. Kalite modelinin fiyatı standart modelin 2,5 katıdır; çözünürlük için ayrı bir fiyat belirtilmemiştir. n değeri görsel sayısını belirler ve her görsel ayrıca ücretlendirilir. Kalite modelinde n = 4, 4 × 0,05 $ = 0,20 $ tutar.

1.000 görsel için kalite modelinin toplam maliyeti 50,00 $, standart modelinki ise 20,00 $ olur. LLMTR, xAI'nin istek için bildirdiği maliyeti tahsil eder. Mevcut bir görseli düzenlemek ise POST /v1/images/edits adresine yapılır; LLMTR üzerinde bu uç nokta xAI görsel modelleri için kullanılabilir. Üretim çağrılarını /v1/images/generations üzerinden, düzenleme çağrılarını /v1/images/edits üzerinden yapın.

LLMTR ile başlamak: hesap, kredi, anahtar ve ilk istek

1. adım: llmtr.com üzerinden hesap oluşturun ve e-posta adresinizi doğrulayın. 2. adım: Dashboard üzerinden kredi yükleme yapın. İstenen tutarın üzerine bir kez %8 platform marjı eklenir; 10,00 $ kredi için 10,80 $ tahsil edilir. Platform marjı model fiyatlarına eklenmez; her API çağrısı modelin katalog fiyatından düşülür.

3. adım: Dashboard > API Keys bölümünde API anahtarı oluşturun. Ham anahtar yalnızca bir kez gösterilir; LLMTR_API_KEY gibi bir ortam değişkeninde saklayın. 4. adım: OpenAI uyumlu herhangi bir SDK'da base_url değerini https://llmtr.com/v1 yaparak ilk isteği gönderin ve yalnızca api_key değerini değiştirin. Dashboard kullanım sayfasından anahtar bazında kullanım ve harcama görünür. Aynı anahtar ve kredi bakiyesi katalogdaki her model için çalışır; model değiştirmek model dizesini değiştirmek demektir.

xAI API ile görsel üretimini başlatma

Hesap, kredi ve API anahtarı adımlarıyla xAI görsel üretimi isteğini göndermeye yönelik dört adımlık başlangıç akışı.

1. Hesap oluştur. llmtr.com üzerinden hesap oluşturun ve e-posta adresinizi doğrulayın.
2. Kredi yükle. Dashboard üzerinden kredi yükleyin. İstenen tutara bir kez %8 platform marjı eklenir; 10,00 $ için 10,80 $ tahsil edilir.
3. API anahtarı oluştur. Dashboard > API Keys bölümünde anahtar oluşturun. Ham anahtar yalnızca bir kez gösterildiği için LLMTR_API_KEY ortam değişkeninde saklayın.
4. İlk görsel isteğini gönder. OpenAI uyumlu SDK'da base_url değerini https://llmtr.com/v1 yapın, api_key değerini LLMTR anahtarınızla değiştirin ve POST /v1/images/generations isteğini gönderin.

Sık sorulan sorular

xAI görsellerinde url mı, b64_json mı kullanılmalı?

response_format için url yerine b64_json kullanın. url kısa ömürlü bir xAI adresine işaret eder; b64_json görseli data[0].b64_json içinde döndürür.

resolution hangi değerleri kabul ediyor?

resolution yalnızca "1k" veya "2k" değerlerini kabul eder; büyük harfli 1K/2K de geçerlidir. Başka bir değer 400 hatası döndürür.

grok-imagine-image-quality görsel başına ne kadar?

xai/grok-imagine-image-quality görsel başına 0,05 $, xai/grok-imagine-image ise 0,02 $. Kalite modelinde n = 4 toplam 0,20 $ tutar.

İlgili yazılar

• Grok Imagine Image Quality: standart tier'e karşı 2,5 katı fiyat ne zaman gerekçeli
• Grok Imagine Image: standart tier çoğu ürün işi için neden yeterli

• Görsel üretimi rehberi
• Grok Imagine Image Quality modeli
• Fiyatlandırma