快速开始

注册账号、创建 API 密钥、发起第一次调用、查看使用日志,几分钟跑通。

跟着下面四步,几分钟内完成第一次调用。

注册并登录控制台

打开 https://ai.myaiexp.com/sign-up 点击「注册」创建账号;已有账号就到 https://ai.myaiexp.com/sign-in 点击「登录」。

登录后进入控制台的「数据看板」(https://ai.myaiexp.com/dashboard),可以看到余额、消耗和请求数等概况。调用前请确认账户有余额,充值方式见 钱包。

创建 API 密钥

  1. 进入左侧菜单的「API 密钥」(也可以直接访问 https://ai.myaiexp.com/keys)。
  2. 点击「创建 API 密钥」。
  3. 填写名称(例如 my-first-key),其他选项可以先保持默认;需要限制花费时,为它设置额度上限。
  4. 保存后回到列表,复制这个密钥,得到形如 sk-xxxxxxxx 的完整 Key。

Key 等同于密码:不要提交到 Git,不要发到聊天群。下面所有示例都从环境变量读取。

export MYAIEXP_API_KEY="sk-your-key"

发起第一次调用

先确认 Key 可用,并查看你能调用哪些模型:

models.sh
curl -sS https://ai.myaiexp.com/v1/models \
  -H "Authorization: Bearer $MYAIEXP_API_KEY"

返回的 data[].id 就是可以填进 model 参数的模型 ID。

方式一:OpenAI 兼容接口

Base URL 为 https://ai.myaiexp.com/v1。示例中的 your-model-id 请替换为模型广场中的模型 ID(也可以调用 GET /v1/models 查看);换一个模型只需要改 model,代码不用动。

chat.sh
curl -sS https://ai.myaiexp.com/v1/chat/completions \
  -H "Authorization: Bearer $MYAIEXP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {"role": "user", "content": "Introduce yourself in one sentence."}
    ]
  }'

成功时会返回类似下面的 JSON(内容仅为示意),回答在 choices[0].message.content:

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "your-model-id",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "..." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 30, "total_tokens": 44 }
}

方式二:Claude 原生接口

在 模型广场 选择一个支持 /v1/messages 的模型,使用它的模型 ID。使用 Anthropic SDK 时,Base URL 为 https://ai.myaiexp.com(不带 /v1,SDK 会自行请求 /v1/messages)。该接口同时支持 Authorization: Bearer 和 x-api-key 两种认证头。

messages.sh
curl -sS https://ai.myaiexp.com/v1/messages \
  -H "x-api-key: $MYAIEXP_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Introduce yourself in one sentence."}
    ]
  }'

成功时回答在 content[0].text,用量在 usage.input_tokens 和 usage.output_tokens。

每个模型支持的接口不同:/v1/chat/completions 是 OpenAI 兼容的通用接口;/v1/messages 适用于支持 Claude 原生格式的模型;/v1/responses 适用于支持 Responses 接口的模型。具体可用模型和每个模型支持的接口以 模型广场 为准。

查看使用日志

打开控制台的「使用日志」(https://ai.myaiexp.com/usage-logs),可以看到刚才那次调用的模型、输入 / 输出 Token 数、费用和耗时。看到这条记录,说明接入完成。详见 使用日志。

遇到问题

  • 返回 401:Key 复制不完整,或多了空格、换行;也可能是该密钥已被禁用、删除或过期。
  • 提示模型不存在或无可用渠道:模型 ID 拼写有误,或该密钥设置了模型限制,先用 /v1/models 确认。
  • 调用 /v1/messages 或 /v1/responses 失败、而 /v1/chat/completions 正常:该模型不支持这个接口,请在 模型广场 确认模型支持的接口,见 简介与基本概念。
  • 提示额度不足:账户余额或该密钥的额度用完了,见 钱包。
  • 其他报错见 错误排查。

下一步

本服务仅供学习与研究用途。请遵守各模型提供方的使用政策。

本页目录