达智聚元 API 快速入门

2 分钟完成接入
达智聚元 API 兼容 OpenAI SDK。对于已经接入 OpenAI API 的项目，通常只需要修改 Base URL 和 API Key。

开始之前

你需要准备：

一个达智聚元账号；

一个以 sk- 开头的 API Key；

curl、Python 或 Node.js 运行环境。

API 基础地址：

https://token.dazrix.com/v1

认证方式：

请将示例中的 sk-your-key 替换为你的真实 API Key。不要把真实密钥提交到 Git 仓库、粘贴到公开聊天或写入客户端代码。

第 1 步：获取 API Key

注册并登录达智聚元；

进入 Dashboard → API Keys；

点击 Create New Key；

复制生成的 API Key。

API Key 通常以 sk- 开头。密钥可能只在创建时完整显示一次，请及时保存到安全的密码管理器或密钥管理服务中。

建议将密钥保存为环境变量：

macOS 或 Linux

Windows PowerShell

$env:DAZRIX_API_KEY = "sk-your-key"

第 2 步：发送第一条请求

达智聚元提供与 OpenAI Chat Completions 兼容的接口：

POST /v1/chat/completions

请选择你使用的语言。

cURL

请求中的主要字段：

字段	类型	说明
`model`	string	要调用的模型名称
`messages`	array	对话消息列表
`messages[].role`	string	消息角色，例如 `system`、`user` 或 `assistant`
`messages[].content`	string	消息内容

成功响应中，模型生成的文本通常位于：

choices[0].message.content

Python（OpenAI SDK）

安装 SDK：

创建 main.py：

运行程序：

TypeScript（OpenAI SDK）

安装 SDK：

创建 index.ts：

第 3 步：启用流式响应

流式响应会在模型生成内容时持续返回增量数据，适合聊天界面、长文本生成和需要即时反馈的场景。

在 OpenAI SDK 请求中设置：

完整 Python 示例：

流式响应与普通响应的主要区别：

普通响应会等待模型生成完成后一次性返回；

流式响应会持续返回多个数据块；

每个数据块中的新增文本通常位于 choices[0].delta.content。

第 4 步：查看可用模型

不同 API Key 可访问的模型可能不同。调用模型列表接口，查看当前密钥可用的模型：

接口地址：

GET /v1/models

建议在正式调用前先查询模型列表，并将返回的模型 ID 填入 Chat Completions 请求的 model 字段。

常见问题

返回 `401 Unauthorized`

请检查：

是否已经设置 DAZRIX_API_KEY；

API Key 是否完整，且以 sk- 开头；

请求头是否使用 Authorization: Bearer <API_KEY>；

Bearer 与 API Key 之间是否有一个空格；

API Key 是否已被删除、禁用或替换。

返回 `403 Forbidden`

当前 API Key 可能没有访问目标模型或接口的权限。请先调用 /v1/models 确认可用模型，并检查密钥权限配置。

返回模型不存在

模型名称可能有误，或者该模型未对当前 API Key 开放。请使用模型列表接口获取准确的模型 ID：

GET https://token.dazrix.com/v1/models

请求成功但程序没有输出

请确认读取了正确的响应字段：

非流式响应：response.choices[0].message.content；

流式响应：chunk.choices[0].delta.content。

不应该把 API Key 放在哪里？

不要把真实 API Key 放在：

Git 仓库；

浏览器前端代码；

移动应用安装包；

可公开访问的日志；

截图、工单或公开聊天记录。

如果密钥疑似泄露，请立即在控制台撤销旧密钥并创建新密钥。

接入检查清单

已创建以 sk- 开头的 API Key；

已将密钥保存到环境变量；

Base URL 设置为 https://token.dazrix.com/v1；

已成功调用 /v1/chat/completions；

已通过 /v1/models 确认可用模型；

已通过 /v1/token/balance 检查余额和额度；

生产环境中没有硬编码 API Key；

日志不会输出 Authorization 请求头。

下一步

完成第一次请求后，你可以继续：

将现有 OpenAI SDK 项目的 Base URL 切换到达智聚元；

根据 /v1/models 返回结果选择其他模型；

为聊天应用启用流式响应；

在服务端增加超时、重试和错误处理；

定期检查 API Key 额度并轮换密钥。

达智聚元 API 快速入门

开始之前#

第 1 步：获取 API Key#

macOS 或 Linux#

Windows PowerShell#

第 2 步：发送第一条请求#

cURL#

Python（OpenAI SDK）#

TypeScript（OpenAI SDK）#

第 3 步：启用流式响应#

第 4 步：查看可用模型#

常见问题#

返回 401 Unauthorized#

返回 403 Forbidden#

返回模型不存在#

请求成功但程序没有输出#

不应该把 API Key 放在哪里？#

接入检查清单#

下一步#