Qwen Image Edit API Referansı

Bu belge, Qwen Image Edit API'sinin tüm özelliklerini ve yöntemlerini detaylı olarak açıklar.

1. API Arayüzü

Tüm API çağrıları aşağıdaki temel uç noktaya yapılır:

https://api.qwen-image-edit.com/v1

2. Kimlik Doğrulama

API'ye erişmek için bir API anahtarı gereklidir. Anahtarınızı Authorization başlığında aşağıdaki gibi iletin:

Authorization: Bearer YOUR_API_KEY

3. Çekirdek Yöntemler

3.1. `/edit` - Görsel Düzenleme

Görselleri düzenlemek için birincil yöntem.

HTTP Yöntemi: POST

İstek Gövdesi:

{
  "image": "https://example.com/image.jpg",
  "prompt": "Görseldeki metni değiştir",
  "elements": [
    {
      "type": "text",
      "content": "Yeni Metin",
      "position": "top-left"
    }
  ],
  "style_transfer": {
    "preset": "van_gogh"
  }
}

Parametreler:

Parametre	Tip	Açıklama
image	string	Düzenlenecek görselin URL'si (gerekli)
prompt	string	Düzenleme talimatı (gerekli)
elements	array	Eklenmek istenen öğeler (isteğe bağlı)
style_transfer	object	Stil aktarım ayarları (isteğe bağlı)

Başarılı Yanıt:

{
  "edited_image_url": "https://api.qwen-image-edit.com/edited/abc123.jpg",
  "job_id": "job_abc123",
  "status": "completed"
}

3.2. `/analyze` - Görsel Analizi

Görseller hakkında bilgi almak için kullanılır.

HTTP Yöntemi: POST

İstek Gövdesi:

{
  "image": "https://example.com/image.jpg",
  "features": ["text", "objects"]
}

Parametreler:

Parametre	Tip	Açıklama
image	string	Analiz edilecek görselin URL'si (gerekli)
features	array	Hangi özelliklerin analiz edileceği (gerekli)

Başarılı Yanıt:

{
  "text": [
    {
      "content": "Örnek Metin",
      "position": [100, 100, 200, 150]
    }
  ],
  "objects": [
    {
      "label": "person",
      "position": [50, 50, 150, 200]
    }
  ]
}

4. Yardımcı Yöntemler

4.1. `/jobs/{job_id}` - İş Durumu

Uzun süren işlemlerin durumunu kontrol etmek için.

HTTP Yöntemi: GET

Başarılı Yanıt:

{
  "status": "processing",
  "progress": 50,
  "estimated_completion": "2023-06-15T14:30:00Z"
}

5. Gelişmiş Yapılandırma

5.1. Toplu İşleme

Birden fazla görseli tek bir istekle işlemek için:

{
  "batch": [
    {
      "image": "https://example.com/image1.jpg",
      "prompt": "İlk görseli düzenle"
    },
    {
      "image": "https://example.com/image2.jpg",
      "prompt": "İkinci görseli düzenle"
    }
  ]
}

5.2. Hata Yönetimi

API hataları standart HTTP durum kodlarıyla döner:

Kod	Açıklama
400	Geçersiz istek
401	Yetkisiz erişim
429	Çok fazla istek
500	Sunucu hatası

6. Sınırlar ve Kota

Özellik	Sınır
Dakika başına istek	60
Günlük istek	5000
Görsel boyutu	10MB

7. Web Kancaları

Uzun süren işlemler tamamlandığında bildirim almak için web kancalarını kullanabilirsiniz.

7.1. `job.completed`

{
  "event": "job.completed",
  "data": {
    "job_id": "job_abc123",
    "edited_image_url": "https://api.qwen-image-edit.com/edited/abc123.jpg"
  }
}

7.2. `job.failed`

{
  "event": "job.failed",
  "data": {
    "job_id": "job_abc123",
    "error": "Görsel işlenirken hata oluştu"
  }
}

8. SDK'lar

Resmi olarak desteklenen SDK'lar:

JavaScript/TypeScript
Python
PHP
Java
Go
Ruby

Örnek SDK kullanımı:

// JavaScript/TypeScript
import QwenImageEdit from 'qwen-image-edit';

const client = new QwenImageEdit({
  apiKey: 'YOUR_API_KEY',
  region: 'YOUR_REGION'
});

async function editImage() {
  try {
    const result = await client.edit({
      image: 'https://example.com/image.jpg',
      prompt: 'Görseli düzenle'
    });
    console.log('Düzenlenmiş görsel:', result.edited_image_url);
  } catch (error) {
    console.error('Hata:', error);
  }
}

editImage();

API Referansı

On this page