开始使用

快速开始

三步完成：创建密钥、设置两个参数、发送一次请求。

1. 创建账号和密钥

创建账号（无需密码：我们会通过邮件发送验证码），然后在账单中充值。
打开 API 密钥，为密钥命名并创建。请立即复制：完整密钥只显示一次。

2. 设置密钥和基础 URL

不要将密钥写入代码。在 shell 或应用加载的 .env 文件中设置:

.env

ZURELAY_API_KEY=zr_live_your_key_here

如果尚未安装 SDK，请先安装：Python 使用 pip install openai，Node 使用 npm install openai。Anthropic 的 SDK 也可使用（参见 Anthropic Messages）。

3. 发送请求

main.py

import os
from openai import OpenAI
client = OpenAI(
    base_url="https://api.zurelay.com/v1",
    api_key=os.environ["ZURELAY_API_KEY"],
)
response = client.chat.completions.create(
    model="gpt-6-sol",
    messages=[
      {
        "role": "system",
        "content": "You are a concise assistant."
      },
      {
        "role": "user",
        "content": "Give me three names for a coffee shop on the moon."
      }
    ],
)
print(response.choices[0].message.content)

响应采用 OpenAI 格式，包含实际作答的模型和 token 用量:

响应

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1790870400,
  "model": "gpt-6-sol",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "1. Lunar Grind\n2. ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 31, "completion_tokens": 24, "total_tokens": 55 }
}

流式输出

添加 stream: true 即可边生成边接收回答，流式输出方式与 OpenAI 相同。