调用 API

Base URL

Base URL复制

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

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

HTTP Header复制

Authorization: Bearer <YOURAN_API_KEY>

查询模型

Shell复制

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

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

Responses API

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

Shell复制

curl -sS https://youran-ai.du-fu.com/v1/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/v1/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 使用 /v1/messages 与 /v1/messages/count_tokens。网关会保留 anthropic-version、anthropic-beta、查询参数和 SSE 流式响应。

Shell复制

curl -sS https://youran-ai.du-fu.com/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	/v1/models	获取实时模型列表
POST	/v1/responses	OpenAI Responses 请求
POST	/v1/chat/completions	OpenAI Chat Completions 请求
POST	/v1/messages	Anthropic Messages 请求
POST	/v1/messages/count_tokens	Anthropic Token 预估

流式请求使用服务端发送事件。请求结束后，控制台会记录 Responses API 的 reasoning.effort、Chat Completions API 的 reasoning_effort、Anthropic Messages API 的 output_config.effort，以及输入、缓存输入、缓存写入、输出、推理和总 Token。Responses 回包提供强度时也会用于补全；未观察到明确强度，或上游未返回推理 Token 明细时，对应字段保持为空。