Skip to main content
POST
플레이그라운드
API 키와 프롬프트를 입력한 다음 전송합니다. 그러면 실제 API가 호출됩니다. 코드에서 호출하는 것과 동일한 엔드포인트입니다.
이 페이지에서 전송하는 요청은 실제 요청이며 사용자의 키에 과금됩니다. 1K 이미지 1개는 모델에 따라 약 $0.02–0.09입니다. 이곳의 어떤 것도 샌드박스나 모의 환경이 아닙니다.

매개변수

string
필수
실행할 모델입니다. gemini-3-pro-image 또는 gemini-3.1-flash-image을 허용하며, 정확히 일치해야 합니다. 별칭과 -preview 접미사는 허용되지 않습니다.
object
필수
생성 매개변수입니다. 아래에 나열되지 않은 키는 invalid_params와 함께 거부됩니다.
string
완료된 작업을 POST할 https URL이므로 폴링을 생략할 수 있습니다. 반드시 https이어야 하며, 그 외의 값은 제출 시 거부됩니다.

반환되는 내용

제출 요청은 1초도 걸리지 않아 즉시 반환됩니다. 이미지가 이 응답에 포함되는 것은 아닙니다 — 생성은 백그라운드에서 진행됩니다.

그런 다음 이미지 상태를 폴링합니다

이 플레이그라운드는 생성 호출만 다룹니다. 위 응답에서 id를 가져온 다음 statuscompleted 또는 failed에 도달할 때까지 작업을 조회합니다. 1K 이미지의 경우 15~40초가 걸릴 것으로 예상됩니다.
완료된 작업에는 이미지 URL의 outputs 배열이 포함됩니다.
출력 URL은 인증되지 않으며 작업 생성 후 24시간이 지나면 만료됩니다. 이미지를 다운로드할 때는 User-Agent 헤더를 전송해야 합니다. 전송 CDN은 헤더가 없는 요청에 대해 본문이 없는 403을 반환합니다.

다음 단계

개요

해당 시리즈의 모든 매개변수, 해상도 등급 및 측정된 지연 시간입니다.

비동기 작업 API

폴링 루프, 콜백 및 전체 오류 표입니다.