認証
API キーを作成してリクエストごとに送り、スコープとエンドポイントを理解します。
API キー
コンソールで名前と有効期限（無期限も可）を指定してキーを作成します。新しいキーには標準 API 権限がすべて含まれ、サインイン後に再表示できます。キーをクライアント側のコードや公開リポジトリに含めないでください。
| 権限 | 許可される操作 |
|---|---|
jobs:create | タスクを送信 |
jobs:read | タスクのポーリングと一覧 |
media:write | 入力画像・動画のアップロード |
media:read | 結果ファイルのダウンロード |
usage:read | クレジットと取引履歴の読み取り |
chat:create | Call chat completions |
キーを送る
キーの送信方法： Authorization: Bearer <key> または x-api-key: <key> — 両方は使用しないでください。Web コンソールと Playground はサインイン中のセッションを使用します。
キーがない、または無効な場合は 401 AUTH_REQUIRED、必要な権限がないキーの場合は 403 INSUFFICIENT_SCOPE が返されます。
エンドポイント
| メソッド | パス | 用途 | 認証 |
|---|---|---|---|
GET | /api/v1/models | 公開モデルカタログの一覧 | 公開 |
GET | /api/v1/models/{slug} | 入力スキーマ付きのモデル 1 件 | 公開 |
GET | /api/v1/prices | 設定済みのタスク単位料金（USD マイクロ単位） | 公開 |
POST | /api/v1/media | 画像・動画のバイトをアップロードし、media:<uuid> を返す | media:write |
POST | /api/v1/jobs | 非同期モデルタスクを 1 件送信 | jobs:create |
GET | /api/v1/jobs/{id} | 1 件のタスクのステータスと結果をポーリング | jobs:read |
GET | /api/v1/jobs | 最新 100 件のタスク | jobs:read |
GET | /api/v1/results/{id} | 所有する結果ファイルをダウンロード | media:read |
GET | /api/v1/usage | クレジット残高と最近の取引履歴 | usage:read |
GET | /api/v1/chat/models | Callable chat models with token prices (OpenAI list format) | 公開 |
POST | /api/v1/chat/completions | OpenAI-compatible chat completion, billed per token | chat:create |
GET | /api/v1/chat/requests | Your chat requests with charges, limit (1–100) and before cursor | usage:read |
GET | /api/v1/chat/requests/{id} | One chat request belonging to your account | usage:read |
AI エージェント
AI エージェントはキーの代わりに MCP サーバー経由の OAuth でサインインできます。 MCP と Skill