1. 注册并登录账号

打开融力 AI 注册页，填写用户名、密码、确认密码及电子邮箱，发送并填写邮箱验证码。阅读并同意页面上的用户协议与隐私政策后创建账号。

已有账号可直接登录。忘记密码时，使用登录页的「忘记密码？」入口。

2. 确认可用额度与模型

登录控制台查看账户状态与可用额度。若额度不足，使用控制台当前提供的充值或兑换入口，或联系支持了解可用方式。

在模型广场选择模型，记录它的完整模型 ID、分组、端点类型及计费说明。不要仅凭模型展示名称或厂商品牌名填写请求。

3. 创建 API 密钥

1. 进入控制台的密钥管理页面，找到新增密钥入口。
2. 填写便于识别的名称，例如「我的桌面客户端」。
3. 按页面提供的选项选择分组、额度、有效期及模型等限制。新用户先选择与目标模型对应的分组。
4. 创建后使用页面提供的复制或查看功能取得完整密钥，妥善保存。

不要把密钥填入公开文档、截图或代码仓库。每个应用使用独立密钥，更方便定位用量和单独停用。

4. 配置客户端

在支持 OpenAI 兼容协议的客户端中，填写以下三个字段：

部分客户端会自动补上 /v1，此时填写网站根地址即可。保存后检查客户端最终请求路径，不应出现 /v1/v1。详细步骤见客户端配置。

5. 发送第一条消息

选中配置好的模型，发送一条短消息，例如「你好，请用一句话介绍你能做什么。」收到正常回复后，再逐步尝试更长上下文、文件或其他模型支持的能力。

如果没有收到回复，先记录完整错误提示，再按问题排查逐项检查。不要连续反复重试，以免产生重复请求。

创建与命名

登录后打开密钥管理，通过新增入口创建密钥。建议按应用和环境命名，例如「Cherry-个人」「项目A-测试」「项目A-生产」。

页面如提供额度、有效期、IP 白名单或模型限制，可根据实际需求设置。具体可配置项以你的控制台为准。创建完成后复制完整密钥；展示用的脱敏文本不能用于 API 请求。

分组、模型与额度的关系

有密钥并不代表能使用所有模型。密钥分组、账号权限、模型限制和当前服务状态都可能影响请求。遇到「无可用渠道」或「模型不可用」时，先确认完整模型 ID 与密钥分组是否匹配。

账户余额与密钥额度是不同层级的限制：账户有余额，密钥仍可能因自身额度耗尽、已过期或已停用而无法调用。

正确使用鉴权信息

本页的 OpenAI 兼容接口示例使用 HTTP 请求头：

Authorization: Bearer YOUR_API_KEY

客户端的「API Key」输入框通常只填完整密钥，不额外加 Bearer ；直接编写 HTTP 请求时才使用上面的完整请求头。其他协议可能使用不同鉴权头，请按实际协议配置。

保存、轮换与停用

• 个人客户端：只在可信设备和可信客户端中填写，避免分享包含密钥的截图。
• 开发应用：通过服务端环境变量或密钥管理系统读取，不将真实密钥打包进公开网页或移动端安装包。
• 更换密钥：先创建新密钥，更新客户端并验证成功，再停用旧密钥。
• 疑似泄露：立即停用泄露密钥，检查调用记录与额度，并联系支持协助排查。

通用配置对照

Cherry Studio 配置

1. 打开 Cherry Studio 的「设置 → 模型服务」或相近的服务商设置入口。
2. 新增自定义服务商，类型选择 OpenAI 或 OpenAI 兼容，名称可填「融力 AI」。
3. 填写融力 AI 密钥；API 地址按客户端的地址拼接规则填写上方 Base URL 或根地址。
4. 尝试获取模型列表；若需要手动添加，从模型广场复制完整模型 ID，确认密钥分组可用。
5. 保存并启用服务商，在聊天界面选中该模型，发送短消息验证。

其他兼容客户端与多协议工具

支持自定义 OpenAI 兼容服务的工具，可按通用配置表填写。对于 CC Switch 等管理多个应用与服务商的工具，先选择要配置的应用和协议，再使用该协议对应的地址与模型。

• Chat Completions：常见完整路径是 /v1/chat/completions。
• Responses：常见完整路径是 /v1/responses。模型和客户端都需要支持此端点。
• Anthropic 等其他协议：不能直接套用 Chat Completions 的请求体与鉴权头，应确认模型广场支持的端点，并遵循该客户端的对应协议说明。

若无法确认某工具如何拼接 URL，可以先使用最小 API 请求示例验证平台连接，再排查客户端设置。

地址填错，通常会发生什么？

没有适用于所有客户端的单一填写方式。判断依据是最终请求路径与所选协议，而不只是输入框里是否有 /v1。

准备请求参数

将密钥保存在环境变量中，使用你有权限的完整模型 ID 替换示例值。请求会产生实际用量，具体计费以模型广场和控制台记录为准。

export RONGLI_API_KEY="替换为你的完整密钥"
export RONGLI_MODEL="YOUR_MODEL_ID"

$env:RONGLI_API_KEY = "替换为你的完整密钥"
$env:RONGLI_MODEL = "YOUR_MODEL_ID"

发送一个聊天请求

curl https://rongli.rongliantz.cn/v1/chat/completions \
  -H "Authorization: Bearer $RONGLI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "你好，请用一句话介绍你自己。"}],
    "stream": false
  }'

import json
import os
from urllib.request import Request, urlopen
from urllib.error import HTTPError

payload = {
    "model": os.environ["RONGLI_MODEL"],
    "messages": [{"role": "user", "content": "你好，请用一句话介绍你自己。"}],
    "stream": False,
}
request = Request(
    "https://rongli.rongliantz.cn/v1/chat/completions",
    data=json.dumps(payload).encode("utf-8"),
    headers={
        "Authorization": "Bearer " + os.environ["RONGLI_API_KEY"],
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urlopen(request, timeout=120) as response:
        result = json.load(response)
    print(json.dumps(result, ensure_ascii=False, indent=2))
except HTTPError as error:
    print(error.code, error.read().decode("utf-8", errors="replace"))

const apiKey = process.env.RONGLI_API_KEY;
const model = process.env.RONGLI_MODEL;
if (!apiKey || !model) throw new Error("请先设置密钥和模型环境变量");

const response = await fetch(
  "https://rongli.rongliantz.cn/v1/chat/completions",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model,
      messages: [{ role: "user", content: "你好，请用一句话介绍你自己。" }],
      stream: false,
    }),
    signal: AbortSignal.timeout(120_000),
  }
);
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
console.log(JSON.stringify(JSON.parse(text), null, 2));

查看当前密钥可访问的模型

curl https://rongli.rongliantz.cn/v1/models \
  -H "Authorization: Bearer $RONGLI_API_KEY"

模型广场用于查看公开展示的信息；接口返回的列表还受密钥与分组等权限影响。列出模型成功后，实际推理仍可能受端点、额度与上游服务状态影响。

理解响应与流式输出

非流式 Chat Completions 响应通常从 choices[0].message 读取消息；用量字段通常位于 usage。不同模型可能还包含推理内容或其他字段，应以实际响应为准。

需要流式输出时，将 stream 设为 true，使用支持 text/event-stream 的 SSE 客户端逐段处理；不要把整个流当作单个 JSON 解析。

多模态输入、工具调用、Responses 及其他原生协议有不同请求结构。仅在模型与当前端点明确支持时使用对应参数。发生失败时，保留 HTTP 状态码、错误 JSON、发生时间及请求 ID，参见排查指南。

先体验演示流程

打开工作台，保持「演示模式」，填写提示词或载入灵感，选择比例、时长、分辨率与风格，再点击「生成视频」。演示任务完成后可以预览和下载公共样片。

接入真实视频服务

1. 在模型广场确认视频模型的完整 ID、分组、价格和实际接口说明。不要仅依据模型名称判断接口。
2. 进入工作台「API 配置」，选择「自定义 API」，填入服务地址、密钥与模型 ID。
3. 打开「接口与请求体设置」，根据真实服务修改创建路径、状态查询路径和 JSON 请求体模板。
4. 确认服务端响应包含任务编号、可识别的状态，以及完成后的可播放视频 URL。
5. 先以服务商支持的较小规格发起测试，核对计费及任务记录后再扩大使用。

工作台默认路径为创建 POST /v1/videos、查询 GET /v1/videos/{id}。这是工作台的默认适配约定，不表示融力 AI 的所有视频模型都使用该协议。特殊认证、上传表单、其他任务结构或视频内容接口可能需要扩展适配器。

避免 Base URL 重复拼接

工作台会把创建 / 查询路径追加到服务地址后面。例如，默认创建路径是 /v1/videos 时，服务地址应填写 https://rongli.rongliantz.cn，而不是带 /v1 的地址，否则会得到 /v1/v1/videos。

这与部分聊天客户端的地址填法不同。以最终 URL 和服务实际协议为判断依据，不要直接复制聊天配置到视频配置。

任务监控与视频预览

• 真实任务进度来自服务端；服务端未提供百分比时，不应把等待时间当作实际进度。
• 停止本地监控不会调用服务端取消接口，远端任务可能继续运行和计费。
• 刷新页面会中断工作台的本地监控。保留远端任务 ID，必要时联系服务提供方查询，不要立即重复提交。
• 工作台通过浏览器直接连接 API，服务必须支持本站来源的 CORS。HTTPS 页面应连接 HTTPS API。
• 视频 URL 需可被浏览器访问；过期、鉴权限制、格式不支持或下载 CORS 限制都会影响预览与下载。

不清楚视频模型协议时，请把模型 ID 和接口说明发送给技术支持确认后再配置。

以当前模型广场为准

在模型广场核对模型、分组、计费单位和适用参数。输入、输出、缓存、任务规格等可能采用不同价格。展示的估算与实际调用费用不一定相同。

本文不列固定单价或承诺免费额度。充值、兑换、套餐及其他支付方式，以登录后的控制台实际开放功能与规则为准。

账户余额与密钥额度

账户余额反映账户层面的可用资金或额度；密钥还可能有独立额度、有效期、分组、模型限制或停用状态。遇到额度相关提示时，两处都需要检查。

核对调用记录

通过控制台当前提供的用量、日志或调用记录入口，按发生时间、模型、密钥与请求 ID 查找对应记录。反馈计费问题时提供相关记录与预期结果，先脱敏，再发送至支持邮箱。

四步定位大多数连接问题

常见错误速查

同一 HTTP 状态码可能对应多种原因。下面用于初步定位，最终以响应中的错误信息和控制台记录为准。

浏览器跨域、网络与流式输出

• Failed to fetch / CORS：检查浏览器 Network 面板中的预检请求、网络错误与服务端响应。命令行成功而浏览器失败，通常需要进一步排查跨域或浏览器限制。
• Mixed Content：HTTPS 页面应调用 HTTPS API，避免浏览器拦截 HTTP 请求。
• 超时：检查本机代理、网络、模型服务状态和客户端超时。推理时间长的模型可在合理范围内增加超时。
• 流式内容解析失败：SSE 应逐段读取，不能使用一次 JSON 解析整个流；代理也可能缓冲输出。
• 有返回但没有可见文本：查看原始响应，确认客户端是否支持模型返回的推理字段、多模态内容和端点结构。

视频生成一直等待或无法播放

先确认工作台处于演示还是真实模式。真实模式需要服务端返回任务编号，并能用该编号查询状态；完成后还需要可被浏览器访问的视频 URL。

「状态无法识别」「没有任务 ID」「没有视频 URL」通常提示接口适配不一致，而不一定是模型生成失败。保留远端任务 ID，不要直接重复提交；具体见视频工作台指南。

仍然无法解决？准备这些信息

请提供发生时间与时区、使用的客户端及版本、模型 ID、所选分组、已脱敏的最终 URL 和 HTTP 状态、错误正文，以及请求 ID / 远端任务 ID（如有）。

去联系支持复制反馈模板。请删除 Authorization、Cookie、API Key、密码以及请求 URL 中的敏感参数。

账号与密钥

地址与客户端配置

用量与视频生成

复制这份反馈模板

将下面的模板复制到邮件，补充必要信息后发送。暂时不知道的字段可以留空。

主题：融力 AI 使用问题 - 简要描述

【发生时间与时区】
【使用场景】客户端 / 自建应用 / 视频工作台
【客户端名称与版本】
【模型完整 ID / 分组】
【接口路径与 HTTP 状态】请删除敏感查询参数
【错误信息】请删除密钥、Cookie、密码等敏感信息
【请求 ID / 远端任务 ID】如有
【操作步骤】
1.
2.
【预期结果】
【实际结果】
【已尝试的排查步骤】
【附件】仅提供已脱敏截图

发送之前，检查一下

如果密钥疑似泄露，请先在控制台停用并更换，再联系我们协助检查调用记录。

也可以先看看