API Key 使用指南

了解如何使用 Knodo 提供的 API Key 在本地客户端调用大模型服务

API Key 使用指南

Knodo 不仅是一个 AI 工作平台，还可以作为大模型渠道提供者。您可以获取 API Key 和 Base URL，在本地客户端（如 Claude Code、Cursor 等）中直接使用 Knodo 提供的大模型服务。

什么是 API Key？

API Key 是您访问 Knodo 大模型服务的凭证。通过 API Key，您可以：

• 在本地开发工具中使用 Knodo 的模型配额
• 统一管理组织的 AI 使用额度
• 享受 Knodo 提供的模型优化和加速
• 无需单独购买各个模型厂商的服务

查看 API Key

进入 AI 模型管理

1. 点击左上角组织名称
2. 选择"组织设置"
3. 点击"AI 模型"选项卡

查看 API 信息

在 AI 模型管理页面，您可以看到：

显示 API Key

1. 找到"API Key"字段
2. 点击"显示"按钮
3. API Key 将以明文显示
4. 点击复制按钮快速复制

⚠️ 警告：API Key 是敏感信息，请妥善保管，不要分享给他人

在 Claude Code 中使用

配置步骤

1. 获取 API 信息

   • 从组织设置中复制 Base URL
   • 复制 API Key

2. 配置 Claude Code

打开 Claude Code 配置文件（通常在 ~/.claude/settings.json）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_BASE_URL": "https://your-base-url"
  }
}

⚠️ 注意：Claude Code 使用的 Base URL 不需要 加 /v1 后缀

3. 验证配置

运行 Claude Code 命令测试连接：

mkdir tmp && cd tmp
claude
# 然后输入：Hello 看他的返回

环境变量方式

您也可以通过环境变量配置：

export ANTHROPIC_API_KEY="your-knodo-api-key"
export ANTHROPIC_BASE_URL="https://your-knodo-base-url"

添加到 ~/.bashrc 或 ~/.zshrc 以持久化配置。

在其他客户端中使用

Cursor

1. 打开 Cursor 设置
2. 找到"AI 模型"配置
3. 选择"自定义 API"
4. 填入 Base URL 和 API Key

通用 OpenAI 兼容客户端

Knodo 提供 OpenAI 兼容的 API 接口。以下是完整的使用示例：

#!/usr/bin/env python3
"""Knodo API 使用示例"""

from openai import OpenAI

# 配置信息（替换为你的实际值）
API_KEY = "your-knodo-api-key"
BASE_URL = "https://your-knodo-base-url/v1"  # OpenAI 协议需要加 /v1 后缀

# 创建客户端
client = OpenAI(
    api_key=API_KEY,
    base_url=BASE_URL
)

# 发送请求
# 可用模型: claude-sonnet-4-5, GLM-5, qwen3-235a22b, Qwen3-Coder-Next
response = client.chat.completions.create(
    model="claude-sonnet-4-5",  # 指定要使用的模型
    messages=[
        {"role": "user", "content": "Hello, 请用中文回复"}
    ],
    max_tokens=100
)

# 输出结果
print(f"回复: {response.choices[0].message.content}")
print(f"Token 使用: {response.usage.total_tokens} "
      f"(Prompt: {response.usage.prompt_tokens}, "
      f"Completion: {response.usage.completion_tokens})")

⚠️ 注意：使用 OpenAI 协议的客户端，Base URL 必须 加 /v1 后缀

运行示例：

# 安装依赖
pip install openai

# 运行脚本
python test-api.py

配额管理

查看使用情况

API Key 使用的配额与组织套餐绑定：

1. 进入组织设置 > 计费管理
2. 查看当前配额使用情况
3. 监控 API 调用次数和 Token 消耗

详细了解：计费与套餐

配额耗尽

当配额用尽时：

• API 调用将返回 429 错误
• 需要升级套餐或购买额度包
• 可以在计费管理中查看详情

安全最佳实践

1. 保护 API Key

• ❌ 不要将 API Key 提交到代码仓库
• ❌ 不要在公开场合分享 API Key
• ✅ 使用环境变量存储 API Key

常见问题

Q：API Key 可以分享给团队成员吗？

A：不建议。API Key 代表整个组织的访问权限，应由管理员统一管理。团队成员应直接使用 Knodo 平台。

Q：API Key 泄露了怎么办？

A：立即联系组织管理员重置 API Key。重置后旧的 API Key 将立即失效。

Q：可以创建多个 API Key 吗？

A：当前每个组织只支持一个 API Key。如需多个 Key，可以创建多个组织。

Q：API 调用会消耗工作空间配额吗？

A：是的。API 调用和平台使用共享组织配额。

Q：支持哪些模型？

A：支持多种主流模型，包括：

• Claude 系列：claude-sonnet-4-5 ✅
• GLM 系列：GLM-5 ✅
• Qwen 系列：qwen3-235a22b ✅、Qwen3-Coder-Next ✅
• DeepSeek 系列：deepseek-chat（需配置）

具体可用模型请在 AI 模型管理页面查看。不同组织根据套餐和配置，可用模型可能不同。

Q：Base URL 是什么？

A：Base URL 是 Knodo API 服务的地址。不同客户端使用方式不同：

• Claude Code：使用 https://your-domain（不加 /v1）
• OpenAI 协议客户端：使用 https://your-domain/v1（必须加 /v1）

Q：如何在 CI/CD 中使用？

A：将 API Key 配置为 CI/CD 平台的环境变量（如 GitHub Secrets），在构建脚本中读取使用。

相关文档

• AI 模型配置
• 计费与套餐
• 组织管理