OpenAI 兼容接口

彤鑫 OPC AI 系统提供与 OpenAI Chat Completions 接口对齐的封装，可直接替换 baseURL，沿用 OpenAI SDK。

1. BaseURL & 鉴权

baseURL: https://txopc.ai/v1
Authorization: Bearer <你的 PAT>

前往设置 → 个人访问令牌生成 PAT，权限选 chat.write。

2. 模型名映射

原始模型	OpenAI 别名	说明
`google/gemini-2.5-pro`	`gemini-2.5-pro`	顶配多模态 / 大上下文
`google/gemini-2.5-flash`	`gemini-2.5-flash`	性价比首选
`google/gemini-2.5-flash-lite`	`gemini-2.5-flash-lite`	极速极便宜
`openai/gpt-5`	`gpt-5`	最强推理
`openai/gpt-5-mini`	`gpt-5-mini`	推理 + 成本平衡
`openai/gpt-5-nano`	`gpt-5-nano`	高并发简单任务

3. 示例（Python）

from openai import OpenAI
client = OpenAI(base_url="https://txopc.ai/v1", api_key="txopc_pat_xxx")
r = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role":"user","content":"你好"}],
    stream=True,
)
for chunk in r:
    print(chunk.choices[0].delta.content or "", end="")

4. 计费

按实际 token 与模型单价从余额扣减，每次调用扣费明细可在充值与计费查看。

5. 错误码

401 PAT 无效 / 已撤销
402 余额不足，请先充值
429 触发限流，请退避重试
503 上游模型暂不可用