客户端集成

将客户端中的官方 API 域名换成 HOYOAI，并填入你的 API Key。

通用原则

1. Base URL：https://api.hoyoai.cn/v1（部分客户端要求不带 /v1，报 404 时切换试一次）
2. API Key：控制台创建的令牌
3. 协议：OpenAI 客户端多用 Chat Completions / Responses；Claude Code 用 Messages；Gemini CLI 用 Gemini 原生接口
4. 模型名：以 模型广场 为准

OpenAI SDK / 兼容库

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.hoyoai.cn/v1",
)

Node.js：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.HOYOAI_API_KEY,
  baseURL: "https://api.hoyoai.cn/v1",
});

Cursor / 其他 OpenAI 兼容 IDE

在模型提供方设置中：

• API Base：https://api.hoyoai.cn/v1
• API Key：你的 HOYOAI Key
• 模型：从模型广场复制

Claude Code

1. 安装并按官方文档初始化 Claude Code
2. 将 Anthropic 相关 Base URL 改为指向 https://api.hoyoai.cn（是否带 /v1 以客户端为准）
3. 使用 HOYOAI API Key
4. 若首次启动仍访问 api.anthropic.com，先改本地配置再启动（常见为环境变量或 ~/.claude 相关配置）

示例环境变量（按你本机 Claude Code 版本调整变量名）：

export ANTHROPIC_BASE_URL=https://api.hoyoai.cn
export ANTHROPIC_API_KEY=YOUR_API_KEY

消息协议说明见 Messages。

Gemini CLI

1. 安装 Gemini CLI
2. 将 API / 代理地址指向 HOYOAI（https://api.hoyoai.cn）
3. 填入 HOYOAI Key 与可用的 Gemini 模型名

若 CLI 只认 Google 官方鉴权流程，请使用支持自定义 Base URL 的版本或配置项。

自建应用

• 服务端持有 Key，前端只调你自己的后端
• 超时建议 ≥ 60s（推理模型可更高）
• 对 429/5xx 做退避；记录 request id

仍失败时

1. 用 curl 验证 Key 与 Chat Completions（见 快速开始）
2. 确认客户端用的协议路径存在（见 API 概览）
3. 对照 FAQ