AI 이미지 생성 API 문서 (v1)
이 엔드포인트는 보안 프록시 게이트웨이를 제공하여, 기본 서비스 제공업체 자격 증명을 노출하지 않고도 AI 이미지 생성 모델을 트리거할 수 있습니다.
1. 개요
2. 인증
모든 요청에는 무단 액세스를 방지하기 위해 HTTP 헤더에 보안 토큰이 포함되어야 합니다. 이 토큰은 관리자에게 문의하여 받아야 합니다.
3. 요청 매개변수
모든 매개변수는 JSON 요청 본문으로 전송되어야 합니다.
| 매개변수 | 타입 | 필수 | 설명 |
|---|
| 프롬프트 | 문자열 | 예 | 생성하려는 이미지에 대한 텍스트 설명입니다. |
| 크기 | 문자열 | 아니요 | 이미지 해상도. 기본값: 1024x1024지원되는 값: 256x256, 512x512, 1024x1024 |
| 생성할 이미지 수 | integer | 아니요 | 생성할 이미지 수. 기본값: 1권장 범위: 1–4 |
4. cURL 예시
5. JavaScript 예시
6. 응답 형식
7. 에러 응답
오류가 발생하면 API는 JSON 형식의 오류 메시지를 반환합니다.
8. 상태 코드
| 코드 | 의미 |
|---|
| 200 | 요청 성공 |
| 400 | 잘못된 요청 매개변수 |
| 403 | 유효하지 않거나 누락된 API 토큰 |
| 500 | 원격 AI 서비스 실패 또는 시간 초과 |