Grok görsel düzenlemede image alanı formatı nedir?

Kısa yanıt: Grok image alanı ve LLMTR kullanımı

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. Ayrı bir image id gönderilmez; görsel image alanında doğrudan veri olarak veya bağlantıyla iletilir. LLMTR'nin https://llmtr.com/v1 taban adresinde Grok görsel düzenleme isteği POST /v1/images/edits olarak gönderilir ve yalnızca xai/grok-imagine-image ile xai/grok-imagine-image-quality modelleri desteklenir. Yerel dosya için data:image/ biçiminde bir data URI kullanılır.

Grok görsel düzenleme isteğinde ayrı bir image id alanı yoktur. xAI'ın image alanı için listelediği üç biçim genel URL, base64 kodlanmış data URI ve xAI Files API'den file_id değeridir. LLMTR'da HTTPS URL metni, url içeren nesne ve data:image/ ile başlayan base64 data URI kabul edilir; xAI Files API file_id değeri kabul edilmez. Tek görsel image, birden fazla referans görsel ise 1-5 elemanlı images dizisiyle gönderilir.

Grok görsel düzenlemede image alanı hangi formatta gönderilir?

Grok görsel düzenlemede image alanı, ayrı bir görsel kimliği değil; görselin kendisini veya bağlantısını taşır. xAI için 3 kabul biçimi vardır: genel URL, base64 data URI ve xAI Files API'den file_id; LLMTR'da file_id kabul edilmez, görsel bu alanın içinde URL metni ya da base64 içerik olarak iletilir.

LLMTR tarafında aynı alan için bir HTTPS URL dizesi doğrudan, url içeren bir nesne olarak veya data:image/... biçiminde verilebilir. xAI Files API'den alınan file_id, LLMTR uç noktasında kullanılamaz. Tek bir referans için image alanı, birden fazla referans görsel ise 1-5 elemanlı images dizisiyle gönderilir.

• xAI docs, Image editing · 2026-10-06

LLMTR üzerinde istek: POST /v1/images/edits

LLMTR'de düzenleme çağrısı POST /v1/images/edits adresine yapılır. Bu uç nokta yalnızca xai/grok-imagine-image ve xai/grok-imagine-image-quality modelleriyle kullanılabilir; başka bir model bu işlem için seçilemez. Görsel girdi, tek görsel ise image alanında, 1-5 referans görsel ise images alanında verilir. Her iki seçenek de aynı düzenleme uç noktasında kullanılır.

prompt alanı zorunludur ve neyin değiştirileceğini belirtir. response_format değeri url veya b64_json olabilir; url kısa süreli olduğu için b64_json seçilip sonuç bytes olarak saklanabilir, LLMTR bu süreyi uzatmaz. resolution alanı isteğe bağlıdır ve 1k veya 2k değerlerinden birini alır. Görsel, URL dizesi, url nesnesi ya da base64 data URI olarak iletilebilir.

Çalışan örnek: yerel dosyadan base64 data URI

Aşağıdaki örnek, product.png dosyasını ikili olarak okuyup data:image/png;base64, önekiyle yerel dosyanın base64 data URI değerine dönüştürür. Bu değer, image alanında type değeri image_url olan bir nesnenin url üyesine yerleştirilir. İstek, OpenAI uyumlu düzenleme biçiminde POST /v1/images/edits adresine gönderilir. Bu yapı, yerel dosyayı ayrı bir image id olarak göndermeden doğrudan veri olarak taşır.

Yanıt response_format b64_json ile alınır. response.json() içindeki data[0].b64_json alanı base64 olarak çözülür ve edited.png veya edited.jpg dosyasına yazılır; böylece kısa süreli url alanına bağlı kalmadan sonuç saklanır. Kod, Authorization başlığında LLMTR_API_KEY ortam değişkenini kullanır ve HTTP hatasında raise_for_status() çağırır.

Yerel product.png dosyasını base64 data URI olarak gönderen ve b64_json yanıtını diske kaydeden Python isteği.

import base64
import os
import requests

with open("product.png", "rb") as f:
    data_uri = "data:image/png;base64," + base64.b64encode(f.read()).decode()

response = requests.post(
    "https://llmtr.com/v1/images/edits",
    headers={"Authorization": f"Bearer {os.environ['LLMTR_API_KEY']}"},
    json={
        "model": "xai/grok-imagine-image",
        "prompt": "Keep the product, replace the background with a clean white studio",
        "image": {"type": "image_url", "url": data_uri},
        "response_format": "b64_json",
    },
    timeout=180,
)
response.raise_for_status()
image_bytes = base64.b64decode(response.json()["data"][0]["b64_json"])
extension = "png" if image_bytes[:4] == b"\x89PNG" else "jpg"
with open(f"edited.{extension}", "wb") as out:
    out.write(image_bytes)

Hatalar ve görsel düzenleme maliyeti

/v1/images/edits uç noktasına Google veya OpenAI modeliyle çağrı yapıldığında 400 unsupported_operation yanıtı döner. Google referans görseli üretimi ise /v1/images/generations uç noktasında çalışır. Bu ayrım, Grok düzenleme isteğiyle Google referans görseli üretme isteğinin aynı uç noktada kullanılmadığını gösterir.

xai/grok-imagine-image modelinin fiyatı görsel başına 0,02 $, xai/grok-imagine-image-quality modelinin fiyatı görsel başına 0,05 $ olarak uygulanır. Düzenleme isteğinde gönderilen görseller ve üretilen görseller birlikte sayılır. xAI gerçek maliyeti bildirdiğinde faturalama bu maliyeti izler; bildirmediğinde görsel başına fiyat uygulanır.

• xAI docs, Pricing · 2026-10-06

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

İlk adım llmtr.com'da hesap oluşturmak ve e-posta adresini doğrulamaktır. Ardından Dashboard üzerinden güvenli ödeme ekranından kredi yüklenir; istenen yükleme tutarının üzerine 8% platform marjı bir kez eklenir. Örneğin 10,00 $ kredi için 10,80 $ tahsil edilir. Platform marjı model fiyatlarına eklenmez; her API çağrısı model kataloğundaki fiyattan düşülür.

Üçüncü adımda Dashboard > API Keys bölümünden API anahtarı oluşturulur. Ham anahtar yalnızca bir kez gösterilir; LLMTR_API_KEY gibi bir ortam değişkeninde saklanmalıdır. İlk istek, OpenAI uyumlu herhangi bir SDK ile https://llmtr.com/v1 adresine gönderilir; yalnızca base_url ve api_key değiştirilir. Dashboard kullanım sayfasında anahtar bazında kullanım ve harcama görülür. Aynı anahtar ve kredi bakiyesi katalogdaki her model için çalışır; model değiştirmek model dizesini değiştirmek demektir.

Grok görsel düzenleme için LLMTR kurulumu

Hesap, kredi ve API anahtarı oluşturduktan sonra Grok görsel düzenleme isteğini gönderin.

1. Hesap oluştur. llmtr.com'da hesap oluştur ve e-posta adresini doğrula.
2. Kredi yükle. Dashboard'daki güvenli ödeme ekranından kredi yükle; istenen tutarın üzerine 8% platform marjı bir kez eklenir.
3. API anahtarı oluştur. Dashboard > API Keys bölümünden anahtar oluştur; ham anahtarı LLMTR_API_KEY ortam değişkeninde sakla.
4. İlk isteği gönder. OpenAI uyumlu bir SDK ile POST https://llmtr.com/v1/images/edits isteğini gönder; base_url değerini https://llmtr.com/v1 yap ve API anahtarını kullan.

Sık sorulan sorular

Grok görsel düzenlemede image alanı hangi formatta gönderilir?

xAI için 3 biçim listelenir: genel bir görsel URL'si, base64 data URI veya xAI Files API'den file_id. LLMTR'da HTTPS URL dizesi, url içeren nesne veya data:image/... data URI kabul edilir; file_id kabul edilmez.

LLMTR'de Grok düzenleme isteği kaç referans görsel alabilir?

LLMTR'de images dizisi 1-5 referans görsel alabilir. Tek görsel için image alanını, birden fazla görsel için images alanını kullanırsınız.

Grok görsel düzenleme maliyeti nedir?

xai/grok-imagine-image için fiyat 0,02 $, xai/grok-imagine-image-quality için 0,05 $ görsel başınadır. Gönderilen ve üretilen görsellerin ikisi de sayılır; xAI gerçek maliyeti bildirirse faturalama bu maliyeti izler, bildirmezse görsel başına fiyat uygulanır.

İlgili yazılar

• xAI API görsel üretimi: aspect_ratio ve b64_json
• Grok Imagine Image: standart tier çoğu ürün işi için neden yeterli

• Görsel üretimi dokümantasyonu
• Model kataloğu
• Fiyatlandırma