Быстрый старт

Это руководство поможет вам быстро начать работу с Qwen Image Edit.

1. Начальная настройка

Получение ключа API

Прежде чем использовать Qwen Image Edit, вам потребуется ключ API. Вы можете получить его, зарегистрировавшись на нашем портале разработчиков.

Установка

Qwen Image Edit предоставляет SDK для различных языков программирования. Выберите свой язык и следуйте инструкциям по установке:

JavaScript/TypeScript

npm install qwen-image-edit
# или
yarn add qwen-image-edit

import { QwenImageEdit } from 'qwen-image-edit';

const qwen = new QwenImageEdit({
  apiKey: 'ВАШ_API_КЛЮЧ',
  region: 'us-east-1', // Или ваш предпочтительный регион
});

Python

pip install qwen-image-edit

from qwen_image_edit import QwenImageEdit

qwen = QwenImageEdit(
    api_key='ВАШ_API_КЛЮЧ',
    region='us-east-1'  # Или ваш предпочтительный регион
)

PHP

composer require qwen/image-edit

use Qwen\ImageEdit\QwenImageEdit;

$qwen = new QwenImageEdit([
    'apiKey' => 'ВАШ_API_КЛЮЧ',
    'region' => 'us-east-1', // Или ваш предпочтительный регион
]);

Java

Добавьте следующую зависимость в ваш pom.xml (Maven) или build.gradle (Gradle):

<!-- Maven -->
<dependency>
    <groupId>com.qwen</groupId>
    <artifactId>image-edit</artifactId>
    <version>1.0.0</version>
</dependency>

// Gradle
implementation 'com.qwen:image-edit:1.0.0'

import com.qwen.imageedit.QwenImageEdit;

QwenImageEdit qwen = new QwenImageEdit.Builder()
    .apiKey("ВАШ_API_КЛЮЧ")
    .region("us-east-1") // Или ваш предпочтительный регион
    .build();

Go

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

package main

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

func main() {
	qwen := qwen.NewClient("ВАШ_API_КЛЮЧ", "us-east-1") // Или ваш предпочтительный регион
}

Ruby

gem install qwen-image-edit

require 'qwen-image-edit'

qwen = QwenImageEdit::Client.new(
  api_key: 'ВАШ_API_КЛЮЧ',
  region: 'us-east-1' # Или ваш предпочтительный регион
)

2. Базовая конфигурация

Ключ API и регион

Всегда указывайте свой ключ API и предпочтительный регион при инициализации клиента Qwen Image Edit. Это гарантирует, что ваши запросы будут правильно аутентифицированы и маршрутизированы.

const qwen = new QwenImageEdit({
  apiKey: process.env.QWEN_API_KEY,
  region: process.env.QWEN_REGION || 'us-east-1',
});

3. Первые шаги редактирования

Простое редактирование текста

Измените текст на изображении, указав исходный текст и новый текст:

const result = await qwen.editText({
  imageUrl: 'https://example.com/image.jpg',
  originalText: 'Hello World',
  newText: 'Привет, мир!',
});

Редактирование элементов

Добавьте логотип на изображение:

const result = await qwen.editElement({
  imageUrl: 'https://example.com/image.jpg',
  element: {
    type: 'image',
    url: 'https://example.com/logo.png',
    position: { x: 10, y: 10 },
    size: { width: 100, height: 50 },
  },
});

4. Ключевые особенности

• Редактирование текста: Изменение, перевод или исправление текста на изображениях.
• Манипуляции с элементами: Добавление, удаление или изменение объектов, таких как логотипы, водяные знаки или ценники.
• Перенос стиля: Применение различных художественных стилей к вашим изображениям.

5. Рекомендации

Эффективные подсказки

Для достижения наилучших результатов используйте четкие и краткие подсказки. Чем точнее ваша подсказка, тем лучше будет результат.

Оптимизация производительности

• Размер изображения: Используйте изображения оптимального размера для ваших нужд. Слишком большие изображения могут замедлить обработку.
• Пакетная обработка: Для нескольких изображений используйте пакетную обработку, чтобы сократить общее время.

Обработка ошибок

Всегда реализуйте надежную обработку ошибок, чтобы корректно обрабатывать сбои API, такие как неверные ключи API, превышение лимитов или проблемы с сетью.

6. Практические примеры

Локализация маркетинга

Автоматически переводите и заменяйте текст на рекламных изображениях для разных регионов.

Электронная коммерция

Быстро обновляйте изображения товаров с новыми ценами или рекламными акциями.

Создание контента

Создавайте несколько вариантов изображений для социальных сетей с разными стилями или элементами.

7. Анализ изображений

Используйте возможности анализа изображений для получения информации о содержимом изображения, такой как обнаружение объектов, текста и лиц. Это может помочь в автоматизации принятия решений.

8. Пакетная обработка

Для обработки большого количества изображений используйте пакетную обработку. Это позволяет эффективно управлять ресурсами и сокращать общее время обработки.

9. Следующие шаги

• Расширенные примеры
• Справочник API
• Конфигурация
• Устранение неполадок