调用 API

Base URL

Base URL复制

https://youran-ai.du-fu.com/api

所有外部请求都使用个人 API Key，并放在标准 Bearer 请求头中：

HTTP Header复制

Authorization: Bearer <YOURAN_API_KEY>

查询模型

Shell复制

curl -sS https://youran-ai.du-fu.com/api/models \
  -H "Authorization: Bearer <YOURAN_API_KEY>"

从响应的 data[].id 中选择模型。请在配置客户端前重新查询，不要依赖过去保存的模型名称。

Responses API

Codex 使用此端点。普通调用示例：

Shell复制

curl -sS https://youran-ai.du-fu.com/api/responses \
  -H "Authorization: Bearer <YOURAN_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"<MODEL_ID>","input":"请只回复：连接成功"}'

Chat Completions API

Shell复制

curl -sS https://youran-ai.du-fu.com/api/chat/completions \
  -H "Authorization: Bearer <YOURAN_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"model":"<MODEL_ID>","messages":[{"role":"user","content":"你好"}]}'

Anthropic Messages API

Claude Code 使用 /api/v1/messages 与 /api/v1/messages/count_tokens。网关会保留 anthropic-version、anthropic-beta、查询参数和 SSE 流式响应。

Shell复制

curl -sS https://youran-ai.du-fu.com/api/v1/messages \
  -H "Authorization: Bearer <YOURAN_API_KEY>" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"<MODEL_ID>","max_tokens":128,"messages":[{"role":"user","content":"你好"}]}'

当前模型范围

Anthropic Messages 是客户端协议兼容层，不表示悠然 AI 提供 Anthropic Claude 模型。当前只提供控制台模型列表中展示的 GPT 系列模型。

端点一览

方法	路径	用途
GET	/api/models	获取实时模型列表
POST	/api/responses	OpenAI Responses 请求
POST	/api/chat/completions	OpenAI Chat Completions 请求
POST	/api/v1/messages	Anthropic Messages 请求
POST	/api/v1/messages/count_tokens	Anthropic Token 预估

流式请求使用服务端发送事件。请求结束后，控制台会记录输入、缓存输入、缓存写入、输出和总 Token。