Skip to content

快速开始 ​

本页用一个最小请求验证 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. 接入客户端 ​

不要共享密钥

需要让其他人使用时,请为对方创建独立的 API Key。不要共享你的个人密钥,也不要把密钥放在截图或配置示例里。

OpenAI-compatible API gateway