Qwen Image Edit Hızlı Başlangıç

Bu kılavuz, Qwen Image Edit'i kullanmaya hızlıca başlamanıza yardımcı olacaktır. Ortamınızı nasıl kuracağınızı, API'yi nasıl yapılandıracağınızı ve ilk görsel düzenlemenizi nasıl yapacağınızı öğreneceksiniz.

1. İlk Kurulum

Başlamadan önce şunlara sahip olduğunuzdan emin olun:

• Qwen Image Edit API Anahtarı: Qwen Image Edit kontrol panelinizden edinebilirsiniz.
• Geliştirme Ortamı: Sisteminizde yüklü Node.js (JavaScript/TypeScript için), Python, PHP, Java, Go veya Ruby.

2. Kurulum

Tercih ettiğiniz programlama dilini seçin ve kurulum talimatlarını izleyin:

JavaScript/TypeScript (NPM/Yarn)

npm install @qwen-image-edit/sdk
# veya
yarn add @qwen-image-edit/sdk

Python (pip)

pip install qwen-image-edit-sdk

PHP (Composer)

composer require qwen-image-edit/sdk

Java (Maven/Gradle)

Maven:

<dependency>
    <groupId>com.qwen.imageedit</groupId>
    <artifactId>sdk</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle:

implementation 'com.qwen.imageedit:sdk:1.0.0'

Go

go get github.com/qwen-image-edit/sdk

Ruby (Gem)

gem install qwen-image-edit-sdk

3. Temel Yapılandırma

Qwen Image Edit istemcinizi API anahtarınız ve bölgenizle yapılandırın.

// JavaScript/TypeScript
import { QwenImageEdit } from '@qwen-image-edit/sdk';

const client = new QwenImageEdit({
  apiKey: 'YOUR_API_KEY',
  region: 'YOUR_REGION', // Örnek: 'us-east-1'
});

# 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")
)

4. İlk Düzenlemeniz

Basit bir görsel düzenlemesi yapalım: bir görseldeki metni değiştirelim.

Örnek 1: Basit Metin Düzenleme

// JavaScript/TypeScript
async function editTextOnImage() {
  try {
    const result = await client.edit({
      image: 'https://example.com/image-with-text.jpg', // Görselinizin URL'si
      prompt: '"Sale" metnini "Büyük İndirim" olarak değiştir',
    });
    console.log('Düzenlenmiş görsel şurada mevcut:', result.edited_image_url);
  } catch (error) {
    console.error('Görsel düzenlenirken hata oluştu:', error);
  }
}

editTextOnImage();

Örnek 2: Basit Öğe Düzenleme

# 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")
)

def add_element_to_image():
    try:
        result = client.edit(
            image='https://example.com/product-image.jpg', # Görselinizin URL'si
            prompt='Sağ alt köşeye küçük bir logo ekle',
            elements=[{'type': 'image', 'src': 'https://example.com/your-logo.png', 'position': 'bottom-right'}]
        )
        print(f"Düzenlenmiş görsel şurada mevcut: {result.edited_image_url}")
    except Exception as e:
        print(f"Öğe eklenirken hata oluştu: {e}")

add_element_to_image()

5. Temel Özellikler

Qwen Image Edit bir dizi güçlü özellik sunar:

• Metin Düzenleme: Görsellerdeki metni değiştirin, çevirin veya düzeltin.
• Öğe Manipülasyonu: Logolar, filigranlar veya fiyat etiketleri gibi nesneleri ekleyin, kaldırın veya yeniden boyutlandırın.
• Stil Aktarımı: Görsellerinize farklı sanatsal veya fotoğrafik stiller uygulayın.
• Görsel Analizi: Görsel içeriği hakkında bilgi edinin (çok yakında).
• Toplu İşleme: Verimlilik için birden fazla görseli aynı anda düzenleyin.

6. En İyi Uygulamalar

• Etkili İstemler: Daha iyi sonuçlar için açık ve spesifik istemler kullanın.
• Performans Optimizasyonu: Büyük görseller için, API'ye göndermeden önce dosya boyutunu optimize etmeyi düşünün.
• Hata Yönetimi: API çağrıları için sağlam hata yönetimi ve yeniden deneme mekanizmaları uygulayın.

7. Pratik Örnekler

Qwen Image Edit çeşitli kullanım durumları için kullanılabilir:

• Pazarlama Yerelleştirmesi: Pazarlama materyallerini farklı pazarlar için çevirin ve uyarlayın.
• E-ticaret: Ürün görsellerini promosyonlar veya yeni bilgilerle hızla güncelleyin.
• İçerik Oluşturma: Sosyal medya veya reklam kampanyaları için görsellerin farklı varyasyonlarını oluşturun.

8. Sonraki Adımlar

• Kullanım Örnekleri bölümünde daha fazla örneği keşfedin.
• Uç nokta ve parametre detayları için API Referansı bölümüne bakın.
• Gelişmiş Yapılandırma hakkında bilgi edinin.
• Yaygın sorunlar için Sorun Giderme bölümüne bakın.