首页 / 文档 / 快速开始

快速开始

获取密钥,设置两个环境变量,约一分钟内即可发出首次请求。

本页将带您从零开始,直至获得成功响应。仅假定您具备 curl;SDK 版本见 SDK.

步骤 1 — 创建密钥

  1. 注册账户 并验证您的电子邮箱。
  2. 充值额度 或 购买无限量套餐。新账户首次使用加密货币充值可获得奖励——请参阅 定价.
  3. 打开控制台,前往 API 密钥,然后创建密钥。密钥以此开头: sk-.
  4. 请立即复制——完整密钥仅显示一次。

步骤 2 — 导出密钥

export CLAUDEAPIKEY="sk-your-key-here"

步骤 3 — 调用 API

Anthropic 格式

curl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

OpenAI 格式

模型相同,封装格式不同——请选择与客户端匹配的格式:

curl https://aiprimetech.io/v1/chat/completions \
  -H "Authorization: Bearer $CLAUDEAPIKEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

步骤 4 — 确认可访问的模型

curl https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $CLAUDEAPIKEY"

这会返回您的密钥可访问的所有模型 ID。请在以下位置原样使用这些 ID: model 字段。

步骤 5 — 配置实际工具连接

对于 Claude Code,只需两个变量即可完成全部配置:

export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="$CLAUDEAPIKEY"
claude
如果 ANTHROPIC_API_KEY 已在您的 shell 中设置,Claude Code 可能会改为通过该密钥计费,并在不提示的情况下忽略您的订阅。切换时请取消设置该变量。请参阅 Claude Code.

首次调用故障排查

症状原因解决方法
401密钥缺失、输入有误,或放在了错误的请求头中Anthropic 格式使用 x-api-key;OpenAI 格式使用 Authorization: Bearer
402没有额度,也没有有效套餐充值 或 购买套餐
404 在 /v1/chat/completions客户端使用 OpenAI 请求体调用 Anthropic 路径,或反之确保格式与端点匹配——请参阅 概览
model_not_found模型 ID 的拼写与以下接口返回的值不完全一致: /v1/models从模型端点复制 ID