이미지 API

텍스트 프롬프트로 이미지를 생성합니다. 모델에 따라 동기 또는 비동기(task_id 반환)로 동작합니다.

엔드포인트

POST/api/v1/images/generations

공통 요청 파라미터

이름	타입	필수	설명	기본값
`model`*	string	* 필수	사용할 이미지 모델 ID	-
`prompt`*	string	* 필수	이미지 설명 프롬프트. 구체적으로 작성할수록 좋은 결과를 얻습니다.	-
`size`	string	선택	이미지 크기. 모델에 따라 지원 크기가 다릅니다. `1024x10241024x17921792x10242048x2048`	`1024x1024`
`quality`	string	선택	이미지 품질. hd는 더 세밀하지만 생성 시간이 길어집니다. `standardhd`	`standard`
`n`	number	선택	생성할 이미지 수	`1`
`response_format`	string	선택	응답 형식. url은 임시 URL, b64_json은 Base64 인코딩된 이미지 데이터를 반환합니다. `urlb64_json`	`url`

응답 필드

이름	타입	필수	설명	기본값
`created`*	number	* 필수	생성 타임스탬프 (Unix epoch)	-
`data`*	array	* 필수	생성된 이미지 배열. 각 항목에 url 또는 b64_json을 포함합니다.	-
`task_id`	string	선택	비동기 처리 시 반환되는 작업 ID. /api/v1/tasks/:taskId로 상태를 조회합니다.	-

코드 예제

curl -X POST https://api.billing-ai.kr/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "서울 남산타워의 가을 풍경, 수채화 스타일",
    "size": "1024x1024",
    "quality": "hd"
  }'