|
|
这篇是一份上手笔记，按步骤把 Cherry Studio 接到 OpenAI 兼容中转。文中用到的中转站是 Yuan API（对话）和 Yuan Image（文生图）。接口和模型会调整，请以当时的文档和控制台为准，不要把密钥贴到帖子或截图里。
官方入口：
文档 https://doc.apixhm.com
对话 API https://api.apixhm.com
文生图 Yuan Image https://image.apixhm.com
一、先准备一把密钥
1. 打开 https://doc.apixhm.com ，按「注册账号 → 登录 → 充值或兑换 → 创建 API Key」走一遍。
2. 控制台在 https://api.apixhm.com 。密钥在 https://api.apixhm.com/keys 创建，模型名称以 https://api.apixhm.com/pricing 当前列表为准。
3. 复制完整密钥。列表里打码的预览不能拿来调用。
二、在 Cherry Studio 里接对话（OpenAI 兼容）
文档里的 Cherry Studio 教程：https://doc.apixhm.com/guide/cherry-studio.html
不同版本菜单名字可能略有差别，字段含义是一样的。
1. 打开 Cherry Studio，进入设置，打开「模型服务」。
2. 点「+ 添加」，新增一个 OpenAI / GPT 类型的提供商。
3. 建议这样填：
提供商名称：Yuan API
API 密钥：你的 Yuan API Key（不要加 Bearer 前缀）
API 地址（Base URL）：https://api.apixhm.com/v1
4. 地址末尾保留 /v1，不要再手动拼 /chat/completions。客户端会自己请求 /v1/chat/completions。
5. 点「获取模型列表」，等模型返回后再选一个。模型 ID 以控制台为准，不要自己改大小写或加后缀。
6. 回到聊天页，在这个提供商下选中模型，先发一句「你好」确认能回复。
说明：Claude 模型走的是另一套 Anthropic 接口，需要单独再加一个提供商，不能复用上面这个 OpenAI 提供商。本篇只写对话用的 OpenAI 兼容接法。若控制台给你的账号显示了别的线路，以控制台为准。
三、用 curl 先确认对话接口
把 YOUR_API_KEY 和模型名换成你自己的。模型名请从定价页复制。
curl https://api.apixhm.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "换成控制台里的模型 ID",
"messages": [{"role": "user", "content": "你好，用一句话介绍你自己"}]
}'
能返回 choices 里的文字，就说明密钥、地址和模型 ID 是通的，再回到 Cherry Studio 里用同一套地址。
四、Yuan Image：文生图
对话和画图不是同一个入口。文生图用 Yuan Image：https://image.apixhm.com
接口说明：https://image.apixhm.com/docs.md
文生图一节：https://image.apixhm.com/docs.md?page=images
Yuan Image 的 OpenAI 兼容 Base URL 是 https://image.apixhm.com/v1 。文生图路径是 POST /v1/images/generations。MidJourney 不走这个接口。
先看这把密钥能用哪些模型：
curl https://image.apixhm.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
再提交一次文生图。model 必须是模型目录里的公开 ID，size 要落在该模型支持的比例和分辨率里。下面的模型名只是文档示例，调用前请改成你账号当前可用的 ID。
curl https://image.apixhm.com/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "firefly-gpt-image-2",
"prompt": "a corgi running in a golden wheat field, cinematic",
"size": "1024x1024",
"response_format": "url"
}'
成功时结果在 data 里，response_format 用 url 会给一个临时地址，用 b64_json 则是内联内容。每次 JSON 请求目前生成 1 张。余额和价格以 https://image.apixhm.com 模型广场为准，失败一般会退回预扣积分。
五、常见问题
1. Cherry Studio 提示地址错误：确认填的是 https://api.apixhm.com/v1 ，没有多写 /chat/completions，也没有漏掉 https://。
2. 401 或密钥无效：用的是完整密钥，不是列表里的打码预览；请求头是 Authorization: Bearer 加空格再加密钥。Cherry Studio 的密钥框只贴密钥本身。
3. 模型不存在或 403：模型 ID 从定价页或 GET /v1/models 复制。密钥如果绑了分组，只能调用组内模型。
4. 对话通了但画不了图：画图要换到 https://image.apixhm.com/v1/images/generations ，不要把图片请求发到对话的 /v1/chat/completions。
5. 有回复但很慢或偶发失败：先看 https://doc.apixhm.com 的疑难解答，以及服务状态。换模型前先用上面的 curl 排除客户端设置问题。
参考：
https://doc.apixhm.com
https://api.apixhm.com
https://image.apixhm.com
|
|
发表于