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/apikeysArdı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-xxxAPI 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:
| İşlem | Kredi maliyeti |
|---|---|
| Görüntü oluşturma | Gö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
| Parametre | Tür | Zorunlu | Açıklama |
|---|---|---|---|
model | string | Hayır | gpt-image-2 kullanın. gpt-image-2-text-to-image ve gpt-image-2-image-to-image dahili takma adları da desteklenmektedir. |
prompt | string | Evet | Görüntünün metin açıklaması. image_urls sağlanmadıkça zorunludur. |
image_urls | string[] | Hayır | Görüntüden görüntüye oluşturma için referans görüntü URL'leri. |
n | integer | Hayır | Oluşturulacak görüntü sayısı, 1'den 10'a kadar. Varsayılan: 1. |
size | string | Hayır | 1024x1024, 1536x1024, 1024x1536, 1920x1088, 1088x1920, 3824x2160, 2160x3824 veya auto seçeneklerinden biri. |
quality | string | Hayır | Sağlayıcı kalite seçeneği, örneğin high veya auto. |
output_format | string | Hayır | Sağlayıcı tarafından desteklendiğinde png, jpeg veya webp. |
response_format | string | Hayır | Yalnızca url desteklenmektedir. |
user | string | Hayır | Kendi 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:
| Durum | Anlam |
|---|---|
pending | Görev kuyruğa alındı. |
processing | Sağlayıcı görüntüyü oluşturuyor. |
succeeded | Görüntü URL'leri data içinde mevcut. |
failed | Oluşturma başarısız oldu. |
canceled | Oluş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
- Fiyatlandırma ve Krediler — Çağrı başına kredi maliyeti ve kredi paketleri
- Prompt Kılavuzu — API çağrılarınızdan daha iyi sonuçlar alın
- Kullanım Durumları — Gerçek API entegrasyon desenleri
- Showcase Galerisi — GPT Image 2 ile neler mümkün
- OpenAI Image API Resmi Dokümantasyonu — Kendi OpenAI anahtarına sahip kullanıcılar için resmi üst kaynak