API キーを取得する
コンソールにログイン → API Keys でキーを作成します。pk_live はフロントエンド用、sk_live はサーバーサイド用です。
1つのリクエストを送る
プロンプトとチャネルの 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 | モダリティ | 1回あたり | ステータス |
|---|---|---|---|
| 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 | 低下 |