Mulai Cepat

Panduan ini akan membantu Anda memulai dengan Qwen Image Edit dengan cepat.

Pengaturan Awal

Pertama, Anda perlu menginstal SDK dan mengkonfigurasi Kunci API Anda.

Instalasi

Pilih bahasa pilihan Anda dan ikuti petunjuk instalasi:

JavaScript/TypeScript

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

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

const qwen = new QwenImageEdit({
  apiKey: 'YOUR_API_KEY',
  region: 'YOUR_REGION', // misalnya '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' # misalnya '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' // misalnya 'us-east-1'
]);

Java

Tambahkan dependency ke pom.xml atau build.gradle Anda:

<!-- 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") // misalnya "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") // misalnya "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' # misalnya 'us-east-1'
)

Pengeditan Pertama Anda

Mari kita coba mengedit gambar sederhana.

// Contoh: Mengedit teks pada gambar
async function editTextOnImage() {
  try {
    const result = await qwen.edit({
      image: 'url_to_your_image.jpg',
      prompt: 'Ubah teks menjadi "Halo Dunia"',
    });
    console.log('Gambar yang diedit:', result.editedImageUrl);
  } catch (error) {
    console.error('Kesalahan saat mengedit gambar:', error);
  }
}

editTextOnImage();

Fitur Utama

Pengeditan Teks: Mengubah, menambah, menghapus teks pada gambar.
Manipulasi Elemen: Menambahkan logo, menghapus watermark, mengubah objek.
Transfer Gaya: Mengubah gaya gambar menjadi artistik atau fotografi.

Praktik Terbaik

Prompt Efektif: Gunakan prompt yang jelas dan spesifik untuk hasil terbaik.
Optimasi: Optimalkan ukuran gambar dan format file untuk kinerja yang lebih baik.

Penanganan Kesalahan

Periksa HTTP status codes dan pesan kesalahan untuk memecahkan masalah.

// Contoh penanganan kesalahan
try {
  // ... panggilan API ...
} catch (error) {
  if (error.response) {
    console.error('Kesalahan API:', error.response.status, error.response.data);
  } else {
    console.error('Kesalahan:', error.message);
  }
}

Contoh Kasus Penggunaan Nyata

Lokalisasi Pemasaran: Menerjemahkan teks pada spanduk iklan untuk pasar internasional.
E-commerce: Memperbarui harga atau promosi pada gambar produk.
Pembuatan Konten: Membuat gambar untuk media sosial dengan cepat.

Analisis Gambar

Manfaatkan kemampuan analisis gambar untuk mendapatkan wawasan.

async function analyzeImage() {
  try {
    const result = await qwen.analyze({
      image: 'url_to_your_image.jpg',
      features: ['labels', 'text_detection'],
    });
    console.log('Hasil analisis:', result);
  } catch (error) {
    console.error('Kesalahan saat menganalisis gambar:', error);
  }
}

analyzeImage();

Pemrosesan Batch

Proses beberapa gambar sekaligus untuk menghemat waktu.

async function batchProcessImages() {
  try {
    const results = await qwen.batchEdit([
      { image: 'image1.jpg', prompt: 'Edit 1' },
      { image: 'image2.jpg', prompt: 'Edit 2' },
    ]);
    console.log('Hasil pemrosesan batch:', results);
  } catch (error) {
    console.error('Kesalahan saat memproses batch:', error);
  }
}

batchProcessImages();

Langkah Selanjutnya

Lihat lebih banyak contoh: Tautan ke halaman contoh
Referensi API: Tautan ke halaman API
Konfigurasi: Tautan ke halaman konfigurasi
Pemecahan Masalah: Tautan ke halaman pemecahan masalah

Mulai Cepat

On this page