为生产级工作流打造的功能
通过一致的 API 接口提交和追踪图像任务，并使用异步回调、生成模式与参数支持满足应用的实际需求。
Webhook 交付
任务完成时通过异步回调通知。
并发任务
为并行请求处理而设计；实际并发限制依账户当前配置。
Fast 与 Relax
针对每项任务选择速度或额度效率。
Niji 支持
支持面向动漫风格的图像生成选项。
模式选择
| 模式 | 适合场景 | 权衡 |
|---|---|---|
| Fast | 面向用户的请求、付费优先流程、紧急任务 | 额度消耗较高 |
| Relax | 批量生成、后台任务、低成本管线 | 完成时间较长 |
核心功能概览
异步任务提交：短时间内取得任务 ID，让应用无需维持长时间打开的请求。
Webhook 与状态查询：任务完成后接收回调，也可以使用状态接口轮询；可根据系统架构混合使用。
生成模式与风格：按任务需要选择 Fast 或 Relax 模式，并使用 Niji 等可用选项及支持的 Midjourney 参数。
开发者认证：通过 API 密钥认证请求，并在服务端集中管理凭据与调用。
并发处理：根据账户可用限制规划任务调度，按系统容量控制并发，避免一次性发送过多请求。
典型任务流程
- 服务端提交提示词与参数，接收任务 ID。
- 保存任务状态并向用户展示排队或生成进度。
- 由 Webhook 接收完成通知；或者按退避间隔查询任务状态。
- 验证结果状态，并将图像链接及必要的任务信息保存到业务系统。
Fast 与 Relax 模式
Fast 模式适用于用户正在等待结果、对交互时延更敏感的流程。Relax 模式适合可以容忍更长等待时间的后台任务。具体可用性和资源消耗取决于账户与服务设置；选择前请核对当前产品说明。
这些功能何时最有帮助
- 需要在应用内提供即时反馈时，使用任务状态与清晰的加载界面。
- 需要降低重复查询时，为任务配置 Webhook。
- 需要持续处理请求时，使用队列和有界并发。
- 需要高可靠性时，持久化任务状态并对回调实现幂等处理。
常见问题
Webhook 与轮询可以互为补充：回调负责主要通知，轮询可作为恢复或兜底机制。请勿将 API 密钥放入公开前端，也不要假定任务提交响应就是最终图像。
核心功能详解
- 异步任务处理：生成任务默认异步，适合接入真实产品、队列和自动化流程。
- Webhook 回调：通过 hookUrl 接收结果，适合生产环境。
- 任务状态轮询：可轮询一个或多个任务 ID，适合作为原型方案或回调故障兜底。
- 任务 ID：可保存在数据库中，并在之后对账或恢复任务。
- 性能与吞吐：支持并行工作流；Fast 面向紧急请求，Relax 面向批处理和较低成本的生成。
- 提示词与模型：支持常用 Midjourney 参数、Niji 与宽高比设置。
- 开发体验：通过 API-KEY 请求头认证，REST 端点可由 Python、Node.js、cURL 与自动化工具调用。
异步 Webhook 请求示例
生产环境建议由后端提交任务并保存 taskId，然后等待结果回调，而不是频繁轮询。提交接口示例返回 status 与 data.taskId。
POST /midjourney/v1/submit-jobs
{
"prompt": "premium skincare product shot on marble --ar 4:5",
"mode": "fast",
"hookUrl": "https://yourapp.com/webhooks/midjourney"
}
Response:
{
"status": 0,
"data": { "taskId": "example_task_id" }
}典型任务生命周期
- 向 /midjourney/v1/submit-jobs 提交提示词。
- 立即接收 taskId。
- 将 taskId 与内部任务记录一起保存。
- 等待 Webhook，或轮询 /midjourney/v1/job-status。
- 将最终图像 URL 接入应用、CMS 或自动化管线。
这些功能何时重要
- SaaS 产品按需生成营销或品牌视觉。
- 内容团队需要异步图像生成的内部工具。
- 电商工作流批量生成横幅、样机和活动素材。
- 图像结果到达后需要触发后续任务的自动化系统。
Fast 与 Relax 模式对比
Fast：适用于面向用户、付费优先流程或紧急任务；代价是额度消耗更高。Relax：适用于批量生成、后台任务和低成本管线；代价是等待时间较长。
后续步骤
- Webhook 指南：实现 hookUrl 回调和异步结果处理。
- Replicate 替代方案：比较专用 Midjourney 工作流与广泛模型平台。
- 应用场景：查看 SaaS、电商和内容团队的用法。
- 快速开始：从 API 密钥开始完成第一个图像任务。
- 价格、Python 与 Node.js 页面：评估额度并选择合适集成。
常见问题
支持 Webhook 回调吗？
支持。提交任务时传入 hookUrl，图像生成完成后即可异步接收最终结果。
可以使用 Fast 和 Relax 模式吗？
可以。可根据工作流选择优先任务使用 Fast，批量生成使用 Relax。
如何检查任务进度？
可以使用一个或多个任务 ID 轮询 job-status，也可以依赖 Webhook，在结果到达时更新应用。
支持哪些 Midjourney 参数？
支持常见提示词参数，包括宽高比控制及面向动漫图像的 Niji 选项。