문제 해결
일반적인 문제 해결 방법 및 문제 해결 팁
Qwen Image Edit 를 사용하는 동안 발생할 수 있는 일반적인 문제와 해결 방법에 대해 설명합니다.
1. 인증 오류
유효하지 않은 API 키
API 키가 올바르게 설정되었는지 확인하십시오. 키가 유효하지 않거나 만료된 경우 새 키를 생성해야 할 수 있습니다.
지원되지 않는 리전
API 요청이 지원되는 리전으로 전송되고 있는지 확인하십시오. 지원되는 리전 목록은 API 참조를 참조하십시오.
2. 할당량 및 속도 제한 문제
크레딧 부족
계정에 충분한 크레딧이 있는지 확인하십시오. 크레딧이 부족한 경우 추가 크레딧을 구매해야 할 수 있습니다.
속도 제한 초과
짧은 시간 내에 너무 많은 요청을 보내면 속도 제한에 도달할 수 있습니다. 요청 사이에 지연을 구현하거나 일괄 처리를 사용하여 속도 제한을 초과하지 않도록 하십시오.
3. 이미지 관련 문제
이미지가 너무 큼
처리할 이미지의 크기가 API 의 제한을 초과하지 않는지 확인하십시오. 큰 이미지는 처리하기 전에 크기를 조정하거나 압축해야 할 수 있습니다.
지원되지 않는 이미지 형식
API 가 지원하는 이미지 형식 (예: JPEG, PNG) 을 사용하고 있는지 확인하십시오. 지원되는 형식 목록은 API 참조를 참조하십시오.
4. 네트워크 문제
연결 시간 초과
네트워크 연결이 안정적인지 확인하십시오. 방화벽 또는 프록시 설정이 API 에 대한 연결을 차단하고 있을 수 있습니다.
네트워크 오류
일시적인 네트워크 문제가 발생했을 수 있습니다. 잠시 기다렸다가 요청을 다시 시도하십시오.
5. 처리 실패
처리 실패
이미지 처리가 실패한 경우 입력 이미지가 유효하고 API 요구 사항을 충족하는지 확인하십시오. 자세한 내용은 API 응답을 확인하십시오.
콘텐츠 감지 안 됨
편집하려는 콘텐츠 (텍스트 또는 요소 등) 가 이미지 내에서 명확하게 식별할 수 있는지 확인하십시오. 콘텐츠가 모호하거나 너무 작으면 API 가 감지하지 못할 수 있습니다.
6. 성능 문제
느린 처리
처리가 느린 경우 다음을 고려하십시오.
- 이미지 크기 최적화.
- 일괄 처리 사용.
- 더 빠른 네트워크 연결 사용.
메모리 부족
큰 이미지를 처리할 때 메모리 부족 오류가 발생할 수 있습니다. 시스템에 충분한 메모리가 있는지 확인하거나 더 작은 이미지를 처리하는 것을 고려하십시오.
7. 디버깅 도구
상세 로깅
API 클라이언트에서 상세 로깅을 활성화하여 요청 및 응답에 대한 자세한 정보를 얻으십시오. 이는 문제의 근본 원인을 식별하는 데 도움이 됩니다.
요청 인터셉터
요청 인터셉터를 사용하여 API 요청이 올바르게 구성되었고 필요한 모든 헤더와 매개변수가 포함되어 있는지 확인하십시오.
상태 확인
API 의 상태 확인 엔드포인트를 사용하여 서비스가 정상적으로 작동하는지 확인하십시오.
8. 지원
위의 단계로 문제가 해결되지 않으면 지원팀에 문의하십시오. 문제 진단에 도움이 되도록 모든 관련 오류 메시지, 요청 ID 및 로그를 제공하십시오.