智叶 API

API 端点说明

使用智叶 API 的统一地址、访问令牌和模型目录接入应用。

地址与鉴权

服务地址：https://api.ziyelian.site。在控制台创建 API Key，并为其选择所需模型分组。令牌应保存在服务端环境变量中。

Chat Completions、Responses、Messages 和视频任务使用 Authorization: Bearer YOUR_API_KEY。Gemini 原生接口也可使用 x-goog-api-key 请求头。

接口清单

用途	方法与路径
模型目录	GET /v1/models
Chat Completions	POST /v1/chat/completions
Responses	POST /v1/responses
Messages	POST /v1/messages
Gemini 生成	POST /v1beta/models/{model}:generateContent
Gemini 流式生成	POST /v1beta/models/{model}:streamGenerateContent?alt=sse
Seedance 创建任务	POST /v1/contents/generations/tasks
Seedance 查询任务	GET /v1/contents/generations/tasks/{id}

模型及其接口类型以模型广场中所选分组的信息为准。视频任务的创建、查询和下载见Seedance 接入说明。

客户端 Base URL

Claude Code：ANTHROPIC_BASE_URL=https://api.ziyelian.site，使用根地址。
Codex 与 OpenAI 兼容客户端：https://api.ziyelian.site/v1，包含 /v1。
Gemini CLI：GOOGLE_GEMINI_BASE_URL=https://api.ziyelian.site，由客户端拼接版本和模型路径。

Base URL 与完整请求地址是不同配置项。客户端会自动拼接路径时，请勿再附加 /chat/completions、/messages 或模型方法。

读取模型目录

export ZHIYE_API_KEY='YOUR_API_KEY'
curl --fail-with-body --silent --show-error \
  https://api.ziyelian.site/v1/models \
  -H "Authorization: Bearer $ZHIYE_API_KEY"

使用响应中的完整模型 ID。不同 Key 的分组、模型范围和有效期可能不同。

地址与鉴权

接口清单

客户端 Base URL

读取模型目录

接入教程