간단한 답변
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에 연결합니다.
token 모델 허용 목록
token이 액세스할 수 있는 모델을 구성합니다.