文档

发出第一个请求

DigitSpace 兼容 OpenAI API。如果你的代码已经在调用 OpenAI,只需改 Base URL 和密钥。

快速上手

  1. 注册账号,打开你的项目。
  2. 在「API 密钥」页面创建一个密钥。
  3. 向 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请求无效,或者模型做不了所要求的事。
401API 密钥缺失、错误或已被吊销。
402余额不足,请联系客服充值。
403你的账号或项目无权发起该请求。
429触发了频率限制,请稍后重试。
5xx暂时没有可用的服务处理该请求,请稍后重试。

获取帮助

有问题?联系我们,或发邮件到 support@digitspace.cn。