개발가이드

  • 개발가이드

AI 이미지 생성

텍스트 프롬프트로 1024×1024 이미지를 생성합니다. 초고속 시안부터 스튜디오급 완성본까지 5단계 모델을 제공하며 1장 단위 고정 포인트로 과금합니다.

엔드포인트

Method
URL
POST
https://apick.app/rest/image-generation/models
POST
https://apick.app/rest/image-generation/generate

모델 목록은 비로그인·무료이며, 이미지 생성은 로그인 세션 또는 CL_AUTH_KEY가 필요합니다.

모델·요금

등급
model
가격
LV.1 라이트
black-forest-labs/FLUX-1-schnell
2P
LV.2 스피드
PrunaAI/p-image
23P
LV.3 밸런스
black-forest-labs/FLUX-2-dev
45P
LV.4 프로
black-forest-labs/FLUX-2-klein-9b
68P
LV.5 스튜디오
black-forest-labs/FLUX-1.1-pro
180P

모든 가격은 1024×1024 이미지 1장 기준이며, 공급 원가 대비 매출총이익률 50~70% 범위로 책정됩니다. 실제 최신 값은 /rest/image-generation/models 응답을 사용하세요.

요청

이름
타입
필수
설명
model
String
O
모델 목록 응답의 id
prompt
String
O
생성할 장면 설명, 최대 3,000자

size는 1024×1024, n은 1, 응답 형식은 base64로 서버에서 고정합니다. 클라이언트가 다른 값을 보내도 적용되지 않습니다.

axios 예시

import axios from 'axios';

const { data: result } = await axios.post(
  'https://apick.app/rest/image-generation/generate',
  {
    model: 'black-forest-labs/FLUX-2-dev',
    prompt: 'A cinematic product photo, soft daylight'
  },
  { headers: { CL_AUTH_KEY: 'YOUR_KEY' } }
);

const image = result.data.images[0];
const dataUrl = `data:${image.mime_type};base64,${image.b64_json}`;

응답·오류

HTTP
의미
200
생성·과금 성공. data.images[0].b64_json과 api.cost 반환
400
모델 또는 prompt 형식 오류
401
로그인 또는 API 키 인증 필요
402
포인트 잔액 부족 또는 차감 실패
502
이미지 생성 처리 서비스 응답 오류. retryable 확인 후 재시도
현재 페이지 북마크