이미지 생성.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | IMAGE 카테고리 모델 ID |
prompt | string | Yes | 1~4000자 |
n | integer | No | 생성할 이미지 수 1~10 (기본 1) |
size | string | No | 256x256 · 512x512 · 1024x1024(기본) · 1792x1024 · 1024x1792 · 1536x1024 · 1024x1536 · auto |
quality | string | No | standard(기본) · hd · low · medium · high · auto — 백엔드별로 매핑되거나 무시됩니다 |
response_format | string | No | url(기본) · b64_json |
user | string | No | 최종 사용자 식별자 |
모델별로 n 상한이 더 낮을 수 있습니다(Imagen 주의사항 참고).
사용 가능한 이미지 모델은 GET /v1/models 에서 category 가 IMAGE 인 항목을 확인하세요.
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시간 안에 다시 발급받을 수 있습니다.