快速开始

ModelFold 把视频生成、图像生成、对话与语音模型统一到一套 OpenAI 风格的 HTTP API 之下。你只需要一个 API Key，就能调用 192 个模型 中的任意一个。

1. 注册账号

在 ModelFold 控制台注册一个账号，完成邮箱验证。注册后账号会带有一笔初始积分余额，用于试用。

注册接口是 POST /api/auth/register，密码至少 8 位且必须同时包含字母和数字。详见 认证接口。

2. 创建 API Key

登录后进入控制台的 API Key 页面创建一个 Key。Key 形如：

mf-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

关于 Key 的两点约定：

• 同一个账号最多同时持有 10 个有效 Key。
• Key 可以随时在控制台查看或吊销；吊销后立即失效，正在使用该 Key 的请求会返回 401。

3. 发出第一个请求

所有模型调用都在 /v1 下，用 Authorization: Bearer 携带 Key：

export API_BASE="https://ai.modelfold.online/v1"   # 正式域名上线后为 https://ai.modelfold.online/v1
export MODELFOLD_API_KEY="mf-..."

curl -X POST "$API_BASE/images/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-2","prompt":"a paper boat drifting down a rainy street"}'

返回结构统一为 { ok, created, data, usage }，其中 data[0].url 是产物地址，usage 包含本次消耗的积分与扣费后的余额。

4. 查询可用模型

curl "$API_BASE/models" -H "Authorization: Bearer $MODELFOLD_API_KEY"

你也可以直接在本站 模型总览 里浏览全部模型，每个模型都有独立的参考页。

5. 理解积分

• 每次调用先检查余额，余额不足会直接返回 402，不会浪费上游额度。
• 媒体类（图像 / 视频 / 音频）按次扣积分。
• 对话类按上游返回的真实 token 数结算：先按预估预扣，拿到真实用量后多退少补。
• 上游调用失败时自动原路退款，并在响应里返回 502 与失败原因。

详细的计费口径见 定价。

下一步

• 认证方式
• 第一个请求（三种模态的完整示例）
• API 参考