用 OpenAI 兼容接口开发 Agent

当前可用的推荐模型

按 Agent 场景挑的：工具调用稳定、支持结构化输出，上下文足够多轮累积。多轮循环的成本会随轮数线性涨，先用便宜的跑通流程，再换强模型看效果。

价格为平台价，每百万 tokens，按实际用量计费；列表随定价接口实时变化，下架的模型不会出现在这里。点一个模型，下面的配置和费用都会按它生成。

精确配置

下面的配置已经填好 API 地址和当前选中的模型 qwen3.8-max，只需换成你自己的 Key。

from openai import OpenAI

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

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {"type": "object", "properties": {"city": {"type": "string"}}, "required": ["city"]},
    },
}]

resp = client.chat.completions.create(
    model="qwen3.8-max",
    messages=[{"role": "user", "content": "What is the weather in Shanghai today?"}],
    tools=tools,
    tool_choice="auto",
)
call = resp.choices[0].message.tool_calls[0]
print(call.function.name, call.function.arguments)

OpenAI SDK · Python 完整接入文档 →

先跑通一条请求

把 Key 换掉，在终端原样执行。返回 200 说明地址、Key、模型三项都对；报错对照下面的常见错误。

curl https://token.easyapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3.8-max","messages":[{"role":"user","content":"Hello"}]}'

能力边界

• tools、tool_choice、stream、response_format 这些参数原样透传给上游，不同模型对参数的支持程度不同，模型详情页的参数表写了哪些生效。
• 多轮 Agent 的 messages 会越滚越长，上下文窗口是硬上限；请求超过模型上下文会直接报错，而不是自动截断。
• 同一个 Key 高并发时注意 429：平台限流与你的额度耗尽都返回 429，错误信息里会写明是哪一种。
• 用 models 回退序列和 provider.sort 可以在请求里声明备用模型和路由偏好，上游故障时自动切换，详见 API 文档。

常见错误

tool_calls 为空，模型用文字回答了

多半是模型不支持工具调用，或者 tool_choice 没设。换一个推荐列表里的模型，并把 tool_choice 设成 auto 或指定函数。

流式输出收不到 delta

确认请求里 stream 为 true，并且客户端没有缓冲；用 curl 加 -N 参数直接看原始 SSE 能快速定位。

返回 JSON 解析失败

用 response_format 指定 json_object 或 json_schema，并在系统提示里说明只输出 JSON；没有 response_format 的模型靠提示词约束不保证稳定。

429 Too Many Requests

看错误信息：insufficient quota 是余额不足，去充值；rate limit 是并发超了，降低并发或分散到多把 Key。

费用样例

按 qwen3.8-max 的当前价格，一次典型请求 6,000 输入 + 800 输出 tokens，每天 2,000 次：

只按实际消耗的 tokens 计费，没有平台费、路由费和月最低消费。真实用量在控制台的调用日志里逐条可查。