API Referansı

GPT Image 2 açık API'sini kullanarak görüntüleri programlı olarak oluşturun ve düzenleyin. Kendi API anahtarınızla kimlik doğrulaması yapın, kredi ile ödeme yapın ve sonuçları polling yöntemiyle alın.

Genel Bakış

GPT Image 2 API, GPT Image 2 hesabınız aracılığıyla görüntü oluşturmanıza olanak tanır. İstekler, sitenizin API anahtarını kullanır ve sunucu tarafındaki Kie entegrasyonumuz üzerinden yönlendirilir.

Şu adresten API anahtarı oluşturun:

/settings/apikeys

Ardından şunu çağırın:

POST /api/v1/images/generations
GET /api/v1/images/tasks/{task_id}

Görüntü oluşturma asenkrondur. Oluşturma uç noktası bir görev id'si döndürür; görev uç noktası ise oluşturma başarılı olduğunda nihai görüntü URL'lerini döndürür.

Kimlik Doğrulama

GPT Image 2 API anahtarınızı Bearer token olarak gönderin:

Authorization: Bearer sk-xxx

API anahtarlarını tarayıcı tarafındaki kodda açığa çıkarmayın. Bunları arka ucunuzdan, betiklerinizden veya sunucusuz fonksiyonlarınızdan kullanın.

Faturalandırma

API kullanımı, web uygulamasıyla aynı kredileri tüketir:

İşlemKredi maliyeti
Görüntü oluşturmaGörüntü başına 10 kredi

Bir görev kabul edilmeden önce sağlayıcı isteği başarısız olursa, tüketilen krediler görev başarısızlık akışı tarafından otomatik olarak iade edilir.

Görüntü Oluşturma Talebi Oluştur

Uç Nokta

POST https://gpt-image-2.art/api/v1/images/generations

İstek Gövdesi

ParametreTürZorunluAçıklama
modelstringHayırgpt-image-2 kullanın. gpt-image-2-text-to-image ve gpt-image-2-image-to-image dahili takma adları da desteklenmektedir.
promptstringEvetGörüntünün metin açıklaması. image_urls sağlanmadıkça zorunludur.
image_urlsstring[]HayırGörüntüden görüntüye oluşturma için referans görüntü URL'leri.
nintegerHayırOluşturulacak görüntü sayısı, 1'den 10'a kadar. Varsayılan: 1.
sizestringHayır1024x1024, 1536x1024, 1024x1536, 1920x1088, 1088x1920, 3824x2160, 2160x3824 veya auto seçeneklerinden biri.
qualitystringHayırSağlayıcı kalite seçeneği, örneğin high veya auto.
output_formatstringHayırSağlayıcı tarafından desteklendiğinde png, jpeg veya webp.
response_formatstringHayırYalnızca url desteklenmektedir.
userstringHayırKendi izlemeniz için isteğe bağlı son kullanıcı tanımlayıcısı.

Metinden Görüntüye Örnek

curl https://gpt-image-2.art/api/v1/images/generations \
  -H "Authorization: Bearer $GPT_IMAGE_2_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic product photo of a matte black coffee bag on a marble counter",
    "size": "1536x1024",
    "quality": "high",
    "n": 1
  }'

Görüntüden Görüntüye Örnek

curl https://gpt-image-2.art/api/v1/images/generations \
  -H "Authorization: Bearer $GPT_IMAGE_2_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Keep the product unchanged and place it on a clean studio background",
    "image_urls": ["https://example.com/product.png"],
    "size": "1024x1024",
    "n": 1
  }'

Oluşturma Yanıtı

{
  "id": "8f6d9f87-1b3f-4f89-bdfb-3df8e77b7af3",
  "object": "image.generation",
  "created": 1714000000,
  "model": "gpt-image-2-text-to-image",
  "status": "pending",
  "credits": 10,
  "data": []
}

id'yi kaydedin ve görev uç noktasını polling ile sorgulayın.

Görüntü Görevini Sorgula

Uç Nokta

GET https://gpt-image-2.art/api/v1/images/tasks/{task_id}

Örnek

curl https://gpt-image-2.art/api/v1/images/tasks/8f6d9f87-1b3f-4f89-bdfb-3df8e77b7af3 \
  -H "Authorization: Bearer $GPT_IMAGE_2_API_KEY"

Başarılı Yanıt

{
  "id": "8f6d9f87-1b3f-4f89-bdfb-3df8e77b7af3",
  "object": "image.generation",
  "created": 1714000000,
  "model": "gpt-image-2-text-to-image",
  "status": "succeeded",
  "credits": 10,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

Olası status değerleri:

DurumAnlam
pendingGörev kuyruğa alındı.
processingSağlayıcı görüntüyü oluşturuyor.
succeededGörüntü URL'leri data içinde mevcut.
failedOluşturma başarısız oldu.
canceledOluşturma iptal edildi.

JavaScript Örneği

const apiKey = process.env.GPT_IMAGE_2_API_KEY;

const createRes = await fetch(
  'https://gpt-image-2.art/api/v1/images/generations',
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'gpt-image-2',
      prompt:
        'A premium skincare bottle on wet stone with soft studio lighting',
      size: '1024x1024',
      n: 1,
    }),
  }
);

const task = await createRes.json();

let result = task;
while (['pending', 'processing'].includes(result.status)) {
  await new Promise((resolve) => setTimeout(resolve, 3000));
  const queryRes = await fetch(
    `https://gpt-image-2.art/api/v1/images/tasks/${task.id}`,
    {
      headers: {
        Authorization: `Bearer ${apiKey}`,
      },
    }
  );
  result = await queryRes.json();
}

console.log(result.data);

Hata Biçimi

Hatalar OpenAI stilinde bir yapıya sahiptir:

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

İlgili Kaynaklar