Skip to main content

짧은 답변

API가 finishReason: NO_IMAGE을 반환하고 partsnull인 경우, 모델은 일반적으로 요청을 처리했지만 이미지 콘텐츠를 반환하지 않은 것입니다. 이는 반드시 프롬프트가 콘텐츠 안전 차단을 유발했다는 의미는 아닙니다. “GEO란 무엇입니까?” 또는 “이 개념을 설명해 주세요”와 같은 프롬프트는 텍스트 질문에 더 가깝게 보입니다. 모델은 사용자가 명시적으로 이미지를 원한다는 것을 확인하지 못할 수 있으므로 NO_IMAGE을 반환합니다. 프롬프트의 시작 부분에서 이미지 생성 의도를 명확히 밝힌 다음, 주제, 레이아웃, 스타일 및 출력 요구 사항을 설명합니다.

NO_IMAGE이 발생하는 이유는 무엇입니까?

1. 프롬프트가 텍스트 질문처럼 보입니다

예를 들면 다음과 같습니다.
개념을 설명하지만 다음 내용을 명확하게 지정하지 않습니다.
  • 어떤 유형의 이미지를 생성해야 하는지
  • 이미지에 어떤 요소가 표시되어야 하는지
  • 정보를 어떻게 배치해야 하는지
  • 응답에 이미지만 포함해야 하는지
요청에 “이미지를 생성해 주세요”라는 문구가 포함되어 있더라도 모델은 여전히 전체 요청을 텍스트 설명으로 해석할 수 있습니다.

2. 이미지 의도가 충분히 구체적이지 않습니다

일부 플랫폼 도구는 “이미지를 생성합니다:”와 같은 지침을 자동으로 앞에 추가합니다. 그러나 직접 API를 호출하는 경우에는 완전한 이미지 생성 지침이 자동으로 추가되지 않은 채 요청이 투명하게 전달될 수 있습니다. 다음과 같이 작성하는 대신:
이미지 유형과 시각적 목표를 직접 지정합니다.

3. 프롬프트에 시각적 설명이 없습니다

프롬프트가 개념만 설명하는 경우 모델은 이를 시각적 구성으로 변환하는 방법을 알 수 없습니다. 다음과 같은 내용을 지정하는 것이 좋습니다.
  • 이미지 유형: 인포그래픽, 포스터, 순서도 또는 홍보용 그래픽
  • 레이아웃: 3열, 타임라인 또는 방사형 구조
  • 시각적 스타일: 기술, 비즈니스, 미니멀리즘 또는 브랜드 스타일
  • 텍스트 계층 구조: 제목, 번호가 매겨진 섹션, 본문 및 레이아웃
  • 출력 지침: 텍스트 설명 없이 이미지만 생성

GEO 프롬프트 예시

다음과 같이 원래 프롬프트를 다시 작성할 수 있습니다.
“이미지 생성”은 작업 힌트일 뿐입니다. 시각적 결과에 대한 설명을 대신하지는 않습니다. 이미지 유형, 주제, 레이아웃, 스타일을 더 명확하게 설명할수록 모델이 요청을 이미지 생성으로 식별하기가 쉬워집니다.

NO_IMAGE 문제 해결 방법

1

1단계: 응답에 이미지 데이터가 포함되어 있는지 확인합니다

응답에서 parts, inlineData, image 또는 이에 해당하는 이미지 필드를 확인합니다. parts이(가) null이면 일반적으로 응답에 이미지 콘텐츠가 포함되지 않은 것입니다.
2

2단계: prompt에서 이미지를 명시적으로 요청했는지 확인합니다

prompt에 “이미지 생성”, “포스터 생성” 또는 “이미지를 생성”과 같은 명확한 지시가 포함되어 있는지 확인합니다. “무엇이…” 또는 “설명…”과 같은 텍스트 질문만 제출하지 마십시오.
3

3단계: 다음으로 콘텐츠 안전 요소를 확인합니다

prompt에서 이미지를 명확히 요청했는데도 NO_IMAGE가 반환되면 NSFW 콘텐츠, 미성년자, 잘 알려진 IP, 워터마크 제거, 실존 인물 초상 또는 기타 상위 시스템의 안전 정책을 확인합니다.
4

4단계: 호출 로그를 확인합니다

호출 로그에서 전체 응답, 모델 이름, 요청 ID 및 과금 기록을 검토합니다. usageMetadata은 모델이 요청을 처리했음을 보여주지만, 이미지가 생성되었거나 안전 차단이 발생했음을 입증하지는 않습니다.

NO_IMAGE는 안전 차단과 어떻게 다릅니까?

finishReason: NO_IMAGE는 이미지가 반환되지 않았다는 의미일 뿐입니다. 이것만으로는 prompt가 정책을 위반했다는 사실을 입증할 수 없습니다. 전체 오류, prompt 및 호출 로그를 함께 사용합니다.

자주 묻는 질문

아닙니다. 기본 의도만 더 명확해질 뿐입니다. 이미지 유형, 주제, 구성, 스타일 및 출력 요구 사항도 설명해야 합니다. 추상적인 개념의 경우 인포그래픽, 포스터 또는 순서도를 요청한다고 명시하십시오.
GEO 개념 자체에는 명백한 안전 위험이 포함되어 있지 않은 것으로 보입니다. 그러나 NO_IMAGE만으로는 상위 수준의 정책 결정을 완전히 배제할 수 없습니다. 이 경우 prompt는 지식 설명에 더 가까우므로, 불분명한 이미지 의도를 먼저 확인하는 것이 적절합니다.
usageMetadata는 모델이 입력을 처리하고 추론 또는 텍스트 token을 생성했다는 사실만 보여 줍니다. 응답에 이미지가 포함되어 있다는 의미는 아닙니다. 응답의 이미지 데이터 필드를 확인하십시오.
NO_IMAGE만으로 과금을 판단하지 마십시오. APIYI 호출 로그를 확인하여 요청으로 과금 기록이 생성되었는지 확인하십시오.

계속 문제가 해결되지 않나요? 지원팀에 문의하세요

이미지 의도를 명확히 했는데도 요청이 계속 NO_IMAGE을(를) 반환하면 APIYI 지원팀에 문의하고 다음 정보를 포함하세요.
  • 모델 이름 및 token 그룹
  • 전체 오류 메시지 및 request ID
  • 마스킹된 prompt
  • 발생 시간
  • 호출 로그의 과금 기록
전체 API 키를 절대 보내지 마세요. 스크린샷이나 로그를 공유하기 전에 키를 마스킹하세요.

WeCom 지원

QR 코드를 스캔하거나 이 카드를 클릭하여 지원팀에 직접 문의하세요.

이메일 지원

지원팀: [email protected]제목에 “NO_IMAGE” 및 모델 이름을 포함하는 것을 권장합니다.

관련 문서

Nano Banana 이미지 생성 실패

안전성, 워터마크 제거, 유명 IP 및 미성년자와 관련된 일반적인 원인

모델 API 오류를 어떻게 해결합니까?

401, 429, 503, 504, 시간 초과 및 그룹 문제에 대한 일반적인 안내

로그에서 과금 금액을 어떻게 확인합니까?

호출 로그를 사용하여 요청이 성공했으며 과금되었는지 확인