Skip to main content
POST
Text-to-image: generate an image from a text description
오른쪽의 대화형 Playground는 매개변수(종횡비, 응답 유형 등)에 대한 드롭다운 선택을 지원합니다. 테스트 요청을 원클릭으로 보내려면 Authorization 필드에 API Key를 입력하십시오(형식: Bearer sk-xxx).
범위: 이 페이지는 text-to-image generation용입니다. prompt만 입력하면 되며, 이미지 업로드는 필요하지 않습니다. 기존 이미지를 편집하려면 Image Editing endpoint를 사용하십시오.
🖥️ 브라우저 Playground 제한(중요)이 endpoint는 응답에 base64로 인코딩된 이미지(inlineData.data, 보통 수 MB)를 반환합니다. 브라우저 렌더링 제한 때문에 오른쪽 Playground는 응답이 도착한 뒤 请求时发生错误: unable to complete request로 표시될 수 있습니다 — 실제로 요청은 성공한 것입니다; 브라우저가 그렇게 긴 base64 문자열을 렌더링하지 못할 뿐입니다.권장 작업 흐름(초보자 친화적):
  • 아래 Python / Node.js / cURL 샘플을 복사해 로컬에서 실행하십시오. 코드는 응답을 자동으로 base64.b64decodes하고 이미지를 파일로 저장합니다.
  • Nano Banana 2 Lite는 1K 캔버스에 초점을 맞추고 있으므로 응답 크기는 중간 정도이지만, 이미지를 저장하려면 로컬에서 실행하는 것이 여전히 가장 안전합니다.
모든 image API는 동기식입니다 — 폴링할 task ID가 없으며, 클라이언트가 연결을 끊으면 요청은 계속 과금되는 동안 결과는 사라집니다. 이 모델에는 넉넉한 타임아웃을 설정하십시오. Image API Essentials & Best Practices를 참조하십시오.

코드 예제

Python

cURL

Node.js

OpenAI 호환 모드

파라미터 빠른 참조

자세한 파라미터 문서, 허용 값, 기본값은 오른쪽 플레이그라운드의 필드 설명을 참고하십시오. aspectRatio와 같은 모든 enum 유형 필드는 드롭다운 선택을 지원하므로 수동 입력이 필요하지 않습니다.
Nano Banana 2에서 마이그레이션하는 경우: 모델 이름을 gemini-3.1-flash-image에서 gemini-3.1-flash-lite-image으로만 변경하고, 다른 파라미터는 그대로 유지하십시오. Lite는 1K만 지원하므로 2K/4K를 전달하는 경우 1K로 다시 전환하십시오.

인증

Authorization
string
header
필수

API Key obtained from the APIYI console

본문

application/json
contents
object[]
필수

Content array containing the text prompt

generationConfig
object
필수

응답

Image generated successfully

candidates
object[]

Array of generation results

usageMetadata
object