文档
发出第一个请求
DigitSpace 兼容 OpenAI API。如果你的代码已经在调用 OpenAI,只需改 Base URL 和密钥。
快速上手
- 注册账号,打开你的项目。
- 在「API 密钥」页面创建一个密钥。
- 向
https://api.digitspace.cn/v1发送请求:
curl https://api.digitspace.cn/v1/chat/completions \
-H "Authorization: Bearer $DIGITSPACE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [{ "role": "user", "content": "用三种语言打个招呼。" }]
}'身份验证
每个请求都要在 Authorization 请求头里以 Bearer Token 的形式带上密钥。密钥只放在服务端,不要写进浏览器或移动应用。你可以随时在控制台吊销密钥,用它发起的请求会立即失效。
使用 SDK
任何兼容 OpenAI 的客户端都能用,把它指向 DigitSpace 即可:
JavaScript / TypeScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DIGITSPACE_API_KEY,
baseURL: "https://api.digitspace.cn/v1",
});
const reply = await client.chat.completions.create({
model: "auto",
messages: [{ role: "user", content: "写一首关于路由的短诗。" }],
});
console.log(reply.choices[0].message.content);Python
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["DIGITSPACE_API_KEY"],
base_url="https://api.digitspace.cn/v1",
)
reply = client.chat.completions.create(
model="auto",
messages=[{"role": "user", "content": "写一首关于路由的短诗。"}],
)
print(reply.choices[0].message.content)选择模型
从模型页选一个模型 ID 填进去,就会使用该模型,例如 qwen3.7-plus。请求失败时,DigitSpace 会自动换到同一模型的其他服务节点重试。
填 auto 则由 DigitSpace 自动选择:它会看请求需要什么(上下文长度、工具、图片、推理),挑出能处理它的最便宜的模型。用 GET https://api.digitspace.cn/v1/models 可以列出所有可用模型。
部分模型(如 DeepSeek、Kimi、Qwen3 系列)会先思考再回答。max_tokens 只限制答案的长度,平台会为思考另外预留空间,答案不会因为思考太长而被截断。简单任务可以在请求里加 "reasoning_effort": "none" 关闭思考,回答更快、费用更低。
流式输出
设置 stream: true,回复会在生成过程中以 SSE 事件流的形式返回,用法和 OpenAI 完全一样。SDK 会帮你处理:
const stream = await client.chat.completions.create({
model: "auto",
messages: [{ role: "user", content: "从一数到五。" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}计费方式
- 余额:每个请求以人民币从余额中扣费。模型按官方价(含税)标价,实际扣费以控制台「调用记录」里的金额为准。
- 充值:发邮件到 support@digitspace.cn 联系客服充值;暂不支持在线支付,充值不收手续费。
每个请求都会出现在「调用记录」里,包括模型、Token、延迟和费用。查看价格。
错误码
错误沿用 OpenAI 的错误格式,并附有说明原因的消息。最常见的状态码:
| 400 | 请求无效,或者模型做不了所要求的事。 |
| 401 | API 密钥缺失、错误或已被吊销。 |
| 402 | 余额不足,请联系客服充值。 |
| 403 | 你的账号或项目无权发起该请求。 |
| 429 | 触发了频率限制,请稍后重试。 |
| 5xx | 暂时没有可用的服务处理该请求,请稍后重试。 |
获取帮助
有问题?联系我们,或发邮件到 support@digitspace.cn。