docs: openai.LLM vs openai.responses.LLM for HTTP OpenAI-compat hosts
メンテナーはふだん 1 日以内に返信
@AbarnaaSree がすでに取り組んでいます。
2026年8月29日 から。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 72/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 静か
- 技術スタック
- python, typescript
調査の方向性
この修正は文章によるもので、内容のほぼすべてはペイロードが提供する。つまり、汎用のHTTP OpenAI互換ホスト(PZERO、POST /v1/chat/completionsなど)は、WebSocketのResponsesパスを狙うopenai.responses.LLM()ではなく、base_url付きのopenai.LLM()を使わなければならないと明記する。まず、参照されているページがどこにあるかを確認する。リンク先のドキュメントはdocs.livekit.ioにあるので、このリポジトリがそのコンテンツを保持しているのか、それともドキュメントは別のドキュメントリポジトリに寄与する必要があるのかを調べる。ここにある場合は、docs/models/llm/openai-compatible-llms、または最も近い同等のページを出発点とする。完成の定義は、そのページにクラス選択に関する短い警告(issueに既に記載されているPythonおよびNodeのスニペット付き)が表示されることで、コードやヘルパーの変更は要求されていない。
索引モデルが issue の本文から書いたものです。
説明
Feature Type
Would make my life easier
Feature Description
LiveKit docs already cover custom base_url on openai.LLM() (Chat Completions). The trap is using openai.responses.LLM() against a host that only speaks HTTP Chat Completions / HTTP POST /v1/responses. The Responses helper is WebSocket-oriented and is the wrong class for a generic OpenAI-compat inference API.
PZERO is a live Chat Completions host (POST /v1/chat/completions). Public catalog: GET https://api.pzero.studio/v1/models. Default text id: deepseek-v4-flash. Prepaid Bearer key (pzero_…). Use chat openai.LLM(), not openai.responses.LLM(). Do not point STT or TTS at this host.
from livekit.plugins import openai
llm = openai.LLM(
model="deepseek-v4-flash",
base_url="https://api.pzero.studio/v1",
api_key="pzero_…",
)
Node:
import * as openai from '@livekit/agents-plugin-openai';
const llm = new openai.LLM({
model: 'deepseek-v4-flash',
baseURL: 'https://api.pzero.studio/v1',
apiKey: 'pzero_…',
});
Docs: https://docs.livekit.io/agents/models/llm/openai-compatible-llms/
No first-party with_pzero() helper asked.
Workarounds / Alternatives
The generic openai.LLM({ base_url }) constructor already works. This issue is the class-choice gotcha vs openai.responses.LLM().
Additional Context
PZERO POST /v1/responses exists over HTTP (401 without a key, not 404). That is not the LiveKit Responses WebSocket path.
- 主要言語
- Python
- スター
- 14.6k
- フォーク
- 3.9k
- 平均マージ
- 2日 7時間
- マージ済み PR(30日)
- 228
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
livekit/agents のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
メンテナーはふだん 1 日以内に返信
-
Assistant markup is stripped from chat history when expressive mode is off対応中かも @ShivamSharma43 が 21 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
livekit/agents#7647 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
Support CPython 3.15 in livekit-local-inference対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープン
難易度 5/5 1週間以上 初心者へのやさしさ 32/100
メンテナーはふだん 1 日以内に返信
-
難易度 4/5 1〜2日 初心者へのやさしさ 55/100
メンテナーはふだん 1 日以内に返信
-
OpenAI realtime: a long chat context sync or reconnect replay is sent in one event loop turn対応中かも @zek が今日担当しました。 オープン
難易度 3/5 1〜2日 初心者へのやさしさ 35/100
メンテナーはふだん 1 日以内に返信
似ている issue
-
app: scripts status: backlog type: documentation
難易度 2/5 1〜3時間 初心者へのやさしさ 86/100
netbox-community/netbox-scripts#68 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 91/100
marin-community/marin#10765 ·
メンテナーはふだん 1 日以内に返信
-
難易度 1/5 1時間未満 初心者へのやさしさ 70/100
flathub/com.unity.UnityHub#230 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
メンテナーはふだん 1 日以内に返信
-
namespace operations
難易度 1/5 1時間未満 初心者へのやさしさ 63/100
EclipseFdn/open-vsx.org#14910 ·
メンテナーはふだん 1 日以内に返信