Skip to content
PleumRouter

Image Generation

이미지를 생성합니다. OpenAI Images API와 호환됩니다.

텍스트 프롬프트로 이미지를 생성합니다. OpenAI Images API와 호환되며, plm_로 시작하는 API 키로 인증합니다. 생성만 지원하며, 편집(edits)이나 변형(variations) 엔드포인트는 제공하지 않습니다.

POST/v1/images/generations

요청 본문#

파라미터타입필수설명
modelstring선택모델 ID. 기본값 dall-e-3.
promptstring필수생성할 이미지를 설명하는 텍스트. 최대 4,000자.
ninteger선택생성할 이미지 개수. 1 ~ 10. 기본값 1.
sizestring선택이미지 크기. 기본값 1024x1024.
response_formatstring선택url 또는 b64_json. gpt-image 계열 모델은 이 필드를 사용하지 않습니다.
request
curl https://router.pleum.ai/v1/images/generations \
  -H "Authorization: Bearer $PLEUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A red panda coding at a tiny laptop, watercolor style",
    "n": 1,
    "size": "1024x1024",
    "response_format": "url"
  }'

응답#

OpenAI 형식의 data 배열(각 항목에 url 또는 b64_json, 그리고 revised_prompt)에 더해, PleumRouter는 cost(원화 비용·환율·마크업)를 추가로 반환합니다.

200 OK
{
  "created": 1719446400,
  "data": [
    {
      "url": "https://.../img.png",
      "revised_prompt": "A red panda coding at a tiny laptop, watercolor style"
    }
  ],
  "model": "dall-e-3",
  "cost": {
    "usd": 0.04,
    "krw": 55,
    "fx_rate": 1380.0,
    "markup_rate": 3.0
  }
}

과금 방식#

과금은 생성된 이미지 한 장당 이루어집니다. 즉 n을 늘리면 비용도 그에 비례해 증가합니다. 응답의 cost는 해당 호출에서 생성된 전체 이미지의 합산 비용입니다.

url로 반환된 이미지 링크는 일정 시간 후 만료됩니다. 보관이 필요하면 받은 뒤 직접 저장하거나 b64_json으로 요청하세요.