Base URL
https://phantasia.app/api/v1모든 요청에 Authorization: Bearer pk_live_YOUR_KEY 헤더를 포함하세요.
Endpoints
GET
/api/v1/statusGET
/api/v1/generatePOST
/api/v1/generatePOST
/api/v1/transform코드 예제
curl -X POST https://phantasia.app/api/v1/generate \
-H "Authorization: Bearer pk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "sunset over Tokyo, golden hour",
"model": "flux-pro",
"style": "photorealistic",
"size": "16:9"
}'AI 모델 카탈로그
13개 모델 · 4계층 요금제. 일 50회는 무료, 초과 시 크레딧 차감.
| 모델 ID | 이름 | 제공사 | 티어 | 크레딧 | 속도 | 품질 |
|---|---|---|---|---|---|---|
cf-flux-schnell | FLUX.1 Schnell | cloudflare | 무료 | 무료 | ⚡ 빠름 | ★★★☆☆ |
cf-sdxl | Stable Diffusion XL | cloudflare | 무료 | 무료 | ⏱ 보통 | ★★★☆☆ |
flux-schnell | FLUX.1 Schnell | replicate | Standard | 1cr($0.01) | ⚡ 빠름 | ★★★☆☆ |
sdxl | Stable Diffusion XL | replicate | Pro | 2cr($0.02) | ⏱ 보통 | ★★★★☆ |
nanobanana | NanoBanana | nanobanana | Standard | 2cr($0.02) | ⚡ 빠름 | ★★★★☆ |
flux-pro | FLUX 1.1 Pro | replicate | Pro | 5cr($0.05) | 🐢 느림 | ★★★★★ |
gemini-imagen | Imagen 3 | Premium | 6cr($0.06) | ⏱ 보통 | ★★★★★ | |
nanobanana-pro | NanoBanana Pro | nanobanana | Premium | 7cr($0.07) | ⏱ 보통 | ★★★★★ |
dall-e-3 | DALL·E 3 | openai | Premium | 8cr($0.08) | ⏱ 보통 | ★★★★★ |
flux-pro-ultra | FLUX Pro Ultra | replicate | Premium | 10cr($0.10) | 🐢 느림 | ★★★★★ |
dall-e-3-hd | DALL·E 3 HD | openai | Premium | 12cr($0.12) | ⏱ 보통 | ★★★★★ |
스타일 목록
photorealisticanimewatercoloroilcyberpunkfantasydreamcartoonportraitproduct미지정 시 기본값: photorealistic
사이즈 옵션
1:1
1024×1024
16:9
1344×768
9:16
768×1344
4:3
1152×896
3:4
896×1152
연동 가이드
n8nHTTP Request 노드 → POST /api/v1/generate
Make (Integromat)HTTP 모듈 → POST Body JSON
ZapierWebhooks by Zapier → POST action
Python / Jupyterrequests.post() → plt.imshow()
에러 코드
| 401 | Unauthorized | API 키 없음 또는 형식 오류 |
| 402 | Payment Required | 크레딧 부족 (일 무료 한도 초과 후) |
| 403 | Forbidden | 무료 플랜으로 Pro 전용 모델 사용 시도 |
| 400 | Bad Request | prompt 미포함 또는 파라미터 오류 |
| 429 | Too Many Requests | 요청 속도 초과 |
| 503 | Service Unavailable | AI 제공사 일시 장애 |