从 OpenAI SDK 迁移

保留 SDK 的 OpenAI 兼容请求结构，把 Base URL 指向 AI Credits 数据 API，并从环境读取 Key。AICredits API Key 不是其他模型服务的官方 Key。模型必须来自 /v1/models，不要假定某个模型始终可用。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AICREDITS_API_KEY"],
    base_url=os.environ["API_BASE_URL"].rstrip("/") + "/v1",
)
response = client.chat.completions.create(
    model=os.environ["MODEL"],
    messages=[{"role": "user", "content": "<YOUR_PROMPT>"}],
)

迁移时同时检查流式、重试和限速策略。不要在异常上报中附带 Prompt、Response 或 Key。

Responses 与多模型调用

公开目录的 protocols 必须包含所用入口：Chat 使用 openai_chat_completions，Responses 使用 openai_responses。Claude 的 Chat / Responses 兼容已实现，Gemini、Grok 等模型也只按已声明协议调用，不能根据模型系列推断支持。

response = client.responses.create(
    model=os.environ["MODEL"],
    input="<YOUR_PROMPT>",
)

HTTP Responses 不接受 previous_response_id；多轮输入须显式携带上下文。流式 Responses 使用命名事件，以 response.completed 等终态判断结果，不等待 Chat 的 [DONE]。工具定义、工具结果和多模态输入按所选协议传递；升级后先验证业务实际使用的参数。

本页示例使用 OpenAI SDK，Base URL 含 /v1；AICredits 官方 GatewayClient 则使用不带后缀的根地址。第三方 SDK 的自动重试应按幂等规则配置。

迁移到 DeepSeek、Kimi、MiniMax 或 GLM

OpenAI Chat 请求形态可用于这些系列已公开的兼容模型；必须选择目录中的精确 ID。不要将 GLM 迁移到 Responses，当前应使用 Chat 或 Messages。多轮工具调用需保留完整 assistant 消息的 reasoning_content、tool_calls 和可空 content。参数差异与可运行示例见中国大模型接入。