Midjourney Edits API 集成指南
在这篇文章中，我们将介绍如何集成 Midjourney Edits API，该 API 允许用户通过输入提示来编辑传入的图片。这为图像处理、图像生成等应用场景提供了强大的支持，尤其适合设计师、开发者以及任何需要图像处理的用户。
环境准备
在开始之前，请确保您已注册 Ace Data Cloud 并申请 Midjourney Edits API。您可以通过以下链接访问该服务页面：Midjourney Edits API。
应用流程
- 首先，登录您的账户。如果您还没有账户，请注册一个新账户。
- 登录后，点击页面上的“获取”按钮，如下图所示：
- 在您首次申请时，将会提供一个免费的配额，让您可以在不花费的情况下使用该 API。
基本使用方法
在了解了如何申请 API 后，我们接下来讨论如何使用它。基本用法是输入提示prompt、操作action和参考图像image_url，以获得处理结果。您首先需要传递一个字段action，值为generate，具体如下：
请求头设置
请求头部的设置包括：
accept: 期望接收的响应格式，这里设置为application/json。authorization: 调用 API 的密钥，可以在申请后直接选择。
请求体设置
请求体包含以下字段：
mask: 指定需要编辑和再生的图像区域的掩膜位置。split_images: 将生成的图像拆分为多张图像，默认值为false。action: 图像编辑生成任务的行为，默认为generate。image_url: 需要编辑的图像链接。prompt: 提示内容。mode: 生成模式，可选fast/relax/turbo。callback_url: 接收回调结果的 URL。
设置完成后，您可以在右侧看到生成的对应代码，如下图所示：
点击“尝试”按钮进行测试，我们可以得到如下结果：
{ "sub_image_urls": [ "https://cdn.midjourney.com/88e16dab-ef48-43a5-af73-bf24065287bc/0_0.png", "https://cdn.midjourney.com/88e16dab-ef48-43a5-af73-bf24065287bc/0_1.png", "https://cdn.midjourney.com/88e16dab-ef48-43a5-af73-bf24065287bc/0_2.png", "https://cdn.midjourney.com/88e16dab-ef48-43a5-af73-bf24065287bc/0_3.png" ], "image_url": "https://storage.fonedis.cc/attachments/1372468820912115716/1391371957878132849/cat_sitting_table_88e16dab-ef48-43a5-af73-bf24065287bc.png?ex=686ba79d&is=686a561d&hm=ad005d06f6673d6152456e04c3cbec39d062bd9df10448623fae27ddaf8b8a80&", "image_width": 960, "image_height": 1200, "progress": 100, "success": true }返回结果包含多个字段，包括：
success: 图像编辑生成任务的状态。task_id: 图像编辑生成任务的 ID。sub_image_urls: 图像生成任务的多张结果。image_url: 生成图像的链接。
我们可以通过image_url获取生成的图像。
同时，如果您需要生成相应的集成代码，可以直接复制生成的代码，例如，CURL 代码如下：
curl -X POST 'https://api.acedata.cloud/midjourney/edits' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "prompt": "A cat sitting on a table", "split_images": true, "image_url": "https://cdn.acedata.cloud/jgo1cw.jpg", "action": "generate" }'异步回调
由于 Midjourney Edits API 的生成时间相对较长，通常为 1-2 分钟，因此为了避免长时间等待而消耗系统资源，API 还支持异步回调。
整体流程如下：当客户端发起请求时，指定一个额外的callback_url字段。API 会立即返回一个包含task_id字段的结果，表示当前任务 ID。任务完成后，生成的结果将以 POST JSON 形式发送到客户端指定的callback_url，同时包含task_id字段，以便通过 ID 进行任务关联。
我们可以通过以下示例具体了解如何操作。
- 使用 Webhook 回调服务，开发者应将其替换为自己的 HTTP 服务器的 URL。为了演示，我们可以使用公共 Webhook 示例网站 Webhook.site，在此网站上获取 Webhook URL，如下图所示：
复制此 URL，作为 Webhook 使用。
- 接下来，在设置请求时，将
callback_url字段设置为上述 Webhook URL，并填写相应参数。
- 点击执行，您将看到立即返回的结果，如下所示：
json { "task_id": "b8b7fdc2-628e-40dd-bc0c-671c3ddac9e9" }
- 稍等片刻，您可以在
https://webhook.site/556e6971-b41f-4fa8-9151-6e91acd0399f观察到生成的结果。
返回内容如下：
json { "sub_image_urls": [...], "image_url": "...", "progress": 100, "success": true }
错误处理
在调用 API 时，如果发生错误，API 将返回相应的错误代码和消息。例如：
400 token_mismatched: 请求错误，可能是由于缺少或无效的参数。401 invalid_token: 未授权，授权令牌无效或缺失。429 too_many_requests: 请求过多，超过了速率限制。500 api_error: 服务器内部错误。
错误响应示例
{ "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" }总结
通过本文，您已经学习了如何使用 Midjourney Edits API 来通过输入提示编辑图像。希望这篇文章能够帮助您更好地集成和使用该 API。如果您有任何问题，请随时联系技术支持团队。
技术标签：#Midjourney #API集成 #图像处理 #AceDataCloud #开发教程