开发文档Model API
Model API 接入
在你的服务端调用平台已开放的模型,费用从账号通用算力扣除。接口与 OpenAI Chat Completions 格式一致。
准备
- 用 DeepDoer 账号登录控制台,在「模型与定价」查看可用模型和价格。
- 在「API Keys」创建密钥。完整密钥只显示一次,遗失请新建并撤销旧的。
- 把密钥放在服务端环境变量
DEEPDOER_API_KEY,不要放进前端、客户端、日志或代码库。
Base URL 与鉴权
https://deepdoer.cn/developers/v1
请求头带 Authorization: Bearer <API_KEY>。网页登录 token 不能用于推理接口。
查询模型
curl "https://deepdoer.cn/developers/v1/models" \
-H "Authorization: Bearer $DEEPDOER_API_KEY"只返回这把密钥可用的模型 ID。请用这里的 ID 调用,不要用桌面端显示名。
创建对话
curl "https://deepdoer.cn/developers/v1/chat/completions" \
-H "Authorization: Bearer $DEEPDOER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "REPLACE_WITH_ENABLED_ALIAS",
"messages": [{ "role": "user", "content": "你好" }],
"stream": false
}'import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DEEPDOER_API_KEY,
baseURL: "https://deepdoer.cn/developers/v1",
});
const completion = await client.chat.completions.create({
model: "REPLACE_WITH_ENABLED_ALIAS",
messages: [{ role: "user", content: "你好" }],
});
console.log(completion.choices[0].message.content);const res = await fetch("https://deepdoer.cn/developers/v1/chat/completions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.DEEPDOER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "REPLACE_WITH_ENABLED_ALIAS",
messages: [{ role: "user", content: "你好" }],
}),
});import os, requests
resp = requests.post(
"https://deepdoer.cn/developers/v1/chat/completions",
headers={"Authorization": f"Bearer {os.environ['DEEPDOER_API_KEY']}"},
json={"model": "REPLACE_WITH_ENABLED_ALIAS", "messages": [{"role": "user", "content": "你好"}]},
timeout=60,
)
print(resp.json()["choices"][0]["message"]["content"])目前只开放 GET /models 和 POST /chat/completions。调用 /responses、/images 等其他接口会返回 unsupported_endpoint。
请求参数
POST /chat/completions 只接受以下字段,其他字段一律返回 400 invalid_request:
model、messages、stream、stream_options(仅 include_usage)、max_tokens 或 max_completion_tokens(二选一)、temperature、top_p、stop、presence_penalty、frequency_penalty、seed、tools、tool_choice、parallel_tool_calls、response_format、n。
messages为 1–128 条,role取system/user/assistant/tool;content只支持纯文本字符串,不支持图片等多段内容。n只能为 1;stop为一个字符串或 1–4 个字符串。tools最多 32 个,只支持function类型。- 不传输出上限时按平台上限处理;超过上限返回 400。
密钥
- 创建时选择范围(指定模型 / 全部开放模型)和到期时间,之后不能修改;要改就新建一把。
- 名称和启用状态可以改。撤销不可恢复,过期的密钥不能重新启用。
- 请求大小、最大输出、每分钟请求数和并发上限由平台策略决定。
计费
每个模型按次或按 Token 计费,以「模型与定价」里的 effectiveBillingType 为准(PER_CALL 按次,TOKEN 按输入、输出和缓存分别计价),不是全部模型都已启用 TOKEN。
请求开始时先预占一笔算力,结束后按实际用量结算。预占仅为请求上限,不是实扣。调用记录里的状态:
| 状态 | 含义 |
|---|---|
settled |
已结算,看 settledCredits |
running |
进行中,已预占、尚未结算 |
settlement_pending / release_pending |
结算或释放处理中 |
released |
预占已释放,未扣费 |
needs_attention |
结算结果待平台核对 |
failed / cancelled |
调用失败或被取消 |
未知用量不按估算或预占上限收费;用量缺失或结算未知应待核对,以账单更新为准。
分时价格
部分 TOKEN 模型按时段分档计价(如高峰、低谷)。GET /models 和控制台「模型与定价」的模型目录里,effectiveBillingType 为 TOKEN 的模型带下面四个字段。GET /models 里值为空时省略字段,控制台里为 null;没有这些字段时,按顶层单价理解即可:
| 字段 | 说明 |
|---|---|
pricingTiers |
各档价格:id、name、inputCreditsPer1m、outputCreditsPer1m、cacheReadCreditsPer1m、cacheWriteCreditsPer1m(十进制字符串,单位为算力/百万 Token)和 current(是否为当前档)。不分时的模型只有一档 |
pricingScheduleSummary |
时段说明,一句中文;不分时为空 |
pricingNextChangeAt |
下一次切换档位的时刻(ISO-8601 UTC,如 2026-11-10T04:00:00Z);不分时为空 |
pricingNextTierId |
切换后生效的档位 id,对应 pricingTiers 中的一项;与 pricingNextChangeAt 同时出现或同时为空 |
inputCreditsPer1m 等顶层字段始终是此刻生效的单价。每个请求按请求开始时的价格结算。过了 pricingNextChangeAt 请重新获取模型目录,不要自行推算新价格。
出错时
错误响应与 OpenAI 格式一致;流式请求出错时,同样的结构会作为一条 SSE data 事件发出:
{
"error": {
"message": "Invalid API key",
"type": "authentication_error",
"param": null,
"code": "invalid_api_key"
}
}type 在 401 时为 authentication_error,5xx 为 server_error,其余为 invalid_request_error。按 code 处理:
| HTTP | code |
原因与处理 |
|---|---|---|
| 400 | invalid_request |
请求体不是合法 JSON、含不支持的字段或超出限制;message 会说明具体字段 |
| 400 | unsupported_endpoint |
调用了未开放的接口 |
| 401 | invalid_api_key |
密钥缺失、格式不对,或已撤销、停用、过期 |
| 402 | insufficient_credit |
账号算力不足,充值后重试 |
| 403 | api_disabled |
Model API 暂未开放 |
| 403 | model_not_allowed |
模型不在这把密钥的范围内,或已不在开放列表 |
| 429 | rate_limit_exceeded |
超出每分钟请求数或并发上限,稍后重试 |
| 502 | upstream_error |
上游模型返回异常或不完整 |
| 503 | token_billing_not_ready / admission_unavailable |
平台暂时无法受理,稍后重试 |
超时、断网或 5xx 时,先查调用记录再决定是否重试,避免重复调用。
这篇文档有问题?匿名提交,不记录账号。