← 문서 목록

POST /v1/images/generations

이미지 생성. n 은 최대 10.

이미지 생성.

Parameters

ParameterTypeRequiredDescription
modelstringYesIMAGE 카테고리 모델 ID
promptstringYes1~4000자
nintegerNo생성할 이미지 수 1~10 (기본 1)
sizestringNo256x256 · 512x512 · 1024x1024(기본) · 1792x1024 · 1024x1792 · 1536x1024 · 1024x1536 · auto
qualitystringNostandard(기본) · hd · low · medium · high · auto — 백엔드별로 매핑되거나 무시됩니다
response_formatstringNourl(기본) · b64_json
userstringNo최종 사용자 식별자

모델별로 n 상한이 더 낮을 수 있습니다(Imagen 주의사항 참고). 사용 가능한 이미지 모델은 GET /v1/models 에서 categoryIMAGE 인 항목을 확인하세요.

Request

{
  "model": "<GET /v1/models 에서 확인한 IMAGE 모델 ID>",
  "prompt": "a beautiful sunset over mountains",
  "n": 1
}

Response

{
  "created": 1709884800,
  "data": [
    { "url": "https://..." }
  ]
}

url 은 10분 유효한 presigned URL 입니다. 오래 보관하려면 직접 내려받아 저장하세요. 만료된 뒤에는 GET /v1/outputs/{requestId} 로 24시간 안에 다시 발급받을 수 있습니다.