Tokenizasyon Görseli Üret

Yeni bir token formu için bir yapay zekâ sağlayıcısıyla varlığın görselini çizer. Görsel, gönderdiğiniz değerlerden (name ve verildiyse category_name, description ile serbest metin instruction) sabit bir istemle çizilir; depodan hiçbir şey okunmaz, bu yüzden token'ın henüz var olması gerekmez. Hiçbir şey kaydedilmez de: görsel base64 olarak kodlanmış döner ve Token Oluştur ya da Token Güncelle içinde token'ın images dosyalarından biri olarak yüklenmeye hazırdır.

provider gönderilmezse tokenizasyon görsellerine hizmet eden ilk sağlayıcı çizer; bunları Tokenizasyon Sağlayıcılarını Getir ve feature=tokenization_image ile listeleyin.

Gerekli izin: token:ai-assist

İstek

POST /v2/admin/tokens/tokenization-images

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
name	string	Evet	Varlığın adı.
description	string	Hayır	Varlığın açıklaması; isteme eklenir.
category_name	string	Hayır	Kategori adı; isteme adın yanına eklenir.
token_symbol	string	Hayır	Yalnızca dosya adı için kullanılır (<symbol>-ai-<unix time>.jpg; boşsa asset).
instruction	string	Hayır	İstemin sonuna eklenen serbest metin yönlendirme, en fazla 1000 karakter.
provider	string	Hayır	Çizimi yapacak yapay zekâ sağlayıcısı. Yapılandırılmış ve tokenizasyon görselleri için etkin olmalıdır; yalnızca görsel çizebilen bir sağlayıcı (bugün openai) bu özellik için etkinleştirilebilir.

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/tokens/tokenization-images' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "provider": "openai",
    "name": "Istanbul Commercial Office",
    "description": "12 month lease contract on a commercial real estate in Istanbul",
    "token_symbol": "IST",
    "category_name": "Real Estate",
    "instruction": "dusk light, exterior view"
  }'

Yanıt

{
  "file_name": "ist-ai-1762682400.jpg",
  "content_type": "image/jpeg",
  "data_base64": "/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "provider": "openai"
}

Yanıt Alanları

Alan	Tip	Açıklama
file_name	string	Önerilen dosya adı.
content_type	string	Görselin medya tipi.
data_base64	string	Base64 olarak kodlanmış görsel.
provider	string	Görseli çizen sağlayıcı.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (name eksik, instruction 1000 karakteri aşıyor) — details alanına bakın
400	79001	provider desteklenen bir sağlayıcı değil (yapay zekâ sağlayıcı ayarı domain'i 79)
400	79005	Belirtilen sağlayıcı devre dışı, yapılandırılmamış ya da tokenizasyon görselleri için etkin değil (domain 79)
400	79006	Tokenizasyon görselleri için etkin bir sağlayıcı yok (domain 79)
400	77004	Sağlayıcıda görsel modeli yapılandırılmamış (yapay zekâ istemcisi domain'i 77)
400	77005	Sağlayıcı görsel üretmiyor (yapay zekâ istemcisi domain'i 77)

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.