OnigiriAPI
OnigiriAPIへようこそ。Onigiri3が提供するAPIはすべて完全無料でご利用いただけます。
制限はありません。
なんでかって？Onigiri3は制限が嫌いだからです。
まずはOnigiriAIから試してみましょう！
Available APIs
OnigiriAIv2
Ollamaと連携したチャット・ストリーミングAPI。モデル管理、会話履歴保存対応。
Add API
新しいAPIドキュメントはここに追加される。
OnigiriAIv2
OllamaベースのチャットAPI。ポーリング方式のストリーミング、会話履歴のJSON保存、モデル切り替えに対応。
Base: https://realtimeaiapi.onigiri3.comModels
GET
/api/ai/models
利用可能モデル一覧
Ollamaにインストールされているモデルの一覧を返す。
Response
// 200 OK
[
{ "name": "gemma4:e4b", "size": 4294967296, ... },
{ "name": "llama3:8b", ... }
]
Try it
Chat Management
POST
/api/ai/chats
チャット作成
新しい空のチャットを作成し、IDを返す。IDは現在時刻のUnixタイムスタンプ（ms）。
Response
// 200 OK
{ "id": "1749123456789" }
Try it
GET
/api/ai/chats/:id
チャット履歴取得
指定チャットのメッセージ履歴（role + content 配列）を返す。存在しない場合は空配列。
Path Parameters
| Name | Type | Description | |
|---|---|---|---|
| id | string | required | チャットID |
Response
// 200 OK
[
{ "role": "user", "content": "こんにちは" },
{ "role": "assistant", "content": "こんにちは！" }
]
Try it
:id
DELETE
/api/ai/chats/:id
チャット削除
指定チャットのJSONファイルを削除する。
Path Parameters
| Name | Type | Description | |
|---|---|---|---|
| id | string | required | チャットID |
Response
// 200 OK
{ "success": true }
Try it
:id
Messaging
POST
/api/ai/chats/:id/stream
ストリーミング送信 streaming
メッセージを送信してジョブIDを即座に返す。実際の生成はバックグラウンドで進行し、/job/:jobId をポーリングして結果を取得する。
Path Parameters
| Name | Type | Description | |
|---|---|---|---|
| id | string | required | チャットID |
Request Body
| Field | Type | Description | |
|---|---|---|---|
| message | string | required | 送信するメッセージ |
| model | string | optional | 使用モデル（省略時はサーバーのデフォルト） |
Response
// 200 OK — ジョブIDを即座に返す
{ "jobId": "lbz8hk3f2" }
Try it
:id
message
model
GET
/api/ai/chats/:id/job/:jobId
ジョブ状態取得
/stream で取得したjobIdをポーリングして、現在の生成テキストと完了フラグを取得する。
ジョブは完了後5分で自動削除される。
Path Parameters
| Name | Type | Description | |
|---|---|---|---|
| id | string | required | チャットID |
| jobId | string | required | ジョブID（/streamの戻り値） |
Response
// 200 OK — 生成中
{ "text": "こんに", "done": false, "error": null }
// 200 OK — 生成完了
{ "text": "こんにちは！何かお手伝いできますか？", "done": true, "error": null }
// 200 OK — エラー
{ "text": "", "done": true, "error": "❌ Ollama接続エラー: ..." }
Try it
:id
:jobId
POST
/api/ai/chats/:id/message
一括送信（後方互換）
メッセージを送信し、生成完了まで待機してから返す同期エンドポイント。レスポンスが遅いため、新規実装では /stream を推奨。
Request Body
| Field | Type | Description | |
|---|---|---|---|
| message | string | required | 送信するメッセージ |
| model | string | optional | 使用モデル |
Response
// 200 OK
{ "reply": "こんにちは！", "model": "gemma4:e4b" }
Try it
:id
message
model
Server Spec
GPU
RTX 2070
NVIDIA GeForce
VRAM
8 GB
GDDR6
RAM
192 GB
System Memory