EasyK API 接入指南

创建 API Key，选择可用模型，再将客户端的服务地址指向 EasyK。下列示例不需要把密钥写进代码。

Base URL 与完整端点

OpenAI SDK 的 Base URL 为 https://easyk.cn/v1；Anthropic SDK 的 Base URL 为 https://easyk.cn。SDK 会添加接口路径。需要填写完整端点的客户端应直接使用下表路径。

将 YOUR_MODEL 替换为账户已开通的模型名称。协议可用性由所选模型和渠道决定；兼容接口不表示所有模型支持相同参数。

使用 OpenAI Python SDK

先安装对应 SDK，再通过环境变量设置自己的 API Key。

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["EASYK_API_KEY"], base_url="https://easyk.cn/v1")
response = client.chat.completions.create(
    model="YOUR_MODEL",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

使用 Responses API

当所选模型支持 Responses 时，可复用上面的 client：

response = client.responses.create(model="YOUR_MODEL", input="你好")

使用 Anthropic Python SDK

from anthropic import Anthropic
import os

client = Anthropic(api_key=os.environ["EASYK_API_KEY"], base_url="https://easyk.cn")
response = client.messages.create(
    model="YOUR_MODEL", max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)

通过 curl 调用 Gemini 接口

curl "https://easyk.cn/v1beta/models/YOUR_MODEL:generateContent" \
  -H "Authorization: Bearer $EASYK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"你好"}]}]}' 

流式输出与工具配置

支持流式输出的模型可按对应协议设置流式参数。Claude Code、Codex、Cursor、Cline 和 CC-Switch 等工具的配置项各不相同，请在控制台调用说明中查看当前配置。

常见错误如何排查？

• 401：检查 API Key 是否有效、是否正确传入。
• 403：检查账户权限和 API Key 的模型访问范围。
• 404：检查服务地址是否重复拼接 /v1，以及模型名称是否正确。
• 429：检查账户或上游限流、余额与可用额度。
• 502 / 504：检查上游连接、响应和超时记录。

用量、费用和缓存记录可在控制台查询；模型价格与可用性以当前配置为准。