DOCS · 连接器

接口文档

站点对外只开一条门：/v1，OpenAI 兼容。任何支持 OpenAI 协议的客户端填上 Base URL 和密钥就能用。

认证

Authorization: Bearer zk_live_xxxxxxxxxxxxxxxx

密钥在控制台申请，明文只显示一次。按权限范围（scope）授权：llm /image /video /device /files，可加 IP 白名单、每日限额、有效期；吊销与轮换立即生效。

去申请密钥

端点

POST/v1/chat/completions对话补全，支持 stream（SSE），字段与 OpenAI 一致

GET/v1/models按密钥权限返回可用模型清单

GET/v1/usage本密钥用量：今日、累计、最近记录

POST/v1/images/generations图像生成（待服务器接入图像模型后开放）未开放

POST/v1/videos/generations视频生成，异步任务（规划中）未开放

调用示例

curl https://api.zykt.space/v1/chat/completions \
  -H "Authorization: Bearer $ZYKT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role":"user","content":"你好"}],
    "stream": true
  }'

输入总字符上限约 32,000；超限返回 413。后端是服务器本地模型（CPU），并发闸门默认 2，长回答建议开 stream。

错误码

400invalid_request_error请求体不合法

401invalid_api_key缺少 / 无效 / 已吊销 / 已过期

403ip_not_allowedIP 不在白名单

403insufficient_scope密钥无该能力权限

413—输入过长

429rate_limit_exceeded超每日限额（带 Retry-After）

429quota_exhausted总配额用完

503upstream_unavailable铸想后端不在线

完整说明（含第三方客户端接入表）见仓库 docs/API.md。