메인 콘텐츠로 건너뛰기
POST
Text-to-Image: Generate an image from a text prompt
오른쪽의 대화형 플레이그라운드에서는 매개변수(가로세로 비율, 해상도, 응답 유형 등)를 드롭다운에서 선택할 수 있습니다. Authorization 필드에 API 키(형식: 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

매개변수 빠른 참조

자세한 매개변수 문서, 허용되는 값 및 기본값은 오른쪽 플레이그라운드의 필드 설명을 참조하십시오. aspectRatio, imageSize, thinkingLevel와 같은 모든 열거형 필드는 드롭다운 선택을 지원하므로 직접 입력할 필요가 없습니다.
Google 검색 기반: 요청의 최상위 수준에 "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