เริ่มต้นใช้งาน

เริ่มต้นใช้งาน Qwen Image Edit ในไม่กี่นาที

เริ่มต้นใช้งาน

คู่มือนี้จะช่วยให้คุณเริ่มต้นใช้งาน Qwen Image Edit ได้อย่างรวดเร็ว

การตั้งค่าเริ่มต้น

ก่อนอื่น คุณต้องติดตั้ง SDK และกำหนดค่า API Key ของคุณ

การติดตั้ง

เลือกภาษาที่คุณต้องการและทำตามคำแนะนำการติดตั้ง:

JavaScript/TypeScript

npm install @qwen-image-edit/sdk
# หรือ
yarn add @qwen-image-edit/sdk
import { QwenImageEdit } from '@qwen-image-edit/sdk';

const qwen = new QwenImageEdit({
  apiKey: 'YOUR_API_KEY',
  region: 'YOUR_REGION', // เช่น 'us-east-1'
});

Python

pip install qwen-image-edit-sdk
from qwen_image_edit_sdk import QwenImageEdit

qwen = QwenImageEdit(
    api_key='YOUR_API_KEY',
    region='YOUR_REGION' # เช่น 'us-east-1'
)

PHP

composer require qwen-image-edit/sdk
require 'vendor/autoload.php';
use QwenImageEdit\QwenImageEdit;

$qwen = new QwenImageEdit([
    'apiKey' => 'YOUR_API_KEY',
    'region' => 'YOUR_REGION' // เช่น 'us-east-1'
]);

Java

เพิ่ม dependency ลงใน pom.xml หรือ build.gradle ของคุณ:

<!-- Maven -->
<dependency>
    <groupId>com.qwen-image-edit</groupId>
    <artifactId>sdk</artifactId>
    <version>1.0.0</version>
</dependency>
// Gradle
implementation 'com.qwen-image-edit:sdk:1.0.0'
import com.qwen_image_edit.QwenImageEdit;

QwenImageEdit qwen = new QwenImageEdit.Builder()
    .apiKey("YOUR_API_KEY")
    .region("YOUR_REGION") // เช่น "us-east-1"
    .build();

Go

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

import (
	"fmt"
	"github.com/qwen-image-edit/sdk/qwen"
)

func main() {
	qwen := qwen.NewClient("YOUR_API_KEY", "YOUR_REGION") // เช่น "us-east-1"
	fmt.Println(qwen)
}

Ruby

gem install qwen-image-edit-sdk
require 'qwen-image-edit-sdk'

qwen = QwenImageEdit::Client.new(
  api_key: 'YOUR_API_KEY',
  region: 'YOUR_REGION' # เช่น 'us-east-1'
)

การแก้ไขครั้งแรก

มาลองแก้ไขรูปภาพง่ายๆ กัน

// ตัวอย่าง: แก้ไขข้อความบนรูปภาพ
async function editTextOnImage() {
  try {
    const result = await qwen.edit({
      image: 'url_to_your_image.jpg',
      prompt: 'เปลี่ยนข้อความเป็น "สวัสดีชาวโลก"',
    });
    console.log('รูปภาพที่แก้ไขแล้ว:', result.editedImageUrl);
  } catch (error) {
    console.error('เกิดข้อผิดพลาดในการแก้ไขรูปภาพ:', error);
  }
}

editTextOnImage();

คุณสมบัติหลัก

  • การแก้ไขข้อความ: เปลี่ยน, เพิ่ม, ลบข้อความบนรูปภาพ
  • การจัดการองค์ประกอบ: เพิ่มโลโก้, ลบลายน้ำ, เปลี่ยนวัตถุ
  • การถ่ายโอนสไตล์: เปลี่ยนสไตล์ของรูปภาพให้เป็นแบบศิลปะหรือภาพถ่าย

แนวทางปฏิบัติที่ดีที่สุด

  • Prompt ที่มีประสิทธิภาพ: ใช้ prompt ที่ชัดเจนและเฉพาะเจาะจงเพื่อให้ได้ผลลัพธ์ที่ดีที่สุด
  • การเพิ่มประสิทธิภาพ: ปรับขนาดรูปภาพให้เหมาะสมและใช้รูปแบบไฟล์ที่เหมาะสมเพื่อประสิทธิภาพที่ดีขึ้น

การจัดการข้อผิดพลาด

ตรวจสอบ HTTP status codes และข้อความแสดงข้อผิดพลาดเพื่อแก้ไขปัญหา

// ตัวอย่างการจัดการข้อผิดพลาด
try {
  // ... การเรียก API ...
} catch (error) {
  if (error.response) {
    console.error('ข้อผิดพลาดจาก API:', error.response.status, error.response.data);
  } else {
    console.error('ข้อผิดพลาด:', error.message);
  }
}

ตัวอย่างการใช้งานจริง

  • การแปลเนื้อหาทางการตลาด: แปลข้อความบนแบนเนอร์โฆษณาสำหรับตลาดต่างประเทศ
  • E-commerce: อัปเดตราคาหรือโปรโมชั่นบนรูปภาพสินค้า
  • การสร้างเนื้อหา: สร้างรูปภาพสำหรับโซเชียลมีเดียอย่างรวดเร็ว

การวิเคราะห์รูปภาพ

ใช้ความสามารถในการวิเคราะห์รูปภาพเพื่อดึงข้อมูลเชิงลึก

async function analyzeImage() {
  try {
    const result = await qwen.analyze({
      image: 'url_to_your_image.jpg',
      features: ['labels', 'text_detection'],
    });
    console.log('ผลการวิเคราะห์:', result);
  } catch (error) {
    console.error('เกิดข้อผิดพลาดในการวิเคราะห์รูปภาพ:', error);
  }
}

analyzeImage();

การประมวลผลแบบแบตช์

ประมวลผลรูปภาพหลายรูปพร้อมกันเพื่อประหยัดเวลา

async function batchProcessImages() {
  try {
    const results = await qwen.batchEdit([
      { image: 'image1.jpg', prompt: 'แก้ไข 1' },
      { image: 'image2.jpg', prompt: 'แก้ไข 2' },
    ]);
    console.log('ผลลัพธ์การประมวลผลแบบแบตช์:', results);
  } catch (error) {
    console.error('เกิดข้อผิดพลาดในการประมวลผลแบบแบตช์:', error);
  }
}

batchProcessImages();

ขั้นตอนต่อไป