diff --git a/docs/FAQ.md b/docs/FAQ.md index dde0f8221a56ec69a1f473f29ee1c5c57c7faa15..ab131975ea1012d5dc090d2e9722f309a240609a 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -4,17 +4,17 @@ sidebar_position: 3 hide_table_of_contents: true --- -## 模力方舟平台常见问题解答 (FAQ) +# 模力方舟平台常见问题解答 (FAQ) --- -### 第一部分：模型广场（API调用） +## 第一部分：模型广场与 API 调用 #### Q1：为什么标注为“免费”的模型无法使用？ 用户需购买任意金额的全模型资源包，并创建一个访问令牌（Token），使用该令牌即可调用免费的API服务。 #### Q2：模型API访问速度较慢，能否为账号增加专属实例？ -模型广场的API资源为公共池，不支持单账号扩容。如有高并发业务需求，请使用“专属算力部署”服务（[{{SITE_URL}}/compute-deploy]({{SITE_URL}}/compute-deploy)），部署独享资源以避免干扰。 +模型广场的 API 资源为公共池，不支持单账号扩容。当前 Serverless API 不单独限制并发，但如果您有高并发业务需求，建议使用“专属算力部署”服务（[{{SITE_URL}}/compute-deploy]({{SITE_URL}}/compute-deploy)），部署独享资源以避免干扰；如需进一步评估资源方案，也可以 [联系我们](appendix/contact)。 #### Q3：异步任务出现大量调用错误是什么原因？ 单个用户同时创建的异步任务上限为5个，请检查当前任务并发数是否超限。 @@ -25,9 +25,74 @@ hide_table_of_contents: true #### Q5：各类异步任务的完成时长大概是多少？ 平均耗时参考如下：音频生成任务约1-2分钟；视频生成任务视分辨率而定，平均约20分钟；OCR识别任务约1-5分钟（多页PDF文件可能延长）。 +#### Q6：购买前是否可以体验？ +在购买之前，您可以在 [AI 模型广场]({{SITE_URL}}/serverless-api) 免费体验所有精选模型。 + +![免费体验模型](/img/base/serverless-api-flux-1-schnell.png) + +选择“免费体验访问令牌”即可享受免费体验，每位用户每日拥有 100 次免费调用次数： + +![调用次数](/img/base/counts.png) + +#### Q7：如何查看和管理已购买的资源？ +下单并支付完成 Serverless API 或应用后，我们会为您准备对应的服务。准备完成后，您可以在工作台对应资源的页面，看到您所购买的资源。 + +![输入图片说明](/img/base/serverless-api.png) + +#### Q8：组织下的资源如何管理？ +切换到组织工作台下： + +- 组织创建者和管理员可以在工作台管理已创建的资源、订单和费用等。 +- 组织成员则可以在工作台查看已购买的模型引擎和 Serverless API，并且管理自己创建的模型和数据集。 + +#### Q9：如何查看资源的使用情况和消耗量？ +在工作台 - 统计和日志下，您可以查看所有资源的用量统计和使用日志。 + +![输入图片说明](/img/base/usage-statistics.png) + +#### Q10：已购买的资源，可以退款吗？ +- 已使用的 Serverless API 暂不支持退款。 + +#### Q11：账户余额怎么提现？ +目前我们不支持线上提现，如果您有提现需求，请 [联系我们]({{SITE_URL}}/about)。 + +#### Q12：支付成功，但支付页提示“订单仍未支付”怎么办？ +如果您已完成支付，但返回支付页面点击 **已完成支付** 按钮时提示“订单仍未支付”，请通过向 gitee-ai@oschina.cn 发送邮件与我们联系。 + +在邮件内，您需要提供该笔**订单的订单号，以及对应的付款软件的付款截图。** + +#### Q13：提示访问令牌无效怎么办？ +请核对“令牌”是否正确，或检查令牌是否已被删除而无法继续使用。 + +#### Q14：提示访问令牌无任何可用资源怎么办？ +请核对“令牌”是否已授权已购买资源，或检查授权资源是否已过期或使用完毕。 + +#### Q15：提示临时令牌无效怎么办？ +请核对“令牌”是否正确，或检查其绑定的“访问令牌”是否已被删除，或者该临时令牌本身是否已失效。 + +#### Q16：提示临时令牌无任何可用资源怎么办？ +请核对绑定的“访问令牌”是否已授权已购买资源，或检查授权资源是否已过期或使用完毕。 + +#### Q17：接口调用常见报错如何排查？ + +| 状态码 | 异常信息(中文) | 异常信息（英文） | 备注 | +| ------ | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 400 | 服务不存在 | Service not found | 请求路径不正确，请重新在体验接口中复制 URL。 | +| 400 | 已达到最大当日免费API使用次数, 请购买资源后继续使用API。 | Today the free API access limit exceeded. | 当前调用接口的访问令牌为“**免费体验访问令牌**”，每日限制接口调用次数，当前已达到最大调用次数，可付费购买资源包后配置付费访问令牌。 | +| 400 | 该令牌不能访问任何资源，请绑定或购买资源后使用 | The access token cannot access any resources, purchase or authorize resources to use the access token | 请核实该“访问令牌”是否已授权购买资源包，并且该资源包可用于调用该接口，可在“[**访问令牌**]({{SITE_URL}}/dashboard/settings/tokens)”界面进行重新配置。 | +| 400 | 资源未购买或未授权,请购买或授权资源后再使用 | Resources are not purchased or authorized. Purchase or authorize resources before using them. | 请核实是否已购买资源包，或该资源包是否已用尽或过期，并且该访问凭证已授权该资源，可在“[**访问令牌**]({{SITE_URL}}/dashboard/settings/tokens)”界面进行重新配置，或续费“[**资源包**]({{SITE_URL}}/dashboard/serverless)”。 | + +#### Q18：接口升级后该使用哪个地址？ +接口已全面升级，推荐使用兼容 OpenAI 的新接口，以获得更好的兼容性和长期支持。 + +- OpenAI 格式：https://api.moark.com/v1 +- Anthropic 格式：https://moark.com/anthropic + +新接口文档请参考：[OpenAPI 文档](../openapi/v1)。如果您仍需使用旧接口，请参考上述文档，但建议尽快迁移至新接口，以享受更优体验。 + --- -### 第二部分：AI技能认证（国产芯片联合项目） +## 第二部分：AI技能认证（国产芯片联合项目） #### Q1：如何参加AI技能认证？ 请访问官方认证页面（[{{SITE_URL}}/certification]({{SITE_URL}}/certification)），根据您感兴趣的芯片厂商选择对应的认证通道。 @@ -43,7 +108,7 @@ hide_table_of_contents: true --- -### 第三部分：算力市场（算力租用与环境配置） +## 第三部分：算力市场（算力租用与环境配置） #### Q1：平台的计费模式是怎样的？ 主要包含两种模式： @@ -88,10 +153,12 @@ Jupyter Lab仅适合上传小文件（建议十兆以内），大文件请通过 --- -### 第四部分：模型微调 +## 第四部分：模型微调 #### Q1：是否有文本生成微调数据的示例？ 是的。数据格式示例请参考：[https://ai-assets.gitee.com/docs/assets/files/example-c83305527a14e647b3572952b934e84b.jsonl](https://ai-assets.gitee.com/docs/assets/files/example-c83305527a14e647b3572952b934e84b.jsonl)；具备结构化思考能力的训练数据集示例请参考：[{{SITE_URL}}/datasets/wang-tu1357/gsm8k_thinking_chinese/tree/master]({{SITE_URL}}/datasets/wang-tu1357/gsm8k_thinking_chinese/tree/master)。 #### Q2：图像微调开始处理后进度条未动，是什么原因？ -可能的原因包括数据正在预处理中或服务处理异常。请尝试刷新页面或重新上传，若问题持续，请联系平台技术支持。 \ No newline at end of file +可能的原因包括数据正在预处理中或服务处理异常。请尝试刷新页面或重新上传，若问题持续，请联系平台技术支持。 + +--- diff --git a/docs/appendix/qa.md b/docs/appendix/qa.md deleted file mode 100644 index c4e8ce56c098a790eca64d85eada526178f6dbb9..0000000000000000000000000000000000000000 --- a/docs/appendix/qa.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -sidebar_position: 4 ---- -# 常见问题 - -欢迎查看模力方舟的常见问题汇总，以下为各板块常见问题的解决方案： - -## 令牌常见问题 - -### 访问令牌常见问题 - -- 提示令牌无效，请核对"令牌"是否正确或检查令牌是否被删除无法使用。 - -- 提示令牌无任何可用资源，请核对"令牌"是否授权已购买资源，或检查授权资源是否过期或使用完毕。 - -### 临时令牌常见问题 - -- 提示"令牌无效"，请核对"令牌"是否正确或绑定的"访问令牌"已删除或该令牌已失效 - -- 提示"令牌无任何可用资源"，请核对绑定"访问令牌"是否授权已购买资源，或检查授权资源是否过期或使用完毕。 - -### 接口调用常见问题 - -| 状态码 | 异常信息(中文) | 异常信息（英文） | 备注 | -| ------ | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 400 | 服务不存在 | Service not found | 请求路径不正确，请重新在体验接口中复制URL | -| 400 | 已达到最大当日免费API使用次数, 请购买资源后继续使用API。 | Today the free API access limit exceeded. | 当前调用接口的访问令牌为"**免费体验访问令牌**",每日限制接口调用次数，当前已达到最大调用次数，可付费购买资源包后配置付费访问令牌。 | -| 400 | 该令牌不能访问任何资源，请绑定或购买资源后使用 | The access token cannot access any resources, purchase or authorize resources to use the access token | 请核实该"访问令牌"是否授权已够买资源包，并且该资源包可用于调用该接口，可在"[**访问令牌**]({{SITE_URL}}/dashboard/settings/tokens)"界面进行重新配置。 | -| 400 | 资源未购买或未授权,请购买或授权资源后再使用 | Resources are not purchased or authorized. Purchase or authorize resources before using them. | 请核实是否已购买资源包或该资源包是否已用尽或过期，并且该访问凭证已授权该资源，可在"[**访问令牌**]({{SITE_URL}}/dashboard/settings/tokens)"界面进行重新配置或续费"[**资源包**]({{SITE_URL}}/dashboard/serverless)"。 | - -## 模型广场常见问题 - -### Serverless API 支持多少并发？ - -目前 Serverless API 背后是一个统一的算力池，灵活调度。Serverless API 不对并发做限制，如果您遇到了并发问题，随时欢迎 [联系我们](docs/appendix/contact.md) 添加资源。 - -### 购买前是否可以体验？ - -在购买之前，您可以在 [AI 模型广场]({{SITE_URL}}/serverless-api) 免费体验所有精选模型。 - -![免费体验模型](/img/base/serverless-api-flux-1-schnell.png) - -选择 “免费体验访问令牌” 即可享受免费体验，每位用户每日拥有 100 次免费调用次数： - -![调用次数](/img/base/counts.png) - -### 如何查看和管理已购买的资源？ - -下单并支付完成 Serverless API 或应用后，我们会为您准备对应的服务，准备完成后，您可以在工作台对应资源的页面，看到您所购买的资源。 - -![输入图片说明](/img/base/serverless-api.png) - -### 组织下的资源如何管理？ - -切换到组织工作台下 - -- 组织创建者和管理员可以在工作台管理已创建的资源、订单和费用等。 -- 组织成员则可以在工作台查看已购买的模型引擎和 Serverless API，并且管理自己创建的模型和数据集。 - -### 如何查看资源的使用情况和消耗量？ - -在工作台 - 统计和日志下，您可以查看所有资源的用量统计和使用日志。 - -![输入图片说明](/img/base/usage-statistics.png) - -### 已购买的资源，可以退款吗？ - -- 对于模型引擎，若还有使用时长，删除资源，即可产生退款，根据未使用的时长折算金额，退还至您的账户余额。 -- 已使用的 Serverless API 暂不不支持退款。 - -### 账户余额怎么提现？ - -目前我们不支持线上提现，如果您有提现需求，请 [联系我们]({{SITE_URL}}/about) 。 - -### 支付成功，但支付页提示“订单仍未支付” - -如果您已完成支付，但返回支付页面点击 **已完成支付** 按钮时提示“订单仍未支付”，请通过向 gitee-ai@oschina.cn 发送邮件与我们联系。 - -在邮件内，您需要提供该笔**订单的订单号，以及对应的付款软件的付款截图。** - -### 接口升级 - -接口已全面升级，推荐使用兼容 OpenAI 的新接口，以获得更好的兼容性和长期支持。 - -🔗 **新接口文档**：[文档链接](../openapi/v1) - -🚀 **升级亮点** - -- 兼容 OpenAI API，便于迁移和集成。 - -如果您仍需使用旧接口，请参考上述文档，但建议尽快迁移至新接口，以享受更优体验。 diff --git a/docs/appendix/refund.md b/docs/appendix/refund.md new file mode 100644 index 0000000000000000000000000000000000000000..c0933edc248fb6c18ebc007de77f2a07434488a5 --- /dev/null +++ b/docs/appendix/refund.md @@ -0,0 +1,43 @@ +--- +sidebar_position: 4 +--- + +# 退款规则 + +请仔细阅读以下规则。您的购买或退款行为即视为您已同意本规则的全部内容。 + +## 1. 可退款范围与基本原则 + +* **仅限实付本金：** 账户余额中的“可提现/可退款金额”仅限于您通过支付宝、微信、对公转账等渠道**实际支付且尚未消耗**的人民币本金部分。 +* **赠送金额不可退：** 平台在各类运营活动中向您发放的**代金券、算力券、折扣券或通过其他方式发放的奖励金额**，仅限在 MoArk 平台内抵扣服务消耗，不具备法定货币的流通属性，**不支持提现或退款**。 + +## 2. 退款金额计算方式 + +申请退款时，最终退还金额将按照以下公式计算，并受相关条件限制： + +* **实际退款金额 = 累计实付购买本金 - 已消耗的实付本金 - 支付渠道手续费（如适用）** +* **手续费说明：** 如因第三方支付渠道（如微信支付、支付宝）在您充值时已收取了交易手续费（通常为 0.6%）。在您发起退款时，该部分手续费将由退款申请方承担，平台将在退款总额中直接扣除此费用。 +* **残值下限：** 当账户内剩余可退本金小于人民币 10 元时，因覆盖转账手续费及人工核算成本，原则上不提供部分退款服务（销户退款除外）。 + +## 3. 特殊业务场景说明 + +* **发票限制：** 若您针对历史购买订单已经申请并开具了发票，您必须在申请退款前**先完成纸质发票退回或电子发票红冲流程**。财务部门在确认原发票已作废后，方可进入退款打款流程。若无法退回发票，平台有权拒绝退款请求或扣除与发票金额等额的税费成本。 +* **软硬件一体化产品：** 若您的账户余额与特定硬件设备（如 PocketClaw 等软硬一体产品）绑定交付，且硬件设备已被激活或超出七天无理由退货期，因配套算力或 API 权益已与硬件产生不可逆的绑定关联，相关配套余额不支持单独申请退款。 + +## 4. 退款申请流程与周期 + +为保障您的资金安全并进行精确的账务核对，平台不支持余额“一键提现”。退款须通过人工审核流程： + +1. **发起申请：** 请使用您的注册账号关联邮箱，发送退款申请邮件至客服邮箱（chenxiyu@oschina.cn），需提供账号信息、手机号、订单号、订单支付交易截图及退款原因。 +2. **人工审核：** 我们的账务团队将在收到申请后的 **5-7 个工作日** 内完成后台账单核对与审核。 +3. **原路退回：** 审核通过后，退款资金将通过原支付渠道原路退回。款项实际到账时间取决于第三方支付机构或银行的处理速度（通常为 1-7 个工作日）。对于对公转账购买的用户，款项将退回至原打款的对公银行账户。 + +## 5. 限制与违约条款 + +* 每笔独立的**订单**，仅支持发起**一次**退款申请。 +* **购买**发生之日起超过 180 天的**订单**，视为已转化为平台的长期预留算力资源，不再支持退款。 +* 若系统检测到账号存在恶意刷单、频繁**购买**退款、利用漏洞白嫖赠金等异常行为，平台有权冻结账号余额、拒绝退款申请，并保留追究法律责任的权利。 + +## 6. 争议解决 + +本规则受中华人民共和国法律管辖。在退款过程中如发生争议，双方应首先通过友好协商解决；协商不成的，任何一方均有权将争议提交至我司所在地（深圳市）有管辖权的人民法院诉讼解决。 diff --git a/docs/billing/refund.md b/docs/billing/refund.md deleted file mode 100644 index 605b0abcc1c82b87e96fa8bf170ee98194ffdcb4..0000000000000000000000000000000000000000 --- a/docs/billing/refund.md +++ /dev/null @@ -1,23 +0,0 @@ -# 退款须知 - -模力方舟平台支持账户余额的退款申请，但不支持模型资源包余额的退款。请在申请退款前仔细阅读以下说明： - -## 退款范围 - -- **可退款余额**：仅限于您账号中的账户余额（即未用于任何消费的充值金额）。 -- **不可退款余额**：已购买的模型资源包中的剩余额度，无法直接申请退款。 - -## 退款流程 - -1. 登录模力方舟平台账号，进入【工作台】-【费用中心】页面。 -2. 确认您的账户余额为可退款金额。 -3. 提交退款申请，填写相关信息并等待平台审核。 -4. 审核通过后，平台将在规定时间内将退款金额退回至您的原支付账户。 - -## 注意事项 - -- 已购买的模型资源包余额仅可用于平台内模型调用服务，不能兑换或退还现金。 -- 退款仅针对钱包余额，模型资源包余额不在退款范围内。 -- 使用各类优惠券获取的金额不可退款。 - -若有疑问或特殊情况，请 [联系平台客服](/docs/appendix/contact) 协助处理。