用途：将 Mint 的生产 API 作为账号自有的资产流水线，集成到应用或智能体工作流中，完成认证、生成、轮询与资产获取。
主要能力：按服务选择 fast/standard/production 预设发起生成；省略 generationMode 使用推荐的 auto 流程，需要 Preview 决策时启用 review 模式；保存返回的 operation ID，通过 operation.resource 读取资产类型与 ID；用有界指数退避轮询，处理包括 partially_succeeded 在内的所有终态；通过 manifest 发现资产文件而非猜测 URL。
使用方式：先读 references/quickstart.md；需要文档概览时获取 https://docs.mint.gg/llms.txt，需要跨指南上下文时再取 https://docs.mint.gg/llms-full.txt；使用不熟悉的端点或字段前读 https://api.mint.gg/openapi.json。从环境变量读取 MINT_API_KEY，绝不打印、粘贴、传给无关服务或提交。仅在用户授权实时身份与 Credits 检查时运行 node scripts/check-connection.mjs。轮询可用 scripts/poll-operation.mjs 或等价逻辑。服务流程与审核动作见 references/service-workflows.md，资产交付见 references/assets-and-files.md，错误处理设计前读 references/errors-and-retries.md。
约束：API 创建的资源属于 Mint 账号，可经 API、MCP 与 Mint 出现。World、3D Model、Asset Pack 生成只接受一个 imageUrl 或 2–8 个 sourceImages，不可同时；Materials 与 Material Packs 只消费一个 imageUrl。Asset Pack 用自然语言提示启动，未给数量时默认 8 个资产，无专用类型时用 general_asset_pack。riggingPose 仅用于 3D Model 与 Asset Pack，只准备预览，不做绑定或动画。转换账号自有 3D Model 用 POST /v1/models/{modelId}:convert，只发请求格式与可选 name，不发外部源 URL。不要使用 provider 模型 ID，只发公开预设。totalReserved、monthlyReserved、topUpReserved 是待结算 Credits。遇 billing_required 显示计费动作并保留 operation ID。限制轮询、重试、批量与总成本，遵守 Retry-After；每账号每分钟 600 次认证请求、30 次付费工作启动，跨该账号所有 API key 共享。普通变更省略 Idempotency-Key；不确定的重试需在首次尝试前生成稳定键并仅用于该请求重试。密钥不得放入浏览器或移动客户端，应从可信服务端调用。