Configurazione

Questa sezione descrive come configurare Qwen Image Edit per il tuo progetto.

Configurazione Iniziale

Per iniziare, devi configurare il tuo client con la chiave API e la regione.

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

const qwen = new QwenImageEdit({
  apiKey: process.env.QWEN_API_KEY,
  region: 'us-east-1', // o la tua regione preferita
});

Variabili d'Ambiente

Si consiglia di utilizzare variabili d'ambiente per archiviare le chiavi API e altre informazioni sensibili.

# .env.local
QWEN_API_KEY=la_tua_chiave_api

Configurazione Avanzata

Client Setup

Puoi personalizzare il client con opzioni aggiuntive come timeout e tentativi.

const qwen = new QwenImageEdit({
  apiKey: process.env.QWEN_API_KEY,
  timeout: 30000, // 30 secondi
  maxRetries: 5,
});

Cache

Configura le opzioni di caching per migliorare le prestazioni.

const qwen = new QwenImageEdit({
  // ...
  cache: {
    enabled: true,
    ttl: 3600, // 1 ora
  },
});

Proxy

Se necessario, configura un proxy per le richieste API.

const qwen = new QwenImageEdit({
  // ...
  proxy: 'http://il_tuo_proxy:8080',
});

Configurazione Specifica per l'Ambiente

Puoi avere configurazioni diverse per ambienti di sviluppo, staging e produzione.

const config = {
  development: {
    // ...
  },
  production: {
    // ...
  },
};

const qwen = new QwenImageEdit(config[process.env.NODE_ENV]);

Logging

Abilita e configura il logging per il debug e il monitoraggio.

const qwen = new QwenImageEdit({
  // ...
  logging: {
    level: 'debug', // 'info', 'warn', 'error'
    // ...
  },
});

Sicurezza

Implementa le migliori pratiche di sicurezza per proteggere le tue chiavi API e i dati.

• Non esporre mai le chiavi API sul lato client.
• Utilizza connessioni HTTPS.
• Ruota regolarmente le chiavi API.

Prestazioni

Ottimizza le prestazioni configurando il client in modo efficiente.

• Utilizza il caching per le risposte API.
• Implementa la gestione degli errori con tentativi e backoff esponenziale.

Monitoraggio

Integra strumenti di monitoraggio per tenere traccia dell'utilizzo dell'API e delle prestazioni.

Strumenti di Sviluppo

Utilizza strumenti di sviluppo per facilitare l'integrazione e il debug.

• SDK per vari linguaggi.
• Documentazione API interattiva.

Migliori Pratiche

• Gestione degli errori: Implementa una robusta gestione degli errori per tutte le chiamate API.
• Riprova: Utilizza la logica di riprova con backoff esponenziale per errori transitori.
• Idempotenza: Progetta le tue chiamate API per essere idempotenti quando possibile.