長文輸出實戰建議

import json
import httpx

def generate_long_text(prompt, api_key, model="claude-opus-5", max_tokens=64000):
    url = "https://api.apiyi.com/v1/messages"
    headers = {
        "x-api-key": api_key,
        "anthropic-version": "2023-06-01",
        "content-type": "application/json",
        "accept": "text/event-stream",
    }
    payload = {
        "model": model,
        "max_tokens": max_tokens,
        "stream": True,                        # ← 關鍵：長輸出必須流式
        "thinking": {"type": "adaptive"},      # 自適應思考，模型自行決定思考深度
        "messages": [{"role": "user", "content": prompt}],
    }
    # 三段式超時：read 只覆蓋事件間隔，不覆蓋整段生成
    timeout = httpx.Timeout(connect=30, write=120, read=120, pool=30)

    text, stop_reason = [], None
    with httpx.Client(timeout=timeout) as c:
        with c.stream("POST", url, json=payload, headers=headers) as r:
            if r.status_code != 200:
                raise RuntimeError(f"HTTP {r.status_code}: {r.read()[:400]}")
            event, data = None, []
            for line in r.iter_lines():
                if line == "":                 # 事件以空行分隔
                    if data:
                        d = json.loads("\n".join(data))
                        t = d.get("type") or event
                        if t == "content_block_delta" and d.get("delta", {}).get("type") == "text_delta":
                            text.append(d["delta"]["text"])
                        elif t == "message_delta":
                            stop_reason = d.get("delta", {}).get("stop_reason") or stop_reason
                    event, data = None, []
                    continue
                if line.startswith("event:"):
                    event = line[6:].strip()
                elif line.startswith("data:"):
                    data.append(line[5:].strip())
    # Claude 流以 message_stop 結束，沒有 [DONE]
    if stop_reason == "max_tokens":
        raise RuntimeError(f"被 max_tokens 截斷，已產出 {len(''.join(text))} 字，調大 max_tokens 後重試")
    return "".join(text).strip()

# connect：建連；write：上行發請求體；read：兩次讀之間的上限
timeout = httpx.Timeout(connect=30, write=120, read=120, pool=30)