接口概览

基础地址

https://yfcym.top/v1

当前示例使用 new-api 的 OpenAI 兼容接口。不同模型支持的接口和参数可能不同，请以实际模型能力为准。

认证

请求头携带 API 密钥：

Authorization: Bearer YOUR_API_KEY

JSON 请求还需要 Content-Type: application/json。

查询模型

以下为 Bash / Git Bash 示例。先在当前终端设置 YFCYM_API_KEY 环境变量，再发起请求：

curl --fail-with-body 'https://yfcym.top/v1/models' \
  -H "Authorization: Bearer ${YFCYM_API_KEY}"

返回的模型列表受账户、令牌权限与站点配置影响。选择支持对话的模型用于后续示例，不要直接猜测模型名称。

常用接口

方法	路径	用途
GET	/v1/models	查询当前配置下的模型列表
POST	/v1/chat/completions	发起兼容格式的对话请求

排查原则

保留 HTTP 状态码、错误信息、请求时间以及可用的请求 ID。分享日志前移除认证头和其他敏感内容。

具体请求示例见 对话请求。