ストリーミングレスポンス
ストリーミングでは、モデルのせいせいちゅうにアウトプットをリアルタイムでうけとれます。ユーザーたいけんとたいかんそくどがよくなります。
しくみ#
诺玛AI は Server-Sent Events (SSE) でストリーミングレスポンスをおこないます:
- クライアントがリクエストをおくるとき `stream: true` をせっていする
- サーバーはせいせいされたコンテンツの chunk をだんかいてきにかえします
- それぞれの chunk は `data: ` プレフィックスつきで SSE によりおくられます
- せいせいがおわると `data: [DONE]` がそうしんされます
OpenAI プロトコルストリーミング#
cURL
コード
curl https://as.apinoma.com/v1/chat/completions \
-H "Authorization: Bearer $APINOMA_API_KEY" \
-H "Content-Type: application/json" \
-N \
-d '{
"model": "openai/gpt-4o",
"messages": [{"role": "user", "content": "プログラミングについての詩を書いて"}],
"stream": true
}'Python
TypeScript
Anthropic プロトコルストリーミング#
Python
コード
import anthropic
client = anthropic.Anthropic(
base_url="https://as.apinoma.com/anthropic",
api_key="<あなたの APINOMA_API_KEY>"
)
with client.messages.stream(
model="anthropic/claude-sonnet-4.6",
max_tokens=1024,
messages=[{"role": "user", "content": "プログラミングについての詩を書いて"}]
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)TypeScript
Streaming + Function Calling#
ストリーミングは Function Calling にもたいおうします。モデルはまずツールコールリクエストをストリームし、あなたがしょりしたあと、かいわをつづけます:
コード
stream = client.chat.completions.create(
model="openai/gpt-4o",
messages=[{"role": "user", "content": "東京の今日の天気はどうですか?"}],
tools=[{
"type": "function",
"function": {
"name": "get_weather",
"description": "指定した都市の天気を取得します",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "都市名"}
},
"required": ["city"]
}
}
}],
stream=True
)
for chunk in stream:
delta = chunk.choices[0].delta
if delta.tool_calls:
# ツール呼び出しを処理
print(f"ツール呼び出し: {delta.tool_calls[0].function}")
elif delta.content:
print(delta.content, end="", flush=True)エラーしょりとさいせつぞく#
ストリーミングせつぞくはネットワークのもんだいでとぎれることがあります。さいせつぞくロジックをじっそうしてください。
コード
import time
def stream_with_retry(client, max_retries=3, **kwargs):
for attempt in range(max_retries):
try:
stream = client.chat.completions.create(stream=True, **kwargs)
for chunk in stream:
yield chunk
return # 正常に完了
except Exception as e:
if attempt < max_retries - 1:
wait = 2 ** attempt # 指数バックオフ
print(f"\n接続が中断されました。{wait}s 後に再試行します...")
time.sleep(wait)
else:
raise eベストプラクティス#
- かならずタイムアウトをせってい — むげんまちをさける
- ふかんぜんな chunk をしょり — content がない chunk もあります
- さいせつぞくをじっそう — exponential backoff をつかう
- フロントエンドで `flush` をつかう — コンテンツをすぐひょうじする
さいしゅうこうしん: 2026 ねん 6 がつ 23 にち