API 快速开始

更新于 2026-09-20 · 页面与服务规则以当前控制台为准

先确认这三项

1. 在 控制台创建 API Key，并确认该密钥的分组。
2. 从模型广场或模型列表取得当前可用的完整模型 ID。
3. 按客户端协议选择基础地址：OpenAI 兼容为 https://newapi.dragon3api.com/v1，Anthropic 兼容为 https://newapi.dragon3api.com。

桌面软件用户不必先写代码：可直接看 Windows Codex或 CC Switch。

查询密钥可见的模型

以下示例使用你在本机设置的 DRAGONAPI_KEY 环境变量，不要把真实 Key 提交进代码仓库。

curl 'https://newapi.dragon3api.com/v1/models' \
-H "Authorization: Bearer $DRAGONAPI_KEY"

模型列表表示当前可见信息；具体协议、模态和实时可用性仍需按模型说明确认。

Chat Completions 最小请求

将 YOUR_AVAILABLE_MODEL 替换为支持此协议的完整模型 ID。

curl 'https://newapi.dragon3api.com/v1/chat/completions' \
-H "Authorization: Bearer $DRAGONAPI_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"YOUR_AVAILABLE_MODEL","messages":[{"role":"user","content":"请只回复 OK"}]}'

这个请求可能产生少量费用。成功后在 使用日志确认模型和用量。

Responses 最小请求

Codex 使用 Responses 兼容方式。模型需支持该协议：

curl 'https://newapi.dragon3api.com/v1/responses' \
-H "Authorization: Bearer $DRAGONAPI_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"YOUR_AVAILABLE_MODEL","input":"请只回复 OK"}'

接下来

SDK 示例 · 模型分组 · 图片／视频接口 · 错误排查。