New API 手册 / 常见问题 FAQ

常见问题 FAQ

基础

Q:Base URL 到底填哪个?

OpenAI 兼容程序填 https://ai.moespark.dev/v1;只填根域时多数 SDK 会自动补 /v1,但建议显式带上 /v1。

Q:API Key 在哪拿?

登录 ai.moespark.dev → 控制台「令牌」→ 添加令牌 → 复制 sk-...。

Q:支持哪些模型?

以控制台「模型价格」和 /v1/models 为准,取决于管理员配置的渠道与你的分组。

Q:能免费用吗?

额度由管理员分配。新用户额度、赠送策略请咨询管理员。

使用

Q:为什么返回 403 或"无权限"?

令牌的分组/可用模型未包含该模型,或令牌被限制了 IP。请对照模型列表或联系管理员。

Q:怎么让输出稳定为 JSON?

用 response_format:{"type":"json_object"},并在 system 里强调「只输出 JSON」。参见高级用法。

Q:流式怎么处理?

逐行读取 data: 行,取 choices[0].delta.content 拼接,遇到 [DONE] 结束。

Q:能上传图片/文件吗?

支持的模型可用 content 数组传 image_url。文件类需求建议先解析为文本或走各自的文件接口。

计费

Q:为什么"没怎么用额度就没了"?

大模型单价高、长上下文输入也计费。到「日志」按令牌查看每次消耗,或改用轻量模型。

Q:令牌额度与账户额度区别?

账户额度是总量,令牌额度是给某个 Key 的上限,二者同时约束。

其它

Q:可以在前端直接调用 AI 吗?

不建议:会暴露密钥且受 CORS 限制。请经你的后端转发。

Q:请求 ID 有什么用?

响应头 x-oneapi-request-id 用于对账与排障,报问题时附上可加速定位。