البدء السريع

ابدأ مع Qwen Image Edit في دقائق

البدء السريع في Qwen Image Edit

سيساعدك هذا الدليل على البدء بسرعة في استخدام Qwen Image Edit. ستتعلم كيفية إعداد بيئتك، وتكوين واجهة برمجة التطبيقات (API)، وإجراء أول تعديل لصورك.

1. الإعداد الأولي

قبل البدء، تأكد من أن لديك:

  • مفتاح API لـ Qwen Image Edit: يمكنك الحصول عليه من لوحة تحكم Qwen Image Edit الخاصة بك.
  • بيئة تطوير: Node.js (لـ JavaScript/TypeScript)، أو Python، أو PHP، أو Java، أو Go، أو Ruby مثبتة على نظامك.

2. التثبيت

اختر لغة البرمجة المفضلة لديك واتبع تعليمات التثبيت:

JavaScript/TypeScript (NPM/Yarn)

npm install @qwen-image-edit/sdk
# أو
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. التكوين الأساسي

قم بتكوين عميل Qwen Image Edit الخاص بك باستخدام مفتاح API والمنطقة الخاصة بك.

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

const client = new QwenImageEdit({
  apiKey: 'YOUR_API_KEY',
  region: 'YOUR_REGION', // مثال: '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. أول تعديل لك

دعنا نجري تعديلاً بسيطًا على الصورة: تغيير نص على الصورة.

مثال 1: تعديل نص بسيط

// JavaScript/TypeScript
async function editTextOnImage() {
  try {
    const result = await client.edit({
      image: 'https://example.com/image-with-text.jpg', // عنوان URL لصورتك
      prompt: 'تغيير النص "Sale" إلى "خصم كبير"',
    });
    console.log('الصورة المعدلة متاحة على:', result.edited_image_url);
  } catch (error) {
    console.error('خطأ أثناء تعديل الصورة:', error);
  }
}

editTextOnImage();

مثال 2: تعديل عنصر بسيط

# 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', # عنوان URL لصورتك
            prompt='أضف شعارًا صغيرًا في الزاوية اليمنى السفلية',
            elements=[{'type': 'image', 'src': 'https://example.com/your-logo.png', 'position': 'bottom-right'}]
        )
        print(f"الصورة المعدلة متاحة على: {result.edited_image_url}")
    except Exception as e:
        print(f"خطأ أثناء إضافة العنصر: {e}")

add_element_to_image()

5. الميزات الرئيسية

يقدم Qwen Image Edit مجموعة من الميزات القوية:

  • تحرير النص: تغيير أو ترجمة أو تصحيح النص داخل الصور.
  • معالجة العناصر: إضافة أو إزالة أو تغيير حجم الكائنات مثل الشعارات أو العلامات المائية أو علامات الأسعار.
  • نقل النمط: تطبيق أنماط فنية أو فوتوغرافية مختلفة على صورك.
  • تحليل الصور: الحصول على رؤى حول محتوى الصورة (قريبًا).
  • معالجة الدفعات: تحرير صور متعددة في وقت واحد لتحقيق الكفاءة.

6. أفضل الممارسات

  • مطالبات فعالة: استخدم مطالبات واضحة ومحددة للحصول على نتائج أفضل.
  • تحسين الأداء: بالنسبة للصور الكبيرة، فكر في تحسين حجم الملف قبل إرساله إلى واجهة برمجة التطبيقات.
  • معالجة الأخطاء: تنفيذ معالجة قوية للأخطاء وآليات إعادة المحاولة لاستدعاءات واجهة برمجة التطبيقات.

7. أمثلة عملية

يمكن استخدام Qwen Image Edit لمجموعة متنوعة من حالات الاستخدام:

  • توطين التسويق: ترجمة وتكييف المواد التسويقية للأسواق المختلفة.
  • التجارة الإلكترونية: تحديث صور المنتجات بسرعة بعروض ترويجية أو معلومات جديدة.
  • إنشاء المحتوى: إنشاء أشكال مختلفة من الصور لوسائل التواصل الاجتماعي أو الحملات الإعلانية.

8. الخطوات التالية