Gempix 2 API

GemPix2 API Dokümantasyonu

Google Gemini AI modelleri kullanan GemPix2 Görüntü Oluşturma Servisi için kapsamlı API dokümantasyonu

Fiyat AlGemPix2 fiyat planlarını görüntüle

GemPix2 API Genel Bakış

GemPix2 Görüntü Oluşturma API, metin prompt'ları ve referans görüntülerden yüksek kaliteli görüntüler oluşturmak için Google Gemini AI modellerine erişim sağlar. GemPix2 servisimiz, kapsamlı görev yönetimi ve callback desteği ile basit RESTful arayüz sunar.

GemPix2 Ana Özellikler

  • • Google Gemini AI modelleri kullanarak GemPix2 metin-görüntü oluşturma
  • • GemPix2 referans görüntü desteği (4 görüntüye kadar)
  • • GemPix2 durum takibi ile asenkron görev işleme
  • • GemPix2 gerçek zamanlı bildirimler için webhook callback desteği
  • • GemPix2 JSON yanıtlı RESTful API
  • • GemPix2 Bearer token kimlik doğrulama

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

GemPix2 Başlangıç

  1. 1. Üretim sunucumuzdan GemPix2 API anahtarı için kaydolun
  2. 2. GemPix2 API anahtarınızı Authorization başlığına ekleyin
  3. 3. GemPix2 görüntü oluşturma endpoint'ine POST isteği gönderin
  4. 4. Oluşturma durumunu kontrol etmek için döndürülen GemPix2 task_id'yi kullanın
  5. 5. Görev tamamlandığında GemPix2 oluşturulan görüntülerinizi alın

Kimlik Doğrulama

Tüm API istekleri Bearer token kimlik doğrulaması kullanılarak doğrulanmalıdır. Her istekte Authorization başlığına API anahtarınızı ekleyin.

Kimlik Doğrulama Yöntemi

Authorization başlığına API anahtarınızı ekleyerek HTTP Bearer token kimlik doğrulaması kullanın:

Authorization: Bearer <your-api-key>

Örnek API Anahtar Formatı

Authorization: Bearer dk-1234567890abcdef

İstek Örneği

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

Geçerli Kimlik Doğrulama

  • ✅ API anahtarı geçerli
  • ✅ Kullanıcı hesabı aktif
  • ✅ Yeterli kredi mevcut

Yaygın Hatalar

  • ❌ Eksik API anahtarı
  • ❌ Geçersiz API anahtar formatı
  • ❌ Süresi dolmuş veya inaktif hesap

GemPix2 Görsel Oluşturma API

Google Gemini AI modelleri ve özelleştirilebilir prompt'lar ve referans görseller kullanarak GemPix2 ile görsel oluşturun.

Endpoint

POST /api/image/gen

İstek Parametreleri

ParameterTypeRequiredDescription
modelstringYesModel identifier (e.g., "google/gempix2")
promptstringYesText prompt describing the image
imagesarrayNoReference image URLs (max 4)
callback_urlstringNoWebhook URL for completion notifications

İstek Örnekleri

Temel GemPix2 Görsel Oluşturma

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

Referans Görseller ile GemPix2 Görsel Tabanlı Oluşturma

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

Yanıt Formatı

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

Hata Yanıtları

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

GemPix2 Görev Sorgulama API'si

GemPix2 görüntü oluşturma endpoint'inden dönen görev ID'sini kullanarak GemPix2 görüntü oluşturma görevlerinin durumunu ve sonuçlarını sorgulayın.

Endpoint

GET /api/task/query?task_id=<task_id>

Sorgu Parametreleri

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

İstek Örneği

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

GemPix2 Görev Durum Değerleri

pending - GemPix2 görevi oluşturuldu ve işlenmeyi bekliyor
submitted - GemPix2 görevi oluşturma kuyruğuna gönderildi
in_progress - GemPix2 görevi şu anda işleniyor
success - GemPix2 görevi oluşturulan görüntülerle başarıyla tamamlandı
failed - GemPix2 görevi bir hata nedeniyle başarısız oldu

Hata Yanıtları

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

GemPix2 Veri Modelleri

API yanıtları ve isteklerinde kullanılan tüm GemPix2 veri modelleri ve şemaları için eksiksiz referans.

ImageGenResult

Represents a generated image result.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}
FieldTypeDescription
imagestringImage URL or base64 data URI

CallbackPayload

Payload sent to the callback_url when task status changes to final states.

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}
FieldTypeDescription
resultarrayArray of ImageGenResult objects (null if failed)
statusstringFinal task status (success/failed)
task_idstringUnique task identifier
consumedstringCredits consumed by the task
status_reasonobjectStatus details including error message if failed

GemPix2 Mevcut Modeller

google/gempix2Nano Banana image generation model
google/gemini-2.5-flash-imageGemini 2.5 Flash image model

Hata Yönetimi

Hataları ele alma ve API yanıt kodlarını anlama konusunda kapsamlı rehber. Tüm hata yanıtları, sorunları etkili bir şekilde gidermenize yardımcı olmak için tutarlı bir format izler.

HTTP Durum Kodları

200

OK

Request was successful

400

Bad Request

Invalid request parameters or malformed JSON

401

Unauthorized

Invalid, missing, or expired API key

404

Not Found

Task not found or endpoint doesn't exist

500

Internal Server Error

Server-side error occurred

Hata Yönetimi En İyi Uygulamaları

  1. 1. Yanıt gövdesini işlemeden önce her zaman HTTP durum kodlarını kontrol edin:
  2. 2. 500 hatalarında yeniden deneme mantığı için üstel geri çekilme uygulayın:
  3. 3. Hata ayıklama için hata yanıtlarını detay bilgilerle kaydedin:
  4. 4. 400 hatalarından kaçınmak için istekleri göndermeden önce girdileri doğrulayın:
  5. 5. Kullanıcıları API anahtarlarını güncellemeye yönlendirerek kimlik doğrulama hatalarını ele alın:
  6. 6. Çok sık yoklama yapmak yerine görev durumunu periyodik olarak izleyin:
  7. 7. Görev tamamlanması için yoklama yapmaktan kaçınmak için mümkün olduğunda webhook'ları kullanın:

Örnek Hata Yönetimi (JavaScript)

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}