DragonAPI

切换主题

API 与 SDK 接入 ​

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

选择协议与模型 ​

OpenAI 兼容基础地址为 https://newapi.dragon3api.com/v1。不同模型可能只支持部分接口，先确认 Chat Completions、Responses 或 Anthropic Messages 的兼容范围。

先用 最小 cURL 请求验证 Key、模型和地址，再接入项目。生产 Key 放服务端环境变量，不写进浏览器前端。

Node.js：OpenAI SDK ​

sh
npm install openai

以下使用 Chat Completions；环境变量 DRAGONAPI_MODEL 填当前可用模型 ID。

javascript
import OpenAI from 'openai';

const client = new OpenAI({
apiKey: process.env.DRAGONAPI_KEY,
baseURL: 'https://newapi.dragon3api.com/v1'
});

const result = await client.chat.completions.create({
model: process.env.DRAGONAPI_MODEL,
messages: [{ role: 'user', content: '请只回复 OK' }]
});
console.log(result.choices[0].message.content);

Python：OpenAI SDK ​

sh
python -m pip install openai
python
import os
from openai import OpenAI

client = OpenAI(
  api_key=os.environ['DRAGONAPI_KEY'],
  base_url='https://newapi.dragon3api.com/v1',
)
result = client.chat.completions.create(
  model=os.environ['DRAGONAPI_MODEL'],
  messages=[{'role': 'user', 'content': '请只回复 OK'}],
)
print(result.choices[0].message.content)

Responses 接口 ​

对于支持 Responses 的模型，可以使用 SDK 的对应接口：

javascript
const result = await client.responses.create({
model: process.env.DRAGONAPI_MODEL,
input: '请只回复 OK'
});
console.log(result.output_text);

Codex 的客户端配置见 Codex CLI。不要为一个不支持的模型强行切换协议。

Anthropic 兼容工具 ​

使用基础地址 https://newapi.dragon3api.com，API Key 仍由本站创建。客户端按 Anthropic 方式配置，不手工重复拼 /v1，详见 Claude Code。

图片和视频 ​

按具体模型文档选择接口和参数。异步模型可能创建任务后轮询；其他图片协议可能直接返回图片结果。不要把所有图片请求都改成 /v1/videos。

进入 图片／视频文档查看所选模型；在线工作台使用方式见 图文教程。

上线前检查 ​

  • 使用独立 Key 和预算，确认分组权限。
  • 处理连接、读取与业务超时；长任务先查询状态，避免重复提交。
  • 对临时 429／5xx 使用有上限的退避重试；认证或参数错误不要盲重试。
  • 记录时间、模型、request id／task id 和错误正文，日志中不保存完整 Key。
  • 实际费用以本站使用日志和计费规则为准。

模型、价格与服务规则以当前控制台为准。

DragonAPI