正在准备内容，请稍候。
正在切换页面...
网络较慢时会保留当前状态，直到新页面准备完成。
这页只回答怎么接。按技术栈直接选示例即可。
第一次验证连通性、鉴权和最小请求体时最稳。
先用它验证 Base URL 和 Bearer 令牌，再切到正式 SDK。
适合浏览器前端、边缘运行时和轻量服务端脚本。
如果你要用 `stream=true`，请确认当前环境支持 ReadableStream。
适合数据脚本、自动化任务和后端服务。
先调用 `/v1/models`，不要把模型名写死在任务配置里。
适合 Node.js、Next.js 服务端接 OpenAI 原生路由。
把 `baseURL` 指到 `/v1`，只用于 OpenAI 模型与 OpenAI 请求格式。
适合企业后端和偏强类型服务。
优先先接最小请求体，再逐步增加结构化输出和流式能力。
这样前端不用直接持有完整令牌，后续控流、审计和切换供应商也更容易。
适合 Web 产品把客户端请求转到自己的服务端，再统一转发到 TokenAI。
适合已有 Node 网关、BFF 或代理层项目直接接入。
适合 Python 后端和自动化编排服务快速起步。
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.TOKENAI_API_KEY,
baseURL: "https://api.ciyuan.com/v1",
});
const models = await client.models.list();
const model = models.data[0]?.id;
const completion = await client.chat.completions.create({
model,
messages: [{ role: "user", content: "请输出一段接入说明" }],
});const stream = await client.chat.completions.create({
model,
messages: [{ role: "user", content: "请流式输出三条要点" }],
stream: true,
stream_options: { include_usage: true },
});
for await (const chunk of stream) {
console.log(chunk.choices?.[0]?.delta?.content ?? "");
}Collection Variables
- baseUrl = https://api.ciyuan.com
- apiKey = tk_your_full_token
- modelId = your_model_id_from_/v1/models
Requests
- GET {{baseUrl}}/v1/models
- POST {{baseUrl}}/v1/chat/completions
- POST {{baseUrl}}/v1/responses
- POST {{baseUrl}}/v1/embeddings
- POST {{baseUrl}}/v1/realtime/sessions
- GET {{baseUrl}}/v1/assistants
- POST {{baseUrl}}/v1/assistants
- POST {{baseUrl}}/v1/threads
- POST {{baseUrl}}/v1/threads/runs
- GET {{baseUrl}}/v1/files
- POST {{baseUrl}}/v1/files
- POST {{baseUrl}}/v1/uploads
- GET {{baseUrl}}/v1/batches
- POST {{baseUrl}}/v1/batches
- GET {{baseUrl}}/v1/vector_stores
- POST {{baseUrl}}/v1/vector_stores
- POST {{baseUrl}}/v1/images/generations
- POST {{baseUrl}}/v1/audio/speech
- POST {{baseUrl}}/v1/audio/translations
- POST {{baseUrl}}/v1/audio/transcriptions
Realtime
- HTTP baseUrl 继续使用 {{baseUrl}}
- 先调用 POST {{baseUrl}}/v1/realtime/sessions
- 如果响应头里有 x-tokenai-realtime-relay-url，优先连接该 wss 地址
- 如果客户端不支持读取响应头，再手动配置独立的 realtime ws 地址