从一个入口，连接每一种模型工作流

快速开始

先在控制台创建 API 密钥，再从 GET /v1/models 选择当前密钥真正可用的模型。示例中的密钥与模型均为安全占位符。

curl https://www.timedigital.cn/v1/chat/completions \
  -H "Authorization: Bearer $TIMEDIGITAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL","messages":[{"role":"user","content":"Hello"}]}'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_TIMEDIGITAL_API_KEY",
    base_url="https://www.timedigital.cn/v1",
)

response = client.chat.completions.create(
    model="YOUR_MODEL",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.TIMEDIGITAL_API_KEY,
  baseURL: "https://www.timedigital.cn/v1",
});

const response = await client.chat.completions.create({
  model: "YOUR_MODEL",
  messages: [{ role: "user", content: "Hello" }],
});

认证与 API 密钥

OpenAI 兼容路由使用 Bearer；Anthropic Messages 使用 x-api-key 和 anthropic-version；Gemini 路由支持查询参数 key 或 x-goog-api-key。

Authorization: Bearer YOUR_TIMEDIGITAL_API_KEY

x-api-key: YOUR_TIMEDIGITAL_API_KEY
anthropic-version: 2023-06-01

x-goog-api-key: YOUR_TIMEDIGITAL_API_KEY

Base URL

当前部署读取到的服务地址：

https://www.timedigital.cn/v1

如果你的客户端要求填写不含 /v1 的服务根地址，请按该客户端的字段定义配置；协议路径仍以本文列出的 Endpoint 为准。

OpenAI 兼容接口

数字时代提供下列可发现路由。兼容标准 SDK 不等于支持其全部产品接口。

Files、Fine-tunes、Image Variations 与删除模型不属于当前可用能力，请勿将它们加入生产接入流程。

Anthropic Messages

客户端需要同时提供 API 密钥与 Anthropic 版本 Header。是否可调用某个 Claude 模型仍由当前密钥、分组与模型路由共同决定。

示例

curl https://www.timedigital.cn/v1/messages \
  -H "x-api-key: $TIMEDIGITAL_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"YOUR_MODEL","max_tokens":256,"messages":[{"role":"user","content":"Hello"}]}'

Gemini 兼容接口

Models

模型列表受 API 密钥、用户分组、模型映射与路由配置影响。请使用同一把密钥读取列表并发起后续请求。

curl https://www.timedigital.cn/v1/models \
  -H "Authorization: Bearer $TIMEDIGITAL_API_KEY"

Chat Completions

请求体支持 stream: true 时以 SSE 返回。流式传输中的错误可能出现在 HTTP 连接建立之后，客户端需要同时处理 HTTP 错误与流内错误。

Responses

Compact 属于独立高级路由。不要把它当作所有客户端都会自动调用的通用行为。

Embeddings

输入格式与维度支持取决于选定模型。先从模型列表确认可用模型，不要在客户端假定所有文本模型均支持向量生成。

Images 与 Audio

图像与语音接口的多媒体参数体积较大，上传前请检查客户端超时设置；大文件建议先用对象存储换取 URL 再传入。

更多原生接口

绘图、视频和异步任务存在专用任务路由与查询流程。只有对应模型和渠道已配置时才可使用，以服务端返回为准。

SDK 与客户端

OpenAI SDK 可通过替换 Base URL 和 API Key 接入。Codex、Claude Code 等工具的可用程度取决于它们实际使用的协议、Endpoint 和环境变量支持。

• OpenAI SDK / 兼容客户端：Base URL 填 https://www.timedigital.cn/v1，模型名填本站模型广场中的名称。
• Claude Code 等 Anthropic 协议工具：把服务地址指向同一域名，并使用 /v1/messages 与 x-api-key 认证。
• Cherry Studio、Cline、Dify、LobeChat、沉浸式翻译：按「OpenAI 兼容」类型新建供应商，填入上面的 Base URL 与密钥即可。

常见错误

错误正文与 Request ID 应作为排查依据；不要用前端自定义文案覆盖服务端业务语义。

配额与速率限制

额度、货币展示、倍率与分组价格来自当前系统配置。API 密钥还可能具有独立额度、模型与 IP / CIDR 限制。遇到 429 时，请区分账户额度、密钥额度、系统限流和上游限流。

常见问题