常见问题 FAQ

如何开始使用？

通常分为四步：注册账号、完成必要认证、创建 API Key、选择接入点并进行首次调用。更多准备内容见 快速开始。

不懂编程可以使用吗？

可以。除 API 集成外，也可以通过在线对话、第三方客户端、预设模板或内部封装产品使用模型能力。开发者则可以通过 API 或 SDK 将能力集成到业务系统中。

支持哪些模型？

Modelink 聚合多类模型系列，包括 Claude、GPT、DeepSeek、Qwen、Kimi、Doubao、GLM、Minimax 以及多模态生成模型。具体可用模型以控制台和模型广场为准。

Token 大概怎么计算？

中文通常 1～2 个汉字约为 1 个 token，英文通常 1 个单词约为 1～2 个 token，代码会受符号和结构影响。不同模型和 tokenizer 的切分方式不同，实际计费以服务返回的用量为准。作为粗略参考，1 万 token 可能对应数千到一万字中文，具体取决于语言、符号和内容结构。

免费额度能用多久？

免费额度、有效期和领取规则以 Modelink 控制台展示为准。能使用多久取决于调用频率、单次输入输出长度、选择的模型和是否使用缓存等因素。试用阶段建议先设置预算和用量告警。

为什么创建或调用 API Key 失败？

常见原因包括账号未完成必要认证、账号区域或状态不满足服务要求、API Key 被禁用、复制时带入空格换行、目标模型没有权限，或触发安全风控。建议先检查控制台账号状态、密钥状态和请求日志。

API Key 泄露怎么办？

立即禁用或删除泄露密钥，创建新密钥并更新应用配置；随后检查调用日志、用量记录和异常请求，必要时联系支持团队。

Base URL 应该怎么填？

中国大陆业务可用 https://api.qnaigc.com，海外部署或跨境访问可用 https://api.modelink.ai。OpenAI 兼容工具通常在接入点后追加 /v1，例如 https://api.qnaigc.com/v1；Anthropic 兼容工具通常填写不带 /v1 的接入点。不要把完整接口路径写进 Base URL，具体以工具的配置项说明为准。

调用速度慢怎么办？

优先检查网络区域、接入点、输入长度、模型复杂度和并发量。可尝试就近接入、精简上下文、启用流式输出、选择更轻量模型或使用缓存。若客户端主动断开，通常需要调大客户端超时时间或改用流式输出。

为什么提示模型不存在或不可用？

通常是模型 ID 填写不一致、账号未开通该模型权限、工具配置未生效，或客户端仍在使用旧配置。请以 Modelink 控制台或模型广场展示的模型标识为准，并在修改配置后重启工具。

如果你在模型广场没有找到想用的模型（如 Claude、Gemini、GPT 等），可以在模型列表中搜索并复制目标模型的全量 Model ID。拿到正确的 Model ID 后，统一通过 https://api.modelink.ai 即可正常调用。

能处理实时数据吗？

模型本身的训练知识有时间边界。若要处理实时信息，需要通过联网搜索、MCP 工具、业务 API 或在 Prompt 中直接提供最新数据。

可以用于商业项目吗？

可以用于合规的商业场景，例如智能客服、知识库问答、文档生成、数据分析、内容创作和研发辅助。涉及医疗、金融、法律等高风险场景时，应增加人工审核与合规评估。

AI 生成内容可以直接发布吗？

AI 生成内容建议作为辅助材料使用。对品牌、法律、医疗、金融、教育等关键场景，应进行人工审核、事实核验和必要润色；如所在地区或业务有披露要求，应按规定标注 AI 辅助生成。

支持批量处理吗？

支持通过循环调用、队列任务、批量接口或企业定制方案完成批量处理。批量场景要关注速率限制、任务重试、幂等和成本控制。

触发限频怎么办？

先确认是否达到请求频率、并发、RPM、TPM 或每日 token 限制。建议降低并发、增加队列、使用指数退避、精简上下文、切换更轻量模型，或按业务需要申请更高配额。

如何提交排障信息？

请提供请求时间、请求 ID、模型、状态码、错误信息、客户端或工具版本、最小复现步骤和影响范围。不要提供完整 API Key、客户隐私数据或敏感上下文。

可以离线使用吗？

云端推理服务需要联网访问，不支持完全离线使用。若业务有私有化或离线部署需求，应单独评估部署方案。