API 请求示例

使用编码工具时，可以直接阅读工具配置。本页面向需要自己发送 HTTP 请求的开发者。

下面是 macOS / Linux 的 Bash 或 Zsh 示例。先设置 KEENKIND_API_KEY 环境变量，再把每段请求中的 YOUR_MODEL_ID 替换为模型目录中已确认适用的模型 ID。

export KEENKIND_API_KEY='替换为你的 KeenKind API Key'

以下三种请求按需要选择一种，不必逐个执行。生成请求会产生实际用量。

Responses

curl --silent --show-error 'https://api.keenkind.ai/v1/responses' \
  --header "Authorization: Bearer $KEENKIND_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "YOUR_MODEL_ID",
    "input": "请解释什么是单元测试，用两句话回答。"
  }'

Chat Completions

curl --silent --show-error 'https://api.keenkind.ai/v1/chat/completions' \
  --header "Authorization: Bearer $KEENKIND_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "请解释什么是单元测试，用两句话回答。"}
    ]
  }'

Anthropic Messages

curl --silent --show-error 'https://api.keenkind.ai/v1/messages' \
  --header "x-api-key: $KEENKIND_API_KEY" \
  --header 'anthropic-version: 2023-06-01' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "YOUR_MODEL_ID",
    "max_tokens": 512,
    "messages": [
      {"role": "user", "content": "请解释什么是单元测试，用两句话回答。"}
    ]
  }'

使用 SDK

使用对应协议的 SDK 时，把 API Key 与 Base URL 设置为：

SDK	Base URL	密钥
OpenAI 兼容 SDK	https://api.keenkind.ai/v1	KEENKIND_API_KEY 环境变量的值
Anthropic 兼容 SDK	https://api.keenkind.ai	KEENKIND_API_KEY 环境变量的值

模型 ID 仍需使用 KeenKind 目录中的 id。第三方工具调用不需要网站登录 Cookie 或网站客户端专用请求头。

检查结果

成功时应看到对应协议的模型响应，并能在用量记录中核对调用。错误响应请按状态码与错误码查看 API 常见问题；网络中断时先查调用记录，再决定是否重试。