快速开始（重要）
欢迎使用 ModelFold。本指南介绍把 ModelFold API 接入产品前需要了解的关键信息，包括模型、定价、鉴权、请求流程、限流与支持。
本页由上游官方入门指南同步翻译而来，品牌与链接已替换为 ModelFold；接口路径、参数与规则与官方文档保持一致。ModelFold 自有网关接口见 API 参考。
我们的目标是透明、务实、对开发者友好。正式上线前请仔细阅读。
1. 可用模型与 Playground
你可以在 Market 页面找到最新支持的模型：
👉 模型市场
- 新模型稳定后我们会持续上线。
- 每个模型页都链接到对应的 Playground，你可以在调用 API 之前直接在界面里测试与实验。
- Playground 是了解模型行为、参数与输出格式的最佳场所。
2. 定价
完整且最新的价格表在这里：
👉 定价
- ModelFold 为所有模型提供统一的 API 与统一的积分余额。
- 价格可能调整，请始终以定价页为准。
3. 创建与保护 API Key
在这里创建和管理 API Key：
重要的安全说明：
- 绝不要在前端代码中暴露 API Key（浏览器、移动应用、公开仓库）。
- 把 API Key 当作机密信息对待。
为了保护你的用量，我们提供：
- 按 Key 的限流（每小时、每天与总量上限）
- IP 白名单，只允许批准过的服务器 IP 访问 API
这些能力可以帮助避免意外超用与未授权请求。
4. 必需的请求头
每个 API 请求都必须带上正确的请求头：
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/jsonJSON 请求体使用 Content-Type: application/json（文件流上传使用 multipart/form-data）。
如果请求头缺失或不正确，可能会收到：
{"code":401,"msg":"You do not have access permissions"}/api/v1/* 与上传端点的错误会以 HTTP 200 返回，错误码在响应体的 code 字段里（例如 {"code":429,…}）。请始终检查 code。
排查鉴权问题时，请先确认请求头是否正确。
5. 日志与任务详情
你可以在控制台查看历史任务：
👉 控制台
每个任务可以查看：
- 创建时间
- 使用的模型
- 输入参数
- 任务状态
- 积分消耗
- 最终结果或错误详情
如果你怀疑积分扣费有误，这里是对账的依据。
6. 数据保留策略
请注意以下保留规则：
- 生成的媒体文件：保存 14 天，之后自动删除
- 日志记录（文本 / 元数据）：保存 2 个月，之后自动删除
如果需要长期访问，请及时把结果下载并保存到你自己的存储中。
7. 异步任务模型
图像、视频与音乐生成任务是异步的：先创建任务，然后查询任务详情或接收回调。对话模型是同步的，直接在响应里返回结果。
成功的请求会返回 {"code": 200, "data": {"taskId": "…"}}。
状态校验
200 OK 只代表任务创建成功，不代表任务已经完成。
要获取最终结果，你必须二选一：
- 在请求里提供回调（webhook）地址，或
- 使用
data.taskId轮询GET /api/v1/jobs/recordInfo?taskId=…（获取任务详情）
8. 限流与并发
默认应用以下限制：
- 每 10 秒最多 20 个新的生成请求
- 通常可支持 100+ 个并发运行中的任务
- 限制按账号计算
超过限制时：
- 请求返回
code 429 - 被拒绝的请求不会进入队列
对大多数用户来说这已经足够。如果持续遇到 429，可以联系支持申请更高额度 —— 审批会谨慎处理。
9. 开发者支持
推荐的支持入口在控制台左下角菜单：
- Discord 获取帮助
- Telegram 获取帮助
你可以获得：
- 私密的一对一支持
- 你的数据与对话保持机密
- 更快、更技术化的回复
支持时段： UTC 21:00 – 次日 UTC 17:00（北京时间 05:00 – 次日 01:00）
也可以通过控制台的支持入口留言，但这不是首选或最快的方式。
10. 稳定性预期
我们以非常激进的价格提供顶级、极具竞争力的 API。
需要说明的是：
- 我们并不完美
- 偶尔会出现不稳定的情况
- 这是有意识的取舍
实际上，ModelFold 足够稳定，可以支撑生产负载与长期业务增长，但我们希望提前设定现实的预期。
11. 关于团队
ModelFold 由一支小型创业团队构建。
- 我们行动很快
- 我们非常在意开发者体验
- 我们持续改进
同时我们也承认：
- 并非一切都完美
- 我们无法立刻满足所有用例
你的反馈会帮助我们改进 —— 我们真心感谢。