Guida Rapida

Benvenuti nella Guida Rapida di Qwen Image Edit! Questa guida vi aiuterà a iniziare rapidamente con la nostra potente API di editing di immagini basata sull'IA. Imparerete come configurare il vostro ambiente, eseguire la vostra prima modifica e comprendere le capacità principali.

1. Configurazione Iniziale

Ottenere la Chiave API

Per utilizzare Qwen Image Edit, avrete bisogno di una chiave API. Se non ne avete ancora una, registratevi e ottenetela dalla vostra Dashboard Qwen Image Edit.

Installazione

Qwen Image Edit fornisce SDK per diverse lingue per facilitare l'integrazione. Scegliete la vostra lingua preferita:

JavaScript/TypeScript

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

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

const client = new QwenImageEdit({
  apiKey: 'YOUR_API_KEY',
  region: 'us-east-1', // Sostituisci con la tua regione
});

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' # Sostituisci con la tua regione
)

PHP

composer require qwen-image-edit/sdk

require 'vendor/autoload.php';
use QwenImageEdit\QwenImageEdit;

$client = new QwenImageEdit([
    'apiKey' => 'YOUR_API_KEY',
    'region' => 'us-east-1' // Sostituisci con la tua regione
]);

Java

(Aggiungi la dipendenza Maven/Gradle)

import com.qwen.image.edit.QwenImageEditClient;

QwenImageEditClient client = new QwenImageEditClient.Builder()
    .apiKey("YOUR_API_KEY")
    .region("us-east-1") // Sostituisci con la tua regione
    .build();

Go

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

import "github.com/qwen-image-edit/sdk-go/qwenimeditsdk"

client := qwenimeditsdk.NewClient("YOUR_API_KEY", "us-east-1") // Sostituisci con la tua regione

Ruby

gem install qwen-image-edit-sdk

require 'qwen_image_edit_sdk'

client = QwenImageEditSdk::Client.new(
  api_key: 'YOUR_API_KEY',
  region: 'us-east-1' # Sostituisci con la tua regione
)

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

const client = new QwenImageEdit({
  apiKey: 'YOUR_API_KEY',
  region: 'us-east-1',
});

async function editTextInImage() {
  try {
    const imageUrl = 'https://example.com/image-with-text.jpg'; // Sostituisci con l'URL della tua immagine
    const prompt = 'Cambia il testo "Hello World" in "Hello Qwen!"';

    const result = await client.edit({
      imageUrl: imageUrl,
      prompt: prompt,
    });

    console.log('Immagine modificata:', result.editedImageUrl);
  } catch (error) {
    console.error('Errore durante la modifica dell\'immagine:', error);
  }
}

editTextInImage();

Questo codice invia un'immagine e un prompt testuale all'API Qwen Image Edit, che poi restituisce l'URL dell'immagine modificata.

3. Caratteristiche Principali

Qwen Image Edit offre una vasta gamma di capacità di editing basate sull'IA:

Editing Testuale: Modifica, traduci o correggi il testo all'interno delle immagini in modo fluido.
Manipolazione degli Elementi: Aggiungi, rimuovi o modifica oggetti e elementi all'interno delle immagini (es. loghi, filigrane, tag di prezzo).
Trasferimento di Stile: Applica stili artistici o fotografici da un'immagine all'altra.
Analisi delle Immagini: Ottieni informazioni dettagliate sul contenuto dell'immagine, inclusi oggetti, scene e testo.
Elaborazione Batch: Elabora più immagini contemporaneamente per flussi di lavoro efficienti.

4. Best Practice

Prompt Efficaci: Scrivi prompt chiari e concisi. Sii specifico riguardo alle modifiche desiderate.
- Buono: "Rimuovi lo sfondo e sostituiscilo con uno sfondo bianco puro."
- Migliore: "Rimuovi lo sfondo dall'oggetto principale e rendi lo sfondo trasparente."
Ottimizzazione delle Prestazioni: Per carichi di lavoro di grandi dimensioni, considera l'elaborazione batch e l'ottimizzazione delle dimensioni dell'immagine.
Gestione degli Errori: Implementa una robusta gestione degli errori e meccanismi di retry per gestire i fallimenti dell'API.

5. Esempi Pratici

Qwen Image Edit può essere utilizzato per una moltitudine di casi d'uso:

Localizzazione Marketing: Traduci il testo su banner pubblicitari e materiali promozionali per diversi mercati.
E-commerce: Aggiorna i tag di prezzo, aggiungi loghi di prodotti o cambia gli sfondi dei prodotti per diverse stagioni.
Creazione di Contenuti: Genera rapidamente variazioni di immagini per i social media o i post del blog.

6. Prossimi Passi

Ora che hai completato la guida rapida, esplora queste risorse per approfondire:

Esempi: Scopri altri esempi pratici e casi d'uso.
Riferimento API: Esplora la documentazione completa dell'API per tutti gli endpoint e i parametri.
Configurazione: Scopri le opzioni di configurazione avanzata.
Risoluzione dei Problemi: Trova soluzioni ai problemi comuni.