Geliştirici başvuru kaynağı

GPT Image 2.6 API belgeleri

Bir API anahtarı oluşturun, görsel oluşturma isteği gönderin ve görselinizi almak için görevi sorgulayın.

API anahtarınızı oluşturun

Giriş yapın ve hesabınızda bir anahtar oluşturun. Aşağıdaki örnekleri çalıştırmadan önce sunucu ortamınızda GPT_IMAGE_API_KEY değerini bu anahtara ayarlayın.

API anahtarlarını yönet

Anahtarınızı sunucunuzda saklayın. İki uç nokta da Authorization: Bearer üzerinden kullanıcı API anahtarınızı kullanır ve tarayıcı çerezi gerektirmez.

Görsel oluşturma istekleri hesabınızdaki kredileri kullanır. Aynı ayarlarda Flare ve Sunburst aynı miktarda kredi gerektirir. Güncel görsel maliyetlerini görün

Görsel oluşturma isteği gönderin

POST /api/generate

Aşağıdaki JSON’u request.json olarak kaydedin. Bu örnek metinden görsel oluşturur. Referans görsellerle düzenleme yapmak için aşağıda açıklanan images dizisini ekleyin.

İstek gövdesi: `request.json`

{
  "model": "gpt-image-2.6",
  "variant": "flare",
  "prompt": "Sıcak tonlu kâğıt fon önünde, ahşap masa üzerinde mavi seramik bir fincan.",
  "quality": "medium",
  "resolution": "1k",
  "complexity": "high",
  "output_format": "png"
}

Sunucunuzdan gönderin

curl --request POST https://gptimage-26.com/api/generate \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

Başarılı bir gönderim code 200, data.task_id, IN_PROGRESS değerindeki data.status ve data.consumed_credits döndürür. Durum sorgusu için data.task_id değerini saklayın.

İstek alanları

Alan	Anlamı ve kabul edilen değerler
`model`	gpt-image-2.6 kullanın. Alan gönderilmezse varsayılan değer de budur.
`variant`	İsteğe bağlı: flare, sunburst. Varsayılan: flare. Sunburst için sunburst değerini kullanın.
`prompt`	Başındaki ve sonundaki boşluklar çıkarıldıktan sonra 1 ile 20000 karakter arasında olması gereken zorunlu metin.
`quality`	İsteğe bağlı: low, medium, high, xhigh, max. Varsayılan: medium.
`resolution`	İsteğe bağlı: 1k, 2k, 4k. Varsayılan: 1k.
`complexity`	Kompozisyon planlaması, isteğe bağlı: low, medium, high. Varsayılan: high.
`output_format`	İsteğe bağlı: png, jpeg, webp. Varsayılan: png.
`images`	En fazla 16 HTTP(S) görsel URL’si içeren isteğe bağlı dizi. En az bir referans görsel düzenlemeyi etkinleştirir; metinden görsel oluşturmak için bu alanı göndermeyin.

Görevi sorgulayın

GET /api/status

TASK_ID değerini dönen data.task_id olarak ayarlayın. Aynı kullanıcı API anahtarıyla task_id sorgu parametresi olarak gönderin.

curl --get https://gptimage-26.com/api/status \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --data-urlencode "task_id=$TASK_ID"

PENDING / IN_PROGRESS: Görev devam ediyor. İlerlemeyi kontrol etmek için bu uç noktayı yeniden sorgulayın.
SUCCESS: Oluşturulan görsel URL’lerini data.response dizisinden alın.
FAILED: Yeni bir istek gönderip göndermemeye karar vermeden önce data.error_message içindeki hata ayrıntılarını okuyun.

Tamamlanmış görev örneği

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "<TASK_ID>",
    "status": "SUCCESS",
    "response": [
      "<IMAGE_URL>"
    ],
    "error_message": null
  }
}

Açılı ayraç içindeki değerler, isteğinizden dönen görev kimliğini ve görsel URL’sini temsil eden yer tutuculardır.