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.

1

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ürMaliyetAçıklama
Metinden Görsele10 KrediMetin istemlerinden (prompt) görseller oluşturun.
Görselden Görsele10 KrediMevcut görselleri metin istemleriyle düzenleyin.
2

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

ParametreTürZorunluAçıklama
promptstringZorunluGörsel üretimi için metin açıklaması. Maksimum 2000 karakter.
sizestringİsteğe BağlıGörsel boyutu: 1024*1024, 1024*1536 veya 1536*1024. Varsayılan: 1024*1024
qualitystringİsteğe BağlıGörsel kalitesi: low, medium veya high. Varsayılan: medium
imagesarrayİsteğe BağlıGörselden Görsele modu için. Düzenlenecek görsel URL'lerinden oluşan dizi.
input_fidelitystringİsteğe BağlıGiriş görseline sadakat: low veya high. Varsayılan: high. Sadece görselden görsele için.
callback_urlstringİ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
}
3

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

ParametreTürAçıklama
task_idstringÜ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ı

KodAçıklama
200Başarılı
400Geçersiz İstek - Geçersiz parametreler (eksik istem, geçersiz boyut/kalite vb.)
401Yetkisiz - Eksik veya geçersiz API anahtarı
404Bulunamadı - Görev kimliği mevcut değil
500Sunucu 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