API 키 발급
콘솔 → API Keys에 로그인해 키를 생성하세요. pk_live는 프런트엔드용, sk_live는 서버용입니다.
하나의 요청 전송
프롬프트와 채널 slug를 허브 진입점으로 보내세요. 허브가 모달리티와 상태에 따라 자동으로 분배합니다.
결과 / 측정 수신
결과와 소비된 Prisms를 반환합니다. 채널이 실패하면 자동으로 재라우팅됩니다 — 투명한 측정.
최소 요청 · curl
실행 가능한 최소한의 이미지 생성 요청입니다. YOUR_API_KEY를 본인의 키로 바꾸기만 하면 됩니다.
curl -X POST https://api.refractnest.dev/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "forge-pro",
"prompt": "a cozy pixel-art control tower at sunrise",
"n": 1
}'
응답 (200)
{
"task_id": "t_9af31c",
"model": "forge-pro",
"status": "done",
"cost_prisms": 8,
"data": [{ "url": "https://cdn.refractnest.dev/o/9af31c.png" }]
}엔드포인트
| 메서드 | 엔드포인트 | 용도 |
|---|---|---|
| POST | /v1/images/generations | 이미지 생성 (모델 slug 포함) |
| GET | /v1/tasks/{task_id} | 작업 상태 및 결과 조회 |
| GET | /v1/models | 사용 가능한 채널 및 Prisms 목록 |
| GET | /v1/account/balance | Prisms 잔액 조회 (무료 + 구매 버킷) |
사용 가능한 채널 slug
model을 아래의 slug로 바꾸면 그 뒤의 AI 채널을 전환할 수 있습니다. 전체 목록과 상태는 다음에서 확인하세요 Models 페이지。
| slug | 모달리티 | 회당 | 상태 |
|---|---|---|---|
| forge-v8 | IMAGE | 10 Prisms | 정상 |
| forge-v7 | IMAGE | 8 Prisms | 정상 |
| forge-v6 | IMAGE | 6 Prisms | 정상 |
| prism-type | IMAGE | 6 Prisms | 성능 저하 |
| lumen-pro | TEXT | 2 Prisms | 성능 저하 |
| lumen-lite | TEXT | 1 Prisms | 성능 저하 |
| prism-art | IMAGE | 5 Prisms | 성능 저하 |
| lumen-flash | TEXT | 1 Prisms | 성능 저하 |
| lumen-max | TEXT | 3 Prisms | 성능 저하 |
| prism-hd | IMAGE | 5 Prisms | 성능 저하 |