快速入门

通过一个项目级密钥，HALO 即可访问提供商原生模型 API、长期记忆、身份验证、服务身份和用量控制。本快速入门将发送第一个与 OpenAI 兼容的模型请求。

#开始之前

您需要一个 HALO 账户和一个有效项目。模型调用会消耗项目所有者的账户余额。

#1.创建项目

打开 HALO 控制台，选择 项目，然后为要集成的应用程序或环境创建一个项目。

1. 1
   命名边界

   请为生产环境、预发布环境以及彼此无关的 OEM 产品使用不同的项目。记忆和身份验证数据按项目隔离。

2. 2
   打开项目

   所选项目将成为管理密钥、模型、记忆、历史记录和身份验证的控制台上下文。

#2.创建 API 密钥

选择 API 密钥，创建客户端密钥并仅复制一次。将其作为 HALO_API_KEY 存储在服务器密钥管理器中。

HALO_API_KEY=sk-your-project-client-key

#3.提出请求

HALO 保留每个提供商原有的通信协议。将现有 OpenAI 客户端的基础 URL 指向 HALO，即可继续使用其余请求结构。

curl https://api.agihalo.com/openai/v1/chat/completions \
  -H "Authorization: Bearer $HALO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-mini",
    "messages": [
      { "role": "user", "content": "Reply with one word: ready" }
    ]
  }'

#后续步骤