开发文档Model API

Model API 接入

在你的服务端调用平台已开放的模型,费用从账号通用算力扣除。接口与 OpenAI Chat Completions 格式一致。

准备

  1. 用 DeepDoer 账号登录控制台,在「模型与定价」查看可用模型和价格。
  2. 在「API Keys」创建密钥。完整密钥只显示一次,遗失请新建并撤销旧的。
  3. 把密钥放在服务端环境变量 DEEPDOER_API_KEY,不要放进前端、客户端、日志或代码库。

Base URL 与鉴权

https://deepdoer.cn/developers/v1

请求头带 Authorization: Bearer <API_KEY>。网页登录 token 不能用于推理接口。

查询模型

Shell
curl "https://deepdoer.cn/developers/v1/models" \
  -H "Authorization: Bearer $DEEPDOER_API_KEY"

只返回这把密钥可用的模型 ID。请用这里的 ID 调用,不要用桌面端显示名。

创建对话

Shell
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
  }'
OpenAI SDK
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);
Node.js
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: "你好" }],
  }),
});
Python
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 事件发出:

JSON
{
  "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 时,先查调用记录再决定是否重试,避免重复调用。