Qwen Image Edit Yapılandırması

Bu belge, Qwen Image Edit SDK'sını ve API istemcisini yapılandırmak için mevcut olan çeşitli seçenekleri detaylandırmaktadır. Hem başlangıç hem de gelişmiş yapılandırma senaryolarını kapsar.

1. Başlangıç Yapılandırması

Qwen Image Edit istemcisini kullanmaya başlamak için temel API anahtarınızı ve bölgenizi yapılandırmanız gerekir.

API anahtarınızı ve bölgenizi doğrudan kodda sabit kodlamak yerine ortam değişkenleri aracılığıyla sağlamanız şiddetle tavsiye edilir. Bu, kimlik bilgilerinizin güvenliğini artırır ve farklı ortamlar arasında kolayca geçiş yapmanızı sağlar.

export QWEN_IMAGE_EDIT_API_KEY="your_api_key_here"
export QWEN_IMAGE_EDIT_REGION="your_region_here" # örn. us-east-1, eu-west-1

1.2. İstemci Kurulumu

Çoğu SDK, API anahtarını ve bölgeyi doğrudan oluşturucuya veya bir yapılandırma yöntemine iletmenize olanak tanır.

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

const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  region: process.env.QWEN_IMAGE_EDIT_REGION,
});

// Kullanım örneği
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();

# Python
import os
from qwen_image_edit_sdk import QwenImageEdit

client = QwenImageEdit(
    api_key=os.environ.get("QWEN_IMAGE_EDIT_API_KEY"),
    region=os.environ.get("QWEN_IMAGE_EDIT_REGION")
)

# Kullanım örneği
def edit_image():
    try:
        result = client.edit(
            image='https://example.com/image.jpg',
            prompt='Görseli düzenle'
        )
        print(f"Düzenlenmiş görsel: {result.edited_image_url}")
    except Exception as e:
        print(f"Hata: {e}")

edit_image()

2. Gelişmiş Yapılandırma

SDK'nın davranışını daha fazla özelleştirmek için ek yapılandırma seçenekleri mevcuttur.

2.1. İstek Zaman Aşımı

API çağrılarının tamamlanması için beklenecek maksimum süreyi ayarlayın.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  region: process.env.QWEN_IMAGE_EDIT_REGION,
  timeout: 30000, // 30 saniye
});

2.2. Yeniden Deneme Mekanizmaları

Geçici ağ sorunları veya API hız sınırlamaları durumunda başarısız istekleri otomatik olarak yeniden denemek için yapılandırın.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  region: process.env.QWEN_IMAGE_EDIT_REGION,
  maxRetries: 5, // Maksimum 5 yeniden deneme
  retryDelay: 1000, // İlk yeniden deneme için 1 saniye gecikme (üstel geri çekilme ile artar)
});

2.3. Önbellekleme

Tekrarlanan API çağrıları için performansı artırmak amacıyla önbellekleme stratejilerini etkinleştirin.

// JavaScript/TypeScript (Örnek bir önbellekleme yapılandırması)
const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  region: process.env.QWEN_IMAGE_EDIT_REGION,
  cache: {
    enabled: true,
    ttl: 3600, // 1 saat önbellek ömrü
    store: 'memory', // veya 'redis', 'filesystem' gibi başka bir depolama
  },
});

2.4. Proxy Ayarları

İstekleri bir proxy sunucusu üzerinden yönlendirmeniz gerekiyorsa:

// JavaScript/TypeScript
const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  region: process.env.QWEN_IMAGE_EDIT_REGION,
  proxy: 'http://your.proxy.com:8080',
});

2.5. Ortama Özel Yapılandırmalar

Geliştirme, hazırlık ve üretim gibi farklı ortamlar için farklı yapılandırmalar tanımlayın.

// JavaScript/TypeScript
const config = {
  development: {
    apiKey: process.env.DEV_QWEN_API_KEY,
    region: 'us-east-1',
    logging: true,
  },
  production: {
    apiKey: process.env.PROD_QWEN_API_KEY,
    region: 'eu-west-1',
    maxRetries: 10,
  },
};

const environment = process.env.NODE_ENV || 'development';
const client = new QwenImageEdit(config[environment]);

2.6. Günlük Kaydı (Logging)

SDK'nın günlük kaydı davranışını yapılandırın. Bu, hata ayıklama ve izleme için faydalıdır.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  region: process.env.QWEN_IMAGE_EDIT_REGION,
  logging: {
    level: 'debug', // 'info', 'warn', 'error' olabilir
    // customLogger: myCustomLoggerFunction // Kendi günlükçünüzü sağlayın
  },
});

3. Güvenlik En İyi Uygulamaları

API Anahtarlarını Güvende Tutun: API anahtarlarınızı asla istemci tarafı koduna veya sürüm kontrolüne dahil etmeyin. Ortam değişkenleri veya güvenli bir sır yönetimi hizmeti kullanın.
HTTPS Kullanın: Tüm API iletişimleri için HTTPS'nin kullanıldığından emin olun.

4. Performans İpuçları

Görsel Boyutunu Optimize Edin: API'ye göndermeden önce görselleri uygun boyuta ve formata sıkıştırın. Bu, yükleme sürelerini ve işlem maliyetlerini azaltır.
Toplu İşleme Kullanın: Mümkün olduğunda, birden fazla düzenleme isteğini tek bir toplu işlemde birleştirin.

5. İzleme ve Geliştirme Araçları

API Kullanımını İzleyin: API kullanımınızı izlemek ve kota sınırlarınıza ulaşmadığınızdan emin olmak için Qwen Image Edit kontrol panelini kullanın.
Hata Ayıklama: SDK'nın günlük kaydı özelliklerini kullanarak veya API yanıtlarını inceleyerek hataları ayıklayın.

6. Genel En İyi Uygulamalar

Hata Yönetimi: Uygulamanızda sağlam hata yönetimi uygulayın. API çağrıları başarısız olduğunda kullanıcıya anlamlı geri bildirim sağlayın.
Asenkron İşleme: Uzun süren görsel düzenleme işlemleri için asenkron API çağrıları kullanın ve yanıtları işlemek için web kancalarını veya iş durumu sorgulamasını kullanın.

Yapılandırma