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

코드 예제

Python

cURL

Node.js

파라미터 빠른 참조

자세한 파라미터 문서, 허용되는 값 및 기본값은 오른쪽 Playground의 필드 설명을 참조하십시오. 모든 enum 유형 필드(aspectRatio, imageSize, thinkingLevel 등)는 드롭다운 선택을 지원하므로 직접 입력할 필요가 없습니다.
Google Search 그라운딩: 요청 최상위 수준에 "tools": [{"googleSearch": {}}]를 추가하십시오. 각 검색 쿼리마다 $0.014가 추가로 과금되며, 실행할 쿼리 수는 모델이 결정합니다. Nano Banana 2.1 개요를 참조하십시오.

인증

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