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

코드 예제

파이썬

cURL

Node.js

매개변수 빠른 참조

자세한 매개변수 문서, 허용 값, 기본값은 오른쪽 Playground의 필드 설명을 참조하십시오. aspectRatio, imageSize, thinkingLevel 같은 모든 enum 유형 필드는 드롭다운 선택을 지원하므로 수동 입력이 필요하지 않습니다.
지원되지 않는 기능다음 Google 공식 기능은 APIYI를 통해서는 지원되지 않으며 별도의 과금이 필요합니다:
  • Grounding with Google Search: tools: [{"google_search": {}}]를 통한 실시간 검색 정보
  • Image Search Grounding (Nano Banana 2 전용): Google 이미지 검색의 시각적 컨텍스트
이러한 기능은 추가 Google Search API 요금이 필요하며 APIYI 포워딩에는 포함되지 않습니다.

인증

Authorization
string
header
필수

API Key obtained from APIYI Console

본문

application/json
contents
object[]
필수

Content array containing text prompts

generationConfig
object
필수

응답

Successfully generated image

candidates
object[]

Generation results array

usageMetadata
object