快速开始
本页用一个最小请求验证 API Key、网络和模型是否都已配置正确。
1. 创建 API Key
登录 SpeedyRPM 控制台,进入令牌管理并创建一枚新令牌。复制后妥善保存;不要把真实密钥写入代码、聊天或 Git 仓库。
在终端中设置环境变量:
bash
export SPEEDYRPM_API_KEY="sk-your-key"2. 获取可用模型
bash
curl --fail-with-body https://relay.withrpm.org/v1/models \
-H "Authorization: Bearer $SPEEDYRPM_API_KEY"从响应的 data[].id 中选择一个模型 ID。后续示例用 <MODEL_ID> 表示它。
3. 发起一次对话
bash
curl --fail-with-body https://relay.withrpm.org/v1/chat/completions \
-H "Authorization: Bearer $SPEEDYRPM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "<MODEL_ID>",
"messages": [
{"role": "user", "content": "用一句话介绍你自己"}
]
}'成功时会返回 JSON,正文通常位于 choices[0].message.content。
4. 生成第一段语音(可选)
账户已开通语音模型时,将 <SPEECH_MODEL_ID> 替换为管理员提供且在 /v1/models 可见的语音模型 ID(如 fish-speech):
bash
curl --fail https://relay.withrpm.org/v1/audio/speech \
-H "Authorization: Bearer $SPEEDYRPM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"<SPEECH_MODEL_ID>","input":"你好,欢迎使用语音服务。","response_format":"mp3"}' \
--output speech.mp3请求成功后播放 speech.mp3。这是同步音频响应,不需要轮询任务;单次合成约 100 秒上限,长文本请用异步任务。音色、克隆音色、支持格式和失败处理见语音合成。
5. 接入客户端
- 使用 CC Switch 一键接入(推荐):参阅 CC Switch
- 使用 Codex CLI:参阅 Codex CLI
- 使用 Python 或 JavaScript:参阅 OpenAI SDK
- 查看完整请求说明:参阅 API 概览
不要共享密钥
需要让其他人使用时,请为对方创建独立的 API Key。不要共享你的个人密钥,也不要把密钥放在截图或配置示例里。