DEVELOPER ACCESS

把细微接进你的应用

使用 API Key，通过 OpenAI 兼容接口访问对话与续写模型。

模型暂不可用

快速开始

示例模型

登录并申请 API Key。审核通过后主动领取，完整密钥只显示一次。

curl

curl https://YOUR_SITE/v1/chat/completions \
  -H "Authorization: Bearer $SITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"feng-30m","messages":[{"role":"user","content":"你好"}],"max_tokens":64}'

Python SDK

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["SITE_API_KEY"],
    base_url="https://YOUR_SITE/v1",
)
response = client.chat.completions.create(
    model="feng-30m",
    messages=[{"role": "user", "content": "你好"}],
    max_tokens=64,
)
print(response.choices[0].message.content)

安装：pip install openai。将密钥保存为环境变量 SITE_API_KEY。

请求参数

POST/v1/chat/completions

参数	说明
`model`	feng-30m / tiny-qwen3-30m-zh / small_llm_O1 / nanogpt-chinese-lyrics / tang-poem-lite / babyllm-chinese-v13（支持完整仓库名）
`messages`	1–32 条 system / user / assistant 消息，总计不超过 4000 字符。超出模型上下文时保留最近消息。
`max_tokens`	默认 64，最多 128；唐诗 Lite 最多 127，且输入与输出须在上下文内
`temperature`	默认 0.8，范围 0–2；0 为贪心采样
`top_p`	默认 0.9，范围 0.01–1
`stream`	当前仅支持 false；true 返回 400

GET/v1/models

需有效 Bearer Key，返回实际可用模型。feng-30m 上下文 256 tokens；Tiny Qwen3 30M 上下文 512 tokens，用于基础中文续写。TinyGPT O1 上下文 256 tokens，用于中文对话；NanoGPT 歌词上下文 256 tokens，用于歌词续写；唐诗 Lite 上下文 128 tokens，用于古诗续写；BabyLLM v13 上下文 512 tokens，用于中文文本续写。服务不可用时返回 503。

GET/health

无需登录，可查看当前模型状态。

错误与限制

`400 / 422`	请求参数无效或不支持流式输出
`401`	缺少、无效、过期或已吊销的 Key
`403`	账号已停用、无访问权限或来源不允许
`409`	重复请求或领取冲突
`429`	配额、速率或并发已达上限
`503`	model_unavailable / service_paused / identity_unverified

默认每个 Key 每日 100 次、每分钟 10 次。用户网页与 API 合计默认每日 200 次、每分钟 20 次；用户同时只能生成一次。日额度在 UTC 00:00 重置，失败不扣日额度。

请求体最多 16 KB。可使用 Idempotency-Key 防止重复提交。浏览器跨域调用需要管理员将来源加入白名单，服务器间调用无需 CORS 配置。

网页模型权限与 API Key 分开授权。API Key 无法用于网页登录。