البدء السريع
ابدأ مع 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. الخطوات التالية
- استكشف المزيد من الأمثلة في أمثلة الاستخدام.
- راجع مرجع API للحصول على تفاصيل نقطة النهاية والمعلمات.
- تعرف على التكوين المتقدم.
- راجع استكشاف الأخطاء وإصلاحها للمشكلات الشائعة.