拿 API Key
登入 Console → API Keys 建立一把金鑰。pk_live 用於前端,sk_live 用於伺服器端。
送一個請求
把 prompt 與通道 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 | 影像生成(帶 model slug) |
| GET | /v1/tasks/{task_id} | 查詢任務狀態與結果 |
| GET | /v1/models | 列出可用通道與點數 |
| GET | /v1/account/balance | 查詢 Prisms 餘額(免費桶 + 購買桶) |
可用通道 slug
把 model 換成下面任一 slug,即可切換背後的 AI 通道。完整清單與健康度見 Models 頁。
| slug | 模態 | 每次 | 狀態 |
|---|---|---|---|
| forge-v8 | IMAGE | 10 Prisms | healthy |
| forge-v7 | IMAGE | 8 Prisms | healthy |
| forge-v6 | IMAGE | 6 Prisms | healthy |
| prism-type | IMAGE | 6 Prisms | degraded |
| lumen-pro | TEXT | 2 Prisms | healthy |
| lumen-lite | TEXT | 1 Prisms | healthy |
| prism-art | IMAGE | 5 Prisms | healthy |
| lumen-flash | TEXT | 1 Prisms | healthy |
| lumen-max | TEXT | 3 Prisms | healthy |
| prism-hd | IMAGE | 5 Prisms | healthy |