구성

Qwen Image Edit 클라이언트를 구성하면 애플리케이션의 특정 요구 사항에 맞게 동작을 사용자 정의할 수 있습니다. 이 문서는 초기 설정부터 고급 최적화까지 다양한 구성 옵션을 다룹니다.

1. 초기 구성

Qwen Image Edit 클라이언트를 초기화할 때 API 키와 리전을 제공해야 합니다.

// JavaScript/TypeScript
import { QwenImageEdit } from 'qwen-image-edit';

const client = new QwenImageEdit({
  apiKey: process.env.QWEN_IMAGE_EDIT_API_KEY, // 환경 변수에서 API 키 로드
  region: 'us-east-1', // API 엔드포인트 리전
  timeout: 30000, // 요청 시간 초과 (밀리초)
});

환경 변수

API 키와 같은 민감한 정보는 환경 변수를 통해 관리하는 것이 좋습니다. 이렇게 하면 코드가 노출되지 않고 다른 환경에서 쉽게 구성할 수 있습니다.

# .env 파일
QWEN_IMAGE_EDIT_API_KEY=your_super_secret_api_key
QWEN_IMAGE_EDIT_REGION=us-east-1

2. 클라이언트 설정

클라이언트 초기화 중에 다음 옵션을 구성할 수 있습니다.

apiKey (string, 필수): Qwen Image Edit API 키.
region (string, 필수): API 요청을 보낼 리전 (예: 'us-east-1', 'eu-west-1').
timeout (number, 선택 사항): 요청 시간 초과 (밀리초). 기본값은 30000 (30초) 입니다.
maxRetries (number, 선택 사항): 실패한 요청에 대한 최대 재시도 횟수 (기본값: 3).
retryDelay (number, 선택 사항): 재시도 간 지연 (밀리초). 기본값은 1000 (1초) 입니다.

3. 캐시 구성

Qwen Image Edit 는 캐싱을 지원하여 자주 요청되는 이미지 및 편집 결과에 대한 응답 시간을 개선할 수 있습니다. 다양한 캐시 전략을 구성할 수 있습니다.

인메모리 캐시

개발 및 테스트에 적합한 간단한 인메모리 캐시입니다.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  // ...
  cache: {
    type: 'memory',
    ttl: 3600, // 초 단위의 Time-To-Live (1시간)
    maxEntries: 1000, // 최대 캐시 항목 수
  },
});

Redis 캐시

프로덕션 환경에 권장되는 영구 캐시입니다.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  // ...
  cache: {
    type: 'redis',
    url: process.env.REDIS_URL, // Redis 서버 URL
    ttl: 3600,
  },
});

파일 시스템 캐시

로컬 파일 시스템에 캐시된 데이터를 저장합니다.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  // ...
  cache: {
    type: 'file',
    path: '/tmp/qwen-image-edit-cache', // 캐시 파일 저장 경로
    ttl: 3600,
  },
});

사용자 정의 캐시

사용자 정의 캐시 구현을 제공할 수 있습니다.

// JavaScript/TypeScript
const myCustomCache = {
  get: async (key) => { /* ... */ },
  set: async (key, value, ttl) => { /* ... */ },
  del: async (key) => { /* ... */ },
};

const client = new QwenImageEdit({
  // ...
  cache: myCustomCache,
});

4. 프록시 구성

네트워크 환경에 따라 프록시를 통해 API 요청을 라우팅해야 할 수 있습니다.

HTTP/HTTPS 프록시

// JavaScript/TypeScript
const client = new QwenImageEdit({
  // ...
  proxy: {
    host: 'your-proxy-host.com',
    port: 8080,
    protocol: 'http', // 또는 'https'
    auth: {
      username: 'proxyuser',
      password: 'proxypassword',
    },
  },
});

SOCKS 프록시

// JavaScript/TypeScript
const client = new QwenImageEdit({
  // ...
  proxy: {
    host: 'your-socks-proxy-host.com',
    port: 1080,
    protocol: 'socks5', // 또는 'socks4'
  },
});

인증서

자체 서명된 인증서 또는 사용자 정의 CA 를 사용하는 경우 추가 인증서 구성을 제공할 수 있습니다.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  // ...
  tls: {
    ca: '-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----',
    // 또는 cert, key 등
  },
});

5. 환경별 구성

개발, 스테이징 및 프로덕션과 같은 다양한 환경에 대해 다른 구성을 유지하는 것이 일반적입니다.

// JavaScript/TypeScript
const config = {
  development: {
    apiKey: process.env.DEV_API_KEY,
    region: 'us-east-1',
    loggingLevel: 'debug',
  },
  production: {
    apiKey: process.env.PROD_API_KEY,
    region: 'us-west-2',
    cache: { type: 'redis', url: process.env.REDIS_URL },
    maxRetries: 5,
  },
  testing: {
    apiKey: 'mock-api-key',
    region: 'mock-region',
    mockApi: true,
  },
};

const environment = process.env.NODE_ENV || 'development';
const client = new QwenImageEdit(config[environment]);

6. 로깅

Qwen Image Edit 클라이언트는 디버깅 및 모니터링을 위해 로깅을 지원합니다.

기본 로깅

// JavaScript/TypeScript
const client = new QwenImageEdit({
  // ...
  loggingLevel: 'info', // 'debug', 'info', 'warn', 'error', 'silent'
});

고급 로깅

사용자 정의 로거를 제공하여 로깅 동작을 완전히 제어할 수 있습니다.

// JavaScript/TypeScript
const myCustomLogger = {
  debug: (message, ...args) => console.log('[DEBUG]', message, ...args),
  info: (message, ...args) => console.info('[INFO]', message, ...args),
  warn: (message, ...args) => console.warn('[WARN]', message, ...args),
  error: (message, ...args) => console.error('[ERROR]', message, ...args),
};

const client = new QwenImageEdit({
  // ...
  logger: myCustomLogger,
});

구조화된 로깅

로그를 JSON 형식으로 출력하여 로그 관리 시스템에서 쉽게 구문 분석할 수 있도록 합니다.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  // ...
  loggingFormat: 'json',
});

7. 보안

입력 유효성 검사

API 에 전송하기 전에 모든 사용자 입력을 유효성 검사하여 악의적인 데이터 또는 예기치 않은 동작을 방지합니다.

API 키 순환

보안 모범 사례로 API 키를 정기적으로 순환합니다. Qwen Image Edit 는 여러 API 키를 지원하여 원활한 순환을 가능하게 합니다.

8. 성능

연결 풀링

API 요청에 대한 HTTP 연결 풀링을 활성화하여 오버헤드를 줄이고 처리량을 개선합니다.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  // ...
  connectionPooling: {
    enabled: true,
    maxSockets: 100, // 풀의 최대 소켓 수
    maxFreeSockets: 10, // 유휴 상태로 유지할 최대 소켓 수
  },
});

이미지 압축

API 로 전송하기 전에 이미지를 압축하여 대역폭 사용량을 줄이고 업로드 시간을 단축합니다.

메모리 관리

특히 대규모 이미지 또는 일괄 처리 시 애플리케이션의 메모리 사용량을 모니터링하고 최적화합니다.

9. 모니터링

메트릭

API 사용량, 응답 시간 및 오류율에 대한 메트릭을 수집하여 성능 문제를 식별하고 사용량을 추적합니다.

상태 확인

Qwen Image Edit 서비스의 상태를 모니터링하기 위해 상태 확인 엔드포인트를 구현합니다.

10. 개발 도구

핫 리로드

개발 중에 코드 변경 사항을 자동으로 다시 로드하도록 개발 환경을 구성합니다.

목 (Mock) API

테스트 및 개발을 위해 Qwen Image Edit API 를 목업하여 실제 API 호출 없이 애플리케이션을 테스트할 수 있습니다.

// JavaScript/TypeScript
const client = new QwenImageEdit({
  // ...
  mockApi: process.env.NODE_ENV === 'development' || process.env.NODE_ENV === 'test',
});

11. 모범 사례

구성 관리

환경별 구성에 대해 dotenv 또는 구성 관리 시스템을 사용합니다.

유효성 검사

런타임 오류를 방지하기 위해 구성 값을 항상 유효성 검사합니다.

비밀 관리

API 키와 같은 민감한 정보는 안전한 비밀 관리 솔루션에 저장합니다.

구성

On this page