Bắt đầu nhanh với Qwen Image Edit

Hướng dẫn này sẽ giúp bạn nhanh chóng thiết lập và bắt đầu sử dụng Qwen Image Edit API để chỉnh sửa hình ảnh bằng các lệnh văn bản đơn giản.

1. Thiết lập ban đầu

Trước khi bắt đầu, bạn cần có khóa API Qwen Image Edit. Nếu bạn chưa có, vui lòng đăng ký trên trang web của chúng tôi để nhận khóa API.

1.1. Cài đặt

Qwen Image Edit cung cấp các SDK cho nhiều ngôn ngữ lập trình phổ biến. Chọn ngôn ngữ của bạn và làm theo hướng dẫn cài đặt.

JavaScript/TypeScript

npm install qwen-image-edit
# hoặc
yarn add qwen-image-edit

Python

pip install qwen-image-edit-sdk

PHP

composer require qwen-image-edit/qwen-image-edit-sdk

Java

Thêm dependency sau vào tệp pom.xml của bạn (Maven):

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

Go

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

Ruby

gem install qwen_image_edit

1.2. Cấu hình cơ bản

Khởi tạo client với khóa API và khu vực của bạn. Bạn nên sử dụng các biến môi trường để giữ an toàn cho khóa API của mình.

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

const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY,
  region: 'your_region_here', // ví dụ: '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="your_region_here" # ví dụ: "us-east-1"
)

2. Các bước chỉnh sửa đầu tiên

Bây giờ bạn đã thiết lập client, hãy thử chỉnh sửa hình ảnh đầu tiên của mình.

2.1. Chỉnh sửa văn bản đơn giản

Thay đổi văn bản trên hình ảnh bằng một lệnh đơn giản.

// JavaScript/TypeScript
async function editTextInImage() {
  try {
    const result = await client.edit({
      image: 'https://example.com/image-with-text.jpg',
      prompt: 'Thay đổi "Chào mừng" thành "Xin chào thế giới"',
    });
    console.log('Hình ảnh đã chỉnh sửa có sẵn tại:', result.edited_image_url);
  } catch (error) {
    console.error('Lỗi khi chỉnh sửa văn bản:', error);
  }
}

editTextInImage();

2.2. Thêm một yếu tố

Thêm một logo hoặc hình mờ vào hình ảnh.

# Python
def addLogoToImage():
    try:
        result = client.edit(
            image='https://example.com/product-image.jpg',
            prompt='Thêm logo công ty vào góc dưới bên phải',
            elements=[
                {
                    "type": "image",
                    "src": "https://example.com/my-logo.png",
                    "position": "bottom-right"
                }
            ]
        )
        print(f"Hình ảnh đã chỉnh sửa có sẵn tại: {result.edited_image_url}")
    except Exception as e:
        print(f"Lỗi khi thêm logo: {e}")

addLogoToImage()

3. Các tính năng chính

Qwen Image Edit cung cấp một loạt các khả năng mạnh mẽ:

Chỉnh sửa văn bản: Sửa đổi, dịch hoặc sửa lỗi chính tả trong văn bản trên hình ảnh.
Thao tác với yếu tố: Thêm, xóa hoặc thay đổi kích thước các yếu tố như logo, hình mờ, nhãn giá.
Chuyển đổi kiểu: Áp dụng các kiểu nghệ thuật hoặc nhiếp ảnh cho hình ảnh.
Phân tích hình ảnh: Trích xuất văn bản, nhận dạng đối tượng và phân tích cảnh.
Xử lý hàng loạt: Chỉnh sửa nhiều hình ảnh cùng một lúc để tăng hiệu quả.

4. Các phương pháp hay nhất

Lời nhắc hiệu quả: Sử dụng các lời nhắc rõ ràng, cụ thể và ngắn gọn để có kết quả tốt nhất.
Tối ưu hóa hiệu suất: Tối ưu hóa kích thước hình ảnh và sử dụng xử lý hàng loạt khi thích hợp.
Xử lý lỗi: Triển khai xử lý lỗi mạnh mẽ để quản lý các lỗi API và sự cố mạng.

5. Ví dụ thực tế

Qwen Image Edit có thể được sử dụng trong nhiều trường hợp khác nhau:

Bản địa hóa tiếp thị: Dịch văn bản quảng cáo trên hình ảnh cho các thị trường khác nhau.
Thương mại điện tử: Cập nhật nhãn giá sản phẩm, thêm huy hiệu khuyến mãi hoặc thay đổi nền sản phẩm.
Tạo nội dung: Nhanh chóng tạo các biến thể hình ảnh cho mạng xã hội hoặc các chiến dịch quảng cáo.

6. Các bước tiếp theo

Để tìm hiểu thêm về Qwen Image Edit, hãy khám phá các tài nguyên sau:

Ví dụ: Xem các ví dụ chi tiết về các trường hợp sử dụng khác nhau.
Tham chiếu API: Tìm hiểu về tất cả các điểm cuối và tham số API có sẵn.
Cấu hình: Khám phá các tùy chọn cấu hình nâng cao.
Khắc phục sự cố: Tìm giải pháp cho các vấn đề thường gặp.

Bắt đầu nhanh

On this page