// 标准大模型 API 调用（OpenAI 兼容格式，Python 示例）
// import requests
//
// response = requests.post(
//     "https://ark.cn-beijing.volces.com/api/v3/chat/completions",  # 豆包火山方舟的 endpoint
//     headers={
//         "Content-Type": "application/json",
//         "Authorization": "Bearer ark-your-api-key-here"  # 替换成你的密钥
//     },
//     json={
//         "model": "doubao-seed-2-1-turbo-260628",  # 模型 ID
//         "messages": [  # 对话消息列表，按时间顺序
//             {"role": "system", "content": "你是一个耐心的 Python 编程老师，用简洁易懂的语言回答问题。"},
//             {"role": "user", "content": "什么是列表推导式？给我一个例子。"},
//             # {"role": "assistant", "content": "..."}  # AI 的回复，可以继续追加形成多轮对话
//         ],
//         "temperature": 0.7,       # 随机性：0=确定性，1=最随机，创意写作0.8，代码0.2
//         "max_tokens": 2000,       # 最大生成 token 数
//         "stream": False,           # 是否流式输出
//     }
// )
//
// result = response.json()
// answer = result["choices"][0]["message"]["content"]
// usage = result["usage"]  # {"prompt_tokens": 50, "completion_tokens": 120, "total_tokens": 170}
// print(answer)
// print(f"消耗: {usage}")

// 流式输出实现（SSE，Python FastAPI 示例）
// from fastapi import FastAPI
// from fastapi.responses import StreamingResponse
// import requests, json
//
// app = FastAPI()
//
// @app.post("/api/ai/chat")
// async def chat(request: dict):
//     messages = request["messages"]
//     
//     def generate():
//         resp = requests.post(
//             "https://ark.cn-beijing.volces.com/api/v3/chat/completions",
//             headers={"Authorization": "Bearer ark-your-key"},
//             json={
//                 "model": "doubao-seed-2-1-turbo-260628",
//                 "messages": messages,
//                 "stream": True,  # 关键：开启流式
//             },
//             stream=True  # requests 流式读取
//         )
//         for line in resp.iter_lines():
//             if line:
//                 line = line.decode("utf-8")
//                 if line.startswith("data: "):
//                     data = line[6:]
//                     if data == "[DONE]":  # 流结束标记
//                         break
//                     chunk = json.loads(data)
//                     delta = chunk["choices"][0]["delta"]
//                     if "content" in delta:
//                         yield delta["content"]  # 逐字推给前端
//     
//     return StreamingResponse(generate(), media_type="text/event-stream")
//
// 前端用 EventSource 或 fetch + ReadableStream 接收，逐字追加到页面

// 正确架构：后端代理（Key 只存在服务器）
//
// 前端 App ──请求──▶ 你的后端服务器 ──带Key调用──▶ 大模型 API
//                       (Key存在环境变量/密钥管理服务)
//
// 前端只知道你的后端地址，不知道大模型 Key
// 后端验证用户身份/限流/计费后，用自己的 Key 调用大模型
// 大模型的响应通过后端返回给前端
//
// 环境变量（.env，不进 Git）：
// ARK_API_KEY=ark-your-secret-key-here
// ARK_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
// ARK_MODEL=doubao-seed-2-1-turbo-260628
//
// 后端代码读取环境变量：
// const apiKey = process.env.ARK_API_KEY;  // 从环境变量读，不写死在代码里