AI 이미지 생성 API 문서 (v1)

이 엔드포인트는 보안 프록시 게이트웨이를 제공하여, 기본 서비스 제공업체 자격 증명을 노출하지 않고도 AI 이미지 생성 모델을 트리거할 수 있습니다.

1. 개요

Endpoint URL

https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image

Method

POST

Content-Type

application/json

2. 인증

모든 요청에는 무단 액세스를 방지하기 위해 HTTP 헤더에 보안 토큰이 포함되어야 합니다. 이 토큰은 관리자에게 문의하여 받아야 합니다.

Header

X-Proxy-Token: YOUR_API_TOKEN_HERE

3. 요청 매개변수

모든 매개변수는 JSON 요청 본문으로 전송되어야 합니다.

매개변수	타입	필수	설명
프롬프트	문자열	예	생성하려는 이미지에 대한 텍스트 설명입니다.
크기	문자열	아니요	이미지 해상도. 기본값: `1024x1024`지원되는 값: `256x256`, `512x512`, `1024x1024`
생성할 이미지 수	integer	아니요	생성할 이미지 수. 기본값: `1`권장 범위: `1–4`

4. cURL 예시

curl https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Proxy-Token: YOUR_API_TOKEN_HERE" \
  -d '{
    "prompt": "A futuristic mechanical cat, photorealistic",
    "size": "1024x1024",
    "n": 1
  }'

5. JavaScript 예시

📄

const API_TOKEN = 'YOUR_API_TOKEN_HERE'; // Replace with your actual token

fetch('https://www.aigosearch.com/wp-json/my-proxy/v1/generate-image', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-Proxy-Token': API_TOKEN
    },
    body: JSON.stringify({
        "prompt": "A futuristic mechanical cat, photorealistic",
        "size": "1024x1024",
        "n": 1
    })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

6. 응답 형식

📄

5. Response Format

{
    "created": 1773223961,
    "data": [
        {
            "url": "https://example-image-url.com/generated.png"
        }
    ],
    "output_format": "png",
    "usage": {
        "total_tokens": 4182
    }
}

7. 에러 응답

오류가 발생하면 API는 JSON 형식의 오류 메시지를 반환합니다.

📋

{
  "error": {
    "message": "Invalid API token",
    "code": 403
  }
}

8. 상태 코드

코드	의미
200	요청 성공
400	잘못된 요청 매개변수
403	유효하지 않거나 누락된 API 토큰
500	원격 AI 서비스 실패 또는 시간 초과