Skip to main content
POST
Gemini 텍스트 이미지 생성 API
Nano Banana Pro, 2, 2.1로 텍스트 설명에서 이미지를 생성합니다. POST /v1beta/models/{model}:generateContent 텍스트 이미지 생성과 이미지 편집은 같은 API를 사용합니다. 편집할 때는 요청에 참조 이미지를 추가합니다.

요청 테스트

x-goog-api-key에 BetterToken API Key를 입력하고 model을 선택한 뒤 contents의 텍스트를 수정하세요. 1K, 1:1로 시작하고 Send를 누르세요.
Send를 누르면 실제 생성 요청이 전송되며 요금이 발생할 수 있습니다. 동기 응답을 기다리세요. 시간 초과나 연결 끊김 후에는 사용 기록과 요청 결과를 확인한 뒤 다시 전송하세요.
세 모델 모두 1K, 2K, 4K를 제공합니다. Nano Banana 2와 2.1은 14개, Pro는 10개 비율을 지원합니다. X-BetterToken-Max-Images는 반환 및 과금 이미지 수의 상한이며 생성 수를 보장하지 않습니다. 지원 비율
BetterToken API는 Google 웹 검색 및 이미지 검색 기반 이미지 생성을 지원하지 않습니다. 검색 도구를 추가하지 마세요.
텍스트로 이미지를 생성할 때는 설명만 있으면 되며 참조 이미지는 필요하지 않습니다. 비스트리밍 generateContent를 사용하며 Files, Batch, Interactions 및 스트리밍은 지원하지 않습니다.

응답 읽기

이미지는 candidates[].content.parts[].inlineData에 반환됩니다. 모든 part를 순회하고 thought: true를 건너뛴 뒤 data를 디코딩하고 mimeType에 따라 확장자를 선택하세요. 이미지가 항상 첫 part이거나 PNG인 것은 아닙니다.

관련 가이드

인증

x-goog-api-key
string
header
필수

BetterToken API Key.

헤더

X-BetterToken-Max-Images
integer
기본값:1

반환 및 과금 이미지 수의 상한이며 수량 보장이 아닙니다. 기본값은 1.

필수 범위: 1 <= x <= 4

경로 매개변수

model
enum<string>
기본값:nano-banana-2.1
필수

BetterToken 모델 ID. Nano Banana 모델 세 개 중 선택하세요.

사용 가능한 옵션:
nano-banana-pro,
nano-banana-2,
nano-banana-2.1

본문

application/json
contents
object[]
필수

대화 기록. 후속 편집 시 모델의 전체 content와 thoughtSignature를 유지하세요.

Minimum array length: 1
generationConfig
object

이미지 생성 설정.

응답

생성 결과. 최종 이미지 part와 finishReason을 확인하세요.

candidates
object[]
promptFeedback
object
usageMetadata
object