流式和非流式呼叫有什麼區別？

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.apiyi.com/v1",
)

stream = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "介紹一下量子計算"}],
    stream=True,
    stream_options={"include_usage": True},   # 不加這行拿不到 usage
    timeout=120,
)

chunks = []
for chunk in stream:
    # 末尾的 usage chunk 裡 choices 是空陣列，必須先判空
    if chunk.choices and chunk.choices[0].delta.content:
        piece = chunk.choices[0].delta.content
        chunks.append(piece)
        print(piece, end="", flush=True)
    if chunk.usage:
        print(f"\n用量：{chunk.usage.total_tokens} tokens")

full_text = "".join(chunks)   # 需要全文時自己拼

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://api.apiyi.com/v1",
});

const stream = await client.chat.completions.create({
  model: "gpt-5.4",
  messages: [{ role: "user", content: "介紹一下量子計算" }],
  stream: true,
  stream_options: { include_usage: true },
});

let full = "";
for await (const chunk of stream) {
  const delta = chunk.choices?.[0]?.delta?.content;
  if (delta) {
    full += delta;
    process.stdout.write(delta);
  }
  if (chunk.usage) console.log("\n用量：", chunk.usage.total_tokens);
}

# 非流式：一個完整 JSON
curl https://api.apiyi.com/v1/chat/completions \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "你好"}]
  }'

# 流式：一連串 data: 塊，最後是 data: [DONE]
# -N 關閉 curl 自己的緩衝，否則看起來還是"一次性出來的"
curl -N https://api.apiyi.com/v1/chat/completions \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true,
    "stream_options": {"include_usage": true}
  }'