Szybki start

Witamy w Qwen Image Edit! Ten przewodnik pomoże Ci szybko rozpocząć korzystanie z naszej potężnej platformy do edycji obrazów opartej na sztucznej inteligencji. Niezależnie od tego, czy chcesz edytować tekst, manipulować elementami, czy przenosić style, Qwen Image Edit upraszcza złożone zadania związane z obrazami.

1. Konfiguracja początkowa

Uzyskaj klucz API

Zanim zaczniesz, potrzebujesz klucza API. Możesz go uzyskać, rejestrując się na platformie Qwen Image Edit. Twój klucz API służy do uwierzytelniania żądań do naszego API.

Instalacja

Qwen Image Edit jest dostępny za pośrednictwem interfejsu API REST, a także zestawów SDK dla popularnych języków programowania. Wybierz metodę, która najlepiej odpowiada Twoim potrzebom.

JavaScript/TypeScript (Node.js)

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

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

const client = new QwenImageEdit({
  apiKey: process.env.QWEN_API_KEY,
  region: 'us-east-1', // Opcjonalnie: określ region
});

async function runEdit() {
  try {
    const result = await client.edit({
      imageUrl: 'https://example.com/your-image.jpg',
      edits: [
        { type: 'text_replace', find: 'Hello', replaceWith: 'Hi' }
      ],
    });
    console.log('Edytowany obraz:', result.editedImageUrl);
  } catch (error) {
    console.error('Błąd edycji obrazu:', error);
  }
}

runEdit();

Python

pip install qwen-image-edit-sdk

from qwen_image_edit_sdk import QwenImageEdit

client = QwenImageEdit(
    api_key="YOUR_API_KEY",
    region="us-east-1" # Opcjonalnie: określ region
)

def run_edit():
    try:
        result = client.edit(
            image_url="https://example.com/your-image.jpg",
            edits=[
                {"type": "text_replace", "find": "Hello", "replaceWith": "Hi"}
            ]
        )
        print("Edytowany obraz:", result.edited_image_url)
    except Exception as e:
        print("Błąd edycji obrazu:", e)

run_edit()

PHP

composer require qwen-image-edit/sdk

require 'vendor/autoload.php';

use Qwen\ImageEdit\QwenImageEditClient;

$client = new QwenImageEditClient([
    'apiKey' => 'YOUR_API_KEY',
    'region' => 'us-east-1', // Opcjonalnie: określ region
]);

try {
    $result = $client->edit([
        'imageUrl' => 'https://example.com/your-image.jpg',
        'edits' => [
            ['type' => 'text_replace', 'find' => 'Hello', 'replaceWith' => 'Hi']
        ],
    ]);
    echo 'Edytowany obraz: ' . $result['editedImageUrl'];
} catch (Exception $e) {
    echo 'Błąd edycji obrazu: ' . $e->getMessage();
}

Java

Dodaj następującą zależność do swojego pliku pom.xml (Maven):

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

import com.qwen.imageedit.QwenImageEditClient;
import com.qwen.imageedit.models.EditRequest;
import com.qwen.imageedit.models.TextReplaceEdit;

public class QuickStart {
    public static void main(String[] args) {
        QwenImageEditClient client = new QwenImageEditClient(
            "YOUR_API_KEY",
            "us-east-1" // Opcjonalnie: określ region
        );

        try {
            TextReplaceEdit textEdit = new TextReplaceEdit("Hello", "Hi");
            EditRequest request = new EditRequest(
                "https://example.com/your-image.jpg",
                java.util.Collections.singletonList(textEdit)
            );

            var result = client.edit(request);
            System.out.println("Edytowany obraz: " + result.getEditedImageUrl());
        } catch (Exception e) {
            System.err.println("Błąd edycji obrazu: " + e.getMessage());
        }
    }
}

Go

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

package main

import (
	"context"
	"fmt"
	"log"

	qwen "github.com/qwen-image-edit/go-sdk/qwenimageedit"
	"github.com/qwen-image-edit/go-sdk/qwenimageedit/models"
)

func main() {
	client := qwen.NewClient("YOUR_API_KEY")

	// Opcjonalnie: określ region
	// client.WithRegion("us-east-1")

	edits := []models.EditOperation{
		models.TextReplaceEdit{
			Type:        qwen.String("text_replace"),
			Find:        qwen.String("Hello"),
			ReplaceWith: qwen.String("Hi"),
		},
	}

	resp, err := client.Edit(context.Background(), &models.EditImageRequest{
		ImageURL: qwen.String("https://example.com/your-image.jpg"),
		Edits:    edits,
	})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println("Edytowany obraz:", *resp.EditedImageURL)
}

Ruby

gem install qwen_image_edit

require 'qwen_image_edit'

client = QwenImageEdit::Client.new(
  api_key: 'YOUR_API_KEY',
  region: 'us-east-1' # Opcjonalnie: określ region
)

begin
  result = client.edit(
    image_url: 'https://example.com/your-image.jpg',
    edits: [
      { type: 'text_replace', find: 'Hello', replace_with: 'Hi' }
    ]
  )
  puts "Edytowany obraz: #{result.edited_image_url}"
rescue QwenImageEdit::Error => e
  puts "Błąd edycji obrazu: #{e.message}"
end

2. Pierwsze kroki z edycją

Qwen Image Edit umożliwia edycję obrazów za pomocą prostych instrukcji tekstowych lub ustrukturyzowanych obiektów edycji.

Prosta edycja tekstu

Zmień tekst na obrazie, po prostu mówiąc, co chcesz zmienić:

const result = await client.edit({
  imageUrl: 'https://example.com/image-with-text.jpg',
  prompt: 'Zmień "Stary tekst" na "Nowy tekst"',
});

Edycja elementu

Dodaj lub usuń elementy z obrazu:

const result = await client.edit({
  imageUrl: 'https://example.com/product-image.jpg',
  edits: [
    {
      type: 'add_element',
      elementUrl: 'https://example.com/logo.png',
      position: { x: 10, y: 10 },
      scale: 0.5,
    },
    {
      type: 'remove_element',
      target: 'znak wodny',
    },
  ],
});

3. Kluczowe funkcje

Edycja tekstu: Modyfikuj, tłumacz lub poprawiaj tekst na obrazach, nawet jeśli nie jest on edytowalny.
Manipulacja elementami: Bezproblemowo dodawaj, usuwaj lub zmieniaj rozmiar obiektów, logo, znaków wodnych i innych elementów.
Przenoszenie stylu: Zastosuj style artystyczne lub fotograficzne z jednego obrazu na drugi.
Analiza obrazu: Wyodrębnij tekst, obiekty i inne dane z obrazów.
Przetwarzanie wsadowe: Edytuj wiele obrazów jednocześnie, idealne do katalogów e-commerce lub lokalizacji.

4. Najlepsze praktyki

Efektywne podpowiedzi: Bądź konkretny i zwięzły w swoich podpowiedziach. Używaj języka naturalnego, ale unikaj niejednoznaczności.
Optymalizacja wydajności: W przypadku dużych obciążeń rozważ przetwarzanie wsadowe i asynchroniczne wywołania API.
Obsługa błędów: Zawsze implementuj solidną obsługę błędów i logikę ponawiania, aby radzić sobie z przejściowymi problemami z siecią lub API.

5. Praktyczne przykłady

Lokalizacja marketingowa: Szybko tłumacz tekst na obrazach reklamowych na wiele języków.
E-commerce: Aktualizuj ceny, dodawaj etykiety promocyjne lub zmieniaj tła produktów w całym katalogu.
Tworzenie treści: Generuj warianty obrazów do mediów społecznościowych lub postów na blogach.

6. Następne kroki

Przykłady: Zapoznaj się z naszymi przykładami, aby uzyskać bardziej szczegółowe przypadki użycia.
Dokumentacja API: Zapoznaj się z pełnym odniesieniem do API, aby uzyskać szczegółowe informacje o wszystkich dostępnych punktach końcowych i parametrach.
Konfiguracja: Dowiedz się więcej o konfiguracji swojego klienta Qwen Image Edit.
Rozwiązywanie problemów: Znajdź rozwiązania typowych problemów w naszym przewodniku rozwiązywania problemów.

Szybki start

On this page