간단한 답변
gemini-3-pro-image, Banana Pro 또는 Banana 2를 사용하는 경우, 생성된 이미지와 참조 이미지 사이의 큰 차이는 보통 참조 이미지 업로드 형식 불일치 때문에 발생합니다.
- 이 모델들은 OpenAI 형식의 참조 이미지 업로드를 지원하지 않습니다
- 참조 이미지는 base64 문자열로 업로드해야 합니다
- 이 문제는 모델 자체가 아니라 통합 방식과 관련이 있습니다
문제 해결 단계
다음 점검 사항을 순서대로 확인합니다:1
웹 콘솔에서 모델 테스트
imagen.apiyi.com를 열고 같은 참조를 웹 UI에서 실행합니다.웹 결과가 참조와 일치하면 모델은 정상적으로 동작하는 것이며, 문제는 통합 쪽에 있습니다. 웹 결과도 다르면 다음 점검으로 진행합니다.2
token 그룹 확인
APIYI 콘솔에서 token에
gemini-3-pro-image 또는 Banana 시리즈 모델 그룹이 포함되어 있는지 확인합니다.모델이 활성화되지 않으면 호출이 기본 동작으로 폴백되어 예상치 못한 결과가 나올 수 있습니다.3
과금 방식 확인
token 설정에서 과금 방식을 확인합니다:
- 종량제 우선: 사용량 기반과 구독 쿼터를 모두 사용합니다
- 종량제만: 사용량 기반 쿼터만 사용할 수 있습니다
4
통합 방법 확인
요청이 공식 모델 문서와 일치하는지 다시 확인합니다.Banana 2의 경우:
docs.apiyi.com/api-capabilities/nano-banana-2-image/image-edit다음 사항에 주의합니다:- reference 필드는 URL이 아니라 base64 문자열을 기대합니다
- MIME 타입은 실제 이미지 형식과 일치해야 합니다
- 파라미터 형식은 이 모델이 지원하는 내용과 일치해야 합니다
일반적인 원인
관련 질문
Nano Banana 이미지 실패
Nano Banana 모델에 대한 일반적인 문제와 해결 방법입니다.
이미지 비동기 API
이미지 비동기 작업 엔드포인트를 사용하는 방법입니다.
기본 URL 구성 방법
다양한 클라이언트 도구에서 APIYI를 연결하는 방법입니다.
토큰 모델 화이트리스트
토큰이 접근할 수 있는 모델을 구성합니다.