APIリファレンス
対応する公開推論エンドポイントとリクエストフィールド。機械可読スキーマはOpenAPI文書をダウンロードしてください。
エンドポイント
| メソッド | パス | 目的 |
|---|---|---|
| GET | /v1/models | 有効な承認済みモデルを一覧表示。 |
| GET | /v1/models/{model_id} | 承認済みモデルを1つ取得。 |
| POST | /v1/chat/completions | JSONの生成結果またはSSEストリームを取得します。 |
| GET | /health | Workerの稼働状態。 |
| GET | /ready | データベースと推論の準備状態。 |
チャットリクエスト
POST /v1/chat/completions
curl "https://uncensoredlabs.dev/v1/chat/completions" \
-H "Authorization: Bearer $UNCENSOREDLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_APPROVED_MODEL_ID","messages":[{"role":"user","content":"Hello"}],"max_tokens":256}'モデルIDとメッセージが必要です。max_tokensとmax_completion_tokensのどちらか一方を指定してください。チャットリクエストは4 MiBまでで、入力コンテキストとツールの上限はプロバイダーが適用します。
応答
通常の呼び出しはOpenAI互換のチャット生成結果を返します。ストリーミングは data: [DONE] で終わるSSEデルタを返します。最終精算前に使用量の確認が必要です。
| ヘッダー / フィールド | 目的 |
|---|---|
| 認可 | アプリ用Bearerキー。 |
| Content-Type | リクエストにはapplication/json。 |
| Idempotency-Key | 任意の重複防止参照。 |
| x-request-id | 調査用の応答参照。 |
| usage | 精算に使う提供元のトークン数。 |
稼働状態と準備状態
GET /health は稼働を確認します。GET /ready は依存関係と推論準備も確認し、サービス停止中や公開条件未達では503を返す場合があります。Workerの正常稼働だけでは実推論の有効化は確認できません。