GPT Image

Model gambar GPT Tianshu (seri gpt-image) digunakan untuk text-to-image dan pengeditan gambar, di bawah grup 生图专用.

Persiapan

1. Buat token pada grup 生图专用 di Konsol.
2. Konfirmasi nama model gambar yang tersedia pada grup 生图专用 di Model Marketplace (contoh di bawah menggunakan gpt-image-2).

Gunakan rute langsung

Pembuatan gambar adalah permintaan berjalan lama, jadi gunakan rute langsung https://api.tian-shu.org untuk endpoint guna menghindari timeout gateway.

Opsi 1: Pemanggilan API (direkomendasikan)

Untuk menghasilkan gambar, gunakan Images API, yang memiliki dua endpoint: text-to-image dan pengeditan gambar.

Text-to-image /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
  }'

Pengeditan gambar / image-to-image /v1/images/edits

Unggah gambar menggunakan multipart/form-data dan jelaskan perubahannya dengan jelas pada prompt:

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'

Parameter umum

Parameter	Catatan
model	Selalu nama model gambar, mis. gpt-image-2.
prompt	Deskripsi gambar; jelaskan secara rinci subjek, adegan, gaya, rasio aspek, dan teks apa pun.
n	Hanya 1 yang didukung — satu gambar per pemanggilan.
size	Mendukung auto dan ukuran umum seperti 1024x1024, 1536x1024, 1024x1536.
quality	low / medium / high / auto; gunakan low untuk draf dan high untuk hasil akhir.
response_format	url atau b64_json; url direkomendasikan secara default.
output_format	png atau jpeg direkomendasikan; webp tidak direkomendasikan.
stream	Tidak didukung — jangan diaktifkan.

Opsi 2: Hasilkan gambar di Cherry Studio

1. Buat dan salin token pada grup 生图专用.
2. Cherry Studio → Settings → Model Services → tambahkan penyedia bertipe OpenAI:
   • Alamat API: https://api.tian-shu.org
   • Kunci API: token grup gambar Anda
3. Di bawah "Manage", tambahkan model gambar (seperti gpt-image-2).
4. Pastikan mematikan "streaming output" (endpoint gambar tidak melakukan streaming), jika tidak pembuatan dapat gagal.
5. Pilih model gambar dan Anda dapat mulai menghasilkan.

Catatan tentang metode pemanggilan

Untuk pembuatan gambar gpt-image, gunakan Images API (/v1/images/generations, /v1/images/edits). Endpoint Chat Completions / Responses bukan pintu masuk untuk pembuatan gambar.