Skip to main content
POST
중국 본토 사용자 안내: Base URL로 https://toapis.cn을 사용하세요. 아래 예제의 https://toapis.com을 https://toapis.cn으로 바꾸세요.

모델 선택

두 모델은 동일한 엔드포인트와 요청 매개변수를 사용합니다. model 필드로 버전을 선택하세요. 텍스트 기반 이미지 생성과 이미지 편집을 지원합니다. 요청은 비동기로 실행되며, 제출 후 반환된 작업 ID로 결과를 조회합니다.
image_urls는 공개적으로 접근 가능한 이미지 URL만 허용하며 base64 데이터는 지원하지 않습니다. 로컬 이미지는 먼저 이미지 업로드 API로 업로드하여 URL을 받으세요.

인증

string
필수
모든 요청에 Bearer Token이 필요합니다. API Key 관리 페이지에서 API Key를 받으세요.

요청 매개변수

string
기본값:"gemini-nano-banana-2.1"
필수
모델 이름. gemini-nano-banana-2.1 또는 gemini-nano-banana-2.1-vip를 사용합니다.
string
필수
이미지 생성 또는 편집을 위한 텍스트 설명.
string
출력 이미지의 가로세로 비율. 지원하는 값:
  • 1:1
  • 3:2, 2:3
  • 4:3, 3:4
  • 16:9, 9:16
  • 5:4, 4:5
  • 21:9
  • 1:4, 4:1
  • 1:8, 8:1
integer
기본값:1
출력 수는 숫자 1로 고정됩니다. 문자열 "1"을 사용하지 마세요.
string[]
이미지 생성이나 편집에 사용할 참조 이미지 URL 문자열 배열. 최대 14개. 각 URL은 공개적으로 접근 가능해야 합니다. 참조 이미지 수는 출력 이미지 수와 다릅니다.이미지당 최대 10MB. 지원 형식: .jpeg, .jpg, .png, .webp.
object
추가 설정 매개변수.

응답 필드

string
작업 상태와 결과를 조회하는 작업 ID.
string
항상 generation.task.
string
요청에 사용된 모델 ID.
string
작업 상태: queued, in_progress, completed, failed.
integer
작업 진행률. 범위: 0-100.
integer
작업 생성 시간. 초 단위 Unix 타임스탬프.
object
작업 메타데이터.

결과 조회

제출 응답의 id가 작업 ID입니다. 이미지 작업 상태 API에서 상태와 최종 이미지를 조회하세요. 비동기 알림은 작업 Webhook을 참고하세요.