OpenAI compatible プロトコル
/v1 Base URL で OpenAI compatible クライアントを接続します。
主なエンドポイント
このページでは OpenAI compatible のテキスト、Responses、画像、動画タスク、音声、ベクトル、モデレーション、リアルタイム endpoint を一覧します。動画パラメータとポーリング手順は別ガイドにあり、利用可否はモデルと Key グループによって異なります。
モデルと探索
| 用途 | メソッド | パス |
|---|---|---|
| モデル一覧 | GET | /v1/models |
テキストとレスポンス
| 用途 | メソッド | パス |
|---|---|---|
| テキスト補完（旧形式） | POST | /v1/completions |
| チャット補完 | POST | /v1/chat/completions |
| Responses | POST | /v1/responses |
| Responses 圧縮 | POST | /v1/responses/compact |
画像
| 用途 | メソッド | パス |
|---|---|---|
| 画像生成 | POST | /v1/images/generations |
| 画像編集 | POST | /v1/images/edits |
動画タスク
| 用途 | メソッド | パス |
|---|---|---|
| 動画タスク作成 | POST | /v1/videos |
| 動画タスク状態取得 | GET | /v1/videos/{task_id} |
| 動画コンテンツ取得 | GET | /v1/videos/{task_id}/content |
| 動画生成タスク作成（互換） | POST | /v1/video/generations |
| 動画生成タスク状態取得（互換） | GET | /v1/video/generations/{task_id} |
音声
| 用途 | メソッド | パス |
|---|---|---|
| 音声文字起こし | POST | /v1/audio/transcriptions |
| 音声翻訳 | POST | /v1/audio/translations |
| テキスト読み上げ | POST | /v1/audio/speech |
ベクトルと検索
| 用途 | メソッド | パス |
|---|---|---|
| テキスト埋め込み | POST | /v1/embeddings |
| 文書リランキング | POST | /v1/rerank |
安全性とリアルタイム
| 用途 | メソッド | パス |
|---|---|---|
| コンテンツモデレーション | POST | /v1/moderations |
| Realtime (WebSocket) | GET | /v1/realtime |
最小リクエスト
クライアントの Base URL は通常 https://api.popgo.site/v1、認証は Authorization: Bearer YOUR_API_KEY です。モデルページの ID で YOUR_MODEL を置き換え、対象 endpoint に対応することを確認してください。
curl https://api.popgo.site/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL",
"messages": [
{"role": "user", "content": "接続を確認してください"}
]
}'
確認
ストリーミング、ツール、画像、音声オプションを有効にする前に、最小リクエストでモデルとプロトコルを確認します。404 では /v1 の二重追加を、400 では endpoint の対応を確認してください。