跳转到主要内容

身份验证方法

Bearer 令牌

最常见的身份验证方法是在 Authorization 标头中使用 Bearer 令牌:
Authorization: Bearer YOUR_API_KEY

API 密钥标头 (Anthropic 格式)

对于与 Anthropic 兼容的端点,您也可以使用 x-api-key 标头:
x-api-key: YOUR_API_KEY

获取您的 API 密钥

1

仪表板方法

获取 API 密钥的推荐方法是通过 MegaLLM 仪表板:
  1. 访问 megallm.io/dashboard
  2. 导航到 API 密钥部分
  3. 点击”创建新的 API 密钥”
  4. 复制密钥(以 sk-mega- 开头)并安全存储
2

CLI 工具

如果您已安装 MegaLLM CLI:
npx megallm@latest
按照交互式提示设置您的 API 密钥。

安全最佳实践

永远不要暴露您的令牌: 始终将令牌存储在环境变量或安全保管库中,永远不要存储在代码中。

环境变量

  • Linux/Mac
  • Windows
  • Docker
# 添加到 ~/.bashrc 或 ~/.zshrc
export MEGALLM_API_KEY="your_api_key_here"

# 或使用 .env 文件
echo "MEGALLM_API_KEY=your_api_key_here" >> .env

使用 SDK

OpenAI SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.megallm.io/v1",
    api_key=os.getenv("MEGALLM_API_KEY")
)

response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}]
)

Anthropic SDK

from anthropic import Anthropic

client = Anthropic(
    base_url="https://ai.megallm.io",
    api_key=os.getenv("MEGALLM_API_KEY")
)

message = client.messages.create(
    model="claude-3.5-sonnet",
    max_tokens=100,
    messages=[{"role": "user", "content": "Hello!"}]
)

LangChain 集成

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://ai.megallm.io/v1",
    api_key=os.getenv("MEGALLM_API_KEY"),
    model="gpt-4"
)

response = llm.invoke("Hello!")

故障排除

常见身份验证错误

错误代码消息解决方案
401Unauthorized检查您的 API 密钥是否有效且未过期
403Forbidden验证 API 密钥是否具有所需的访问权限
429Rate Limited等待并重试或联系支持

调试身份验证

启用调试模式以查看详细的身份验证信息:
curl https://ai.megallm.io/v1/chat/completions \
  -H "Authorization: Bearer $MEGALLM_API_KEY" \
  -H "X-Debug-Auth: true" \
  -d '{"model": "gpt-4", "messages": [...]}'
需要帮助? 如果您遇到身份验证问题,请查看我们的常见问题或联系支持。