CiYuanMax 登录

接入文档

一个正式域名，按 OpenAI、Anthropic 或 Gemini 协议接入。

开始使用

  1. 注册或登录控制台。
  2. 进入「API 密钥」，创建并保存密钥。
  3. 打开模型广场，确认当前模型 ID、分组倍率和可用状态。
  4. 按下方协议配置地址并发起请求。

不要把 API Key 发到群聊、截图、网页前端或公开代码仓库。

唯一推荐接入地址

使用方式推荐 Base URL认证
OpenAI SDKhttps://llm.ciyuanmax.art/v1Authorization: Bearer
Codex CLIhttps://llm.ciyuanmax.artBearer；兼容带 /v1
Claude Code / Anthropic SDKhttps://llm.ciyuanmax.artx-api-key 或 Bearer
Grok CLIhttps://llm.ciyuanmax.art/v1Authorization: Bearer
Gemini SDK / RESThttps://llm.ciyuanmax.artx-goog-api-key

api.ciyuanmax.art 目前仍兼容现有调用，但新配置统一使用上表中的 llm.ciyuanmax.art，避免入口混用。

OpenAI 兼容接口 / Codex

OpenAI SDK 和自定义 Provider 使用带 /v1 的 Base URL。Codex CLI 推荐填写根地址，当前也兼容带 /v1：

export OPENAI_BASE_URL="https://llm.ciyuanmax.art/v1"
export OPENAI_API_KEY="你的_API_KEY"

REST 请求示例：

curl https://llm.ciyuanmax.art/v1/responses \
  -H "Authorization: Bearer 你的_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"从模型广场复制的模型ID","input":"你好"}'

Claude Code / Anthropic

Claude Code 的 Base URL 不带 /v1，客户端会自行请求 /v1/messages：

export ANTHROPIC_BASE_URL="https://llm.ciyuanmax.art"
export ANTHROPIC_AUTH_TOKEN="你的_API_KEY"

Anthropic Messages REST 示例：

curl https://llm.ciyuanmax.art/v1/messages \
  -H "x-api-key: 你的_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":256,"messages":[{"role":"user","content":"你好"}]}'

Gemini

Gemini 原生协议使用 /v1beta/models/模型ID:generateContent：

curl "https://llm.ciyuanmax.art/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: 你的_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"你好"}]}]}'

当前接口范围

方法路径用途
GET/v1/models查询密钥可用模型
POST/v1/chat/completionsOpenAI Chat Completions
POST/v1/responsesOpenAI Responses / Codex
POST/v1/responses/compactResponses 上下文压缩
POST/v1/messagesAnthropic Messages / Claude Code
GET / POST/v1beta/models/...Gemini 原生协议
POST/v1/embeddings向量嵌入
POST/v1/images/generations图片生成

常见问题

返回 401 / API_KEY_REQUIRED

请求没有携带密钥、密钥复制不完整，或请求头名称不正确。按上表选择对应认证头。

返回 404

通常是 Base URL 重复或缺少 /v1。OpenAI 客户端填 https://llm.ciyuanmax.art/v1，Claude Code 填不带 /v1 的根地址。

模型不存在或不可用

模型 ID、分组权限或实时状态可能变化。先到模型广场复制当前模型 ID，再确认 API Key 所属分组。

请求慢或中途失败

新建短会话测试，并尝试模型广场中同模型的其他可用分组。超长上下文、上游负载和客户端超时都会影响速度。

仍然无法接入

联系微信 yundan95 或 QQ 群 984591972，并提供请求时间、接口路径、模型 ID 和请求 ID；不要发送完整 API Key。