GPT Image

Tianshu'nun GPT görsel modelleri (gpt-image serisi), metinden görsele ve görsel düzenleme içindir; 生图专用 grubu altında yer alır.

Hazırlık

1. Konsol'da 生图专用 grubunda bir token oluşturun.
2. Model Pazarı'nda 生图专用 grubunda kullanılabilir bir görsel modeli adını onaylayın (aşağıdaki örneklerde gpt-image-2 kullanılmıştır).

Doğrudan yönlendirmeyi kullanın

Görsel üretimi uzun süreli bir istektir; bu nedenle ağ geçidi zaman aşımlarını önlemek için uç nokta olarak https://api.tian-shu.org doğrudan yönlendirmesini kullanın.

Seçenek 1: API çağrısı (önerilen)

Görsel üretmek için, metinden görsele ve görsel düzenleme olmak üzere iki uç noktası olan Images API'yi kullanın.

Metinden görsele /v1/images/generations

curl 'https://api.tian-shu.org/v1/images/generations' \
  -H 'Authorization: Bearer your-image-group-token' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2",
    "prompt": "an orange cat wearing an orange scarf hugging an otter, warm illustration style",
    "size": "1024x1024",
    "quality": "high",
    "output_format": "png",
    "response_format": "url",
    "n": 1
  }'

Görsel düzenleme / görselden görsele /v1/images/edits

multipart/form-data kullanarak bir görsel yükleyin ve değişikliği prompt içinde açıkça tanımlayın:

curl 'https://api.tian-shu.org/v1/images/edits' \
  -H 'Authorization: Bearer your-image-group-token' \
  -F 'model=gpt-image-2' \
  -F 'prompt=Keep the subject, add a red stamp in the top-right corner reading DEMO' \
  -F 'image=@/path/to/your-image.jpg' \
  -F 'size=1024x1024' \
  -F 'quality=high' \
  -F 'output_format=png' \
  -F 'response_format=url'

Yaygın parametreler

Parametre	Notlar
model	Daima görsel modeli adı, örneğin gpt-image-2.
prompt	Görsel açıklaması; özneyi, sahneyi, stili, en boy oranını ve varsa metni açıkça belirtin.
n	Yalnızca 1 desteklenir — çağrı başına bir görsel.
size	auto ve 1024x1024, 1536x1024, 1024x1536 gibi yaygın boyutları destekler.
quality	low / medium / high / auto; taslaklar için low, nihai çıktı için high kullanın.
response_format	url veya b64_json; varsayılan olarak url önerilir.
output_format	png veya jpeg önerilir; webp önerilmez.
stream	Desteklenmez — etkinleştirmeyin.

Seçenek 2: Cherry Studio'da görsel üretme

1. 生图专用 grubunda bir token oluşturun ve kopyalayın.
2. Cherry Studio → Ayarlar → Model Hizmetleri → bir OpenAI türü sağlayıcı ekleyin:
   • API adresi: https://api.tian-shu.org
   • API anahtarı: görsel grubu token'ınız
3. "Yönet" altında bir görsel modeli (örneğin gpt-image-2) ekleyin.
4. "Akışlı çıktı"yı mutlaka kapatın (görsel uç noktası akış yapmaz), aksi takdirde üretim başarısız olabilir.
5. Görsel modelini seçin ve üretmeye başlayabilirsiniz.

Çağrı yöntemi hakkında not

gpt-image üretimi için Images API'yi (/v1/images/generations, /v1/images/edits) kullanın. Chat Completions / Responses uç noktaları görsel üretiminin giriş noktası değildir.