Skip to main content
POST
Text-to-Image: Generate an image from a text prompt
오른쪽의 인터랙티브 플레이그라운드에서는 매개변수(종횡비, 해상도, 응답 유형 등)를 드롭다운으로 선택할 수 있습니다. 테스트 요청을 한 번에 보내려면 Authorization 필드에 API Key를 입력하십시오(형식: Bearer sk-xxx).
범위: 이 페이지는 텍스트-투-이미지 생성용입니다. 프롬프트만 입력하면 되며, 이미지 업로드는 필요하지 않습니다. 기존 이미지를 편집하려면 이미지 편집 엔드포인트를 사용하십시오.
🖥️ 브라우저 플레이그라운드 제한(중요)이 엔드포인트는 응답으로 base64로 인코딩된 이미지(inlineData.data, 일반적으로 수 MB)를 반환합니다. 브라우저 렌더링 한계 때문에 오른쪽의 플레이그라운드에는 응답이 도착한 뒤 请求时发生错误: unable to complete request가 표시될 수 있습니다 — 요청은 실제로 성공했습니다. 브라우저가 이렇게 긴 base64 문자열을 렌더링할 수 없을 뿐입니다.권장 작업 흐름(초보자 친화적):
  • 아래의 Python / Node.js / cURL 샘플을 복사해 로컬에서 실행하십시오. 코드는 응답을 자동으로 base64.b64decode하고 이미지를 파일로 저장합니다.
  • 브라우저 내 플레이그라운드를 반드시 사용해야 한다면, imageSize를 가장 작은 티어(예: 1K)로 설정하여 응답을 줄이십시오.
모든 이미지 API는 동기식입니다. 즉, 폴링할 작업 ID가 없으며, 클라이언트가 연결을 끊으면 요청은 계속 과금되지만 결과는 사라집니다. 이 모델에는 충분히 넉넉한 타임아웃을 설정하십시오. 자세한 내용은 이미지 API 필수 사항 및 모범 사례를 참조하십시오.

코드 예제

Python

cURL

Node.js

매개변수 빠른 참조

자세한 매개변수 문서, 허용 값, 기본값은 오른쪽 Playground의 필드 설명을 참조하십시오. aspectRatio, imageSize 같은 모든 enum 유형 필드는 드롭다운 선택을 지원하므로 수동 입력이 필요하지 않습니다.
지원되지 않는 기능다음 Google 공식 기능은 APIYI를 통해서는 지원되지 않으며 별도의 과금이 필요합니다:
  • Google Search를 통한 Grounding: tools: [{"google_search": {}}]를 통한 실시간 검색 정보
  • thinkingConfig(Thinking 모드): Nano Banana 2에서만 지원되며, Nano Banana Pro에서는 지원되지 않음
검색 grounding 기능에 대해서는 별도의 과금 옵션은 지원팀에 문의해 주십시오.

인증

Authorization
string
header
필수

API Key from APIYI Console

본문

application/json
contents
object[]
필수

Content array containing the text prompt

generationConfig
object
필수

응답

Image generated successfully

candidates
object[]

Generated results array

usageMetadata
object