Meshy 免费版额度怎么领：每月 100 点额度出带材质 3D 模型并商用

Meshy 的 Free 档额度只能在网页工作台里使用，API 属于 Pro 及以上订阅才开放的能力，免费账号拿不到可用的 API Key，因此下面分网页使用和 API 接入两部分说明。

网页端生成 3D 模型（免费档可用）

1. 登录后进入工作台，选择文生 3D 或图生 3D 入口：文生 3D 填提示词描述外形、风格和材质，图生 3D 上传一张主体清晰的参考图。
2. 先选预览模式跑一版草模，确认造型和比例没问题，再做贴图精修，避免草模不满意就精修导致额度白白消耗。
3. 生成完成后在结果页下载，可选 GLB、FBX、STL、OBJ、USDZ 等格式；水密模型可以直接送 3D 打印，动画需求可以用自带的自动绑定与动作库。
4. 免费档每月有 Meshy 6 Lite 的下载次数限制，下载前先确认目标格式与用途，具体剩余次数以控制台实际显示为准。
5. CC BY 4.0 授权允许商用，但发布时需要在作品说明里标注来源为 Meshy。

API 接入形态（需 Pro 订阅）

API 的 base_url 形如 https://api.meshy.ai/openapi/v1，鉴权用请求头 Authorization: Bearer <API Key>，密钥在账户的 API 页生成。常用模型名如 meshy-5、meshy-6，具体可选列表以控制台 API 文档页实际显示为准。文生 3D 是异步任务：先用 POST 创建任务拿到 result 字段作为任务 ID，再用 GET 轮询任务状态。

下面是创建文生 3D 任务的请求，把 $MESHY_API_KEY 换成你自己的密钥即可运行：

curl -X POST "https://api.meshy.ai/openapi/v1/text-to-3d" \
  -H "Authorization: Bearer $MESHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"preview","prompt":"a low-poly cartoon fox","art_style":"realistic","should_remesh":true,"topology":"triangle","target_polycount":30000}'

请求体也可以先存成文件再提交，适合在脚本里复用：

{
  "mode": "preview",
  "prompt": "a low-poly cartoon fox",
  "art_style": "realistic",
  "should_remesh": true,
  "topology": "triangle",
  "target_polycount": 30000
}

创建任务后，用返回的 result 作为任务 ID 轮询进度，状态变为成功后会给出模型文件的下载地址：

curl -s "https://api.meshy.ai/openapi/v1/text-to-3d/$TASK_ID" \
  -H "Authorization: Bearer $MESHY_API_KEY"

关键参数说明

• mode：取 preview 先出白模草图，取 refine 再上贴图精修，两步都消耗额度。
• prompt：主体描述，写清外形、风格和材质，避免一长串抽象形容词。
• art_style：控制写实或偏卡通的美术风格，影响贴图观感。
• topology 与 target_polycount：控制面数与网格类型，3D 打印或游戏引擎导入时按目标平台设定。
• should_remesh：是否重新网格化，开启后几何更规整、便于后续绑定。

额度耗尽与限流的典型表现

常见现象有三种：一是接口返回余额不足类错误，任务创建被拒；二是返回 429 状态码，说明触发了并发或频率限制，免费档是单并发、低优先级队列；三是提示无权限或密钥无效，多半是账号仍是 Free 档，而 API 需要 Pro 才有。

1. 先在控制台核对 credits 余额和本月刷新情况，确认额度是否真的用完。
2. 再确认账号档位是否支持 API，免费账号没有可用的 API Key。
3. 然后检查并发：单并发档位下不要同时提交多个任务，等前一个任务结束再发下一个。
4. 最后检查请求体参数与请求头，尤其是鉴权头和 JSON 格式，排除参数错误被误判为额度问题。