API 文档

Ciyuano 词元圈完全兼容 OpenAI Chat Completions API,只需修改 base_url 和 api_key 即可无缝接入。

快速开始

三步完成接入,即刻使用 AI 大模型 API。

1

注册获取 API Key

注册账号后在控制台创建 API Key,格式为 sk-relay-***

2

安装 SDK

使用 OpenAI 官方 SDK,支持 Python、Node.js 等多种语言。

3

调用 API

修改 base_url 为词元圈地址,即可像使用 OpenAI 一样调用。

Python
# 1. Install SDK
pip install openai

# 2. Create client
from openai import OpenAI
client = OpenAI(
    base_url="https://www.ciyuano.com/v1",
    api_key="sk-relay-your-key"
)

# 3. Call API
response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好!"}]
)
print(response.choices[0].message.content)

模型寻址

两种写法都支持。同一模型存在于多个厂商时,推荐使用「厂商/模型」形式,精确指定厂商:

sensenova/sensenova-6.8-flash-lite ← 推荐,精确指定厂商
sensenova-6.8-flash-lite ← 仍然兼容,由任意可用厂商承接

GET /v1/models 会同时列出两种形式;厂商写错时返回 404,并提示该模型实际可用的厂商。