Geliştirici Kaynakları

GPT Image 1.5 API Dokümantasyonu

OpenAI'nın GPT Image 1.5 modelini uygulamalarınıza entegre edin. Basit REST API ile metinden görsele ve görselden görsele üretim desteği.

Kimlik Doğrulama

GPT Image 1.5 API, Bearer Token kimlik doğrulamasını kullanır. API anahtarınızı istek başlığında (header) iletin.

Kimlik Doğrulama

Authorization: Bearer sk-your-api-key-here

API anahtarınızı güvende tutun. İstemci tarafındaki kodlarda paylaşmayın.

Fiyatlandırma

Tür	Maliyet	Açıklama
Metinden Görsele	10 Kredi	Metin istemlerinden (prompt) görseller oluşturun.
Görselden Görsele	10 Kredi	Mevcut görselleri metin istemleriyle düzenleyin.

Görev Oluştur

POSThttps://gptimage15.ai/api/generate

Asenkron Üretim

Fiyatlandırma

Her üretim isteği, metinden görsele veya görselden görsele fark etmeksizin 10 Credits tutarındadır.

Bir üretim görevi başlatın. API, sonuçları sorgulamak için kullanacağınız bir task_id değerini anında döndürür.

Gövde Parametreleri

Parametre	Tür	Zorunlu	Açıklama
prompt	string	Zorunlu	Görsel üretimi için metin açıklaması. Maksimum 2000 karakter.
size	string	İsteğe Bağlı	Görsel boyutu: 10241024, 10241536 veya 15361024. Varsayılan: 10241024
quality	string	İsteğe Bağlı	Görsel kalitesi: low, medium veya high. Varsayılan: medium
images	array	İsteğe Bağlı	Görselden Görsele modu için. Düzenlenecek görsel URL'lerinden oluşan dizi.
input_fidelity	string	İsteğe Bağlı	Giriş görseline sadakat: low veya high. Varsayılan: high. Sadece görselden görsele için.
callback_url	string	İsteğe Bağlı	Görev tamamlanma bildirimi için Webhook URL'si.

İstek Örnekleri

Text-to-Image (cURL)

curl -X POST https://gptimage15.ai/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape...",
    "size": "1536*1024",
    "quality": "high"
  }'

Image-to-Image (Edit Mode)

{
  "prompt": "Add a rainbow in the sky",
  "images": [
    "https://example.com/landscape.jpg"
  ],
  "input_fidelity": "high",
  "quality": "medium"
}

Başarılı Yanıt

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "IN_PROGRESS"
  }
}

Hata Yanıtı

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

Durum Kontrolü

GEThttps://gptimage15.ai/api/status

Görevinizin ilerlemesini kontrol etmek için bu uç noktayı sorgulayın. Her 5-10 saniyede bir sorgulamanızı öneririz.

Sorgu Parametreleri

Parametre	Tür	Açıklama
task_id	string	Üretim uç noktasından alınan görev kimliği (task ID). Zorunlu

Durum Değerleri

PENDINGGörev sırada

IN_PROGRESSİşleniyor

SUCCESSTamamlandı

FAILEDHata oluştu

cURL

curl -X GET "https://gptimage15.ai/api/status?task_id=n36abc123def456gptimg" \
  -H "Authorization: Bearer YOUR_API_KEY"

Yanıt (Devam Ediyor)

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

Yanıt (Tamamlandı)

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

Yanıt (Başarısız)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Hata Kodları

Kod	Açıklama
200	Başarılı
400	Geçersiz İstek - Geçersiz parametreler (eksik istem, geçersiz boyut/kalite vb.)
401	Yetkisiz - Eksik veya geçersiz API anahtarı
404	Bulunamadı - Görev kimliği mevcut değil
500	Sunucu Hatası - Lütfen tekrar deneyin veya destekle iletişime geçin

Yardıma mı ihtiyacınız var?

Destek kanalımıza göz atın veya bize e-posta gönderin.

Destekle İletişime Geçin