Midjourney Tasks API 的集成与使用

简介Midjourney Tasks API 是一款强大的工具主要用于通过输入由 Midjourney Imagine API 或 Midjourney Describe API 生成的任务 ID 来查询任务的执行状态。本文将详细介绍 Midjourney Tasks API 的集成步骤帮助开发者轻松实现该 API 的功能。环境准备/前置条件在使用 Midjourney Tasks API 之前您需要在 Ace Data Cloud 上申请相应的服务并获取 API 密钥。确保您已经注册并登录到平台。详细步骤申请过程访问 Midjourney Imagine API 页面并申请服务。从 Imagine API 中复制任务 ID如下图所示接着访问 Midjourney Tasks API 页面点击“Acquire”按钮如下图所示如果您尚未登录或注册系统会自动跳转到 登录页面。首次申请的用户可以享受免费的使用配额。请求示例Midjourney Tasks API 可用于查询 Midjourney Imagine API 和 Midjourney Describe API 的结果。有关如何使用这两个 API 的信息请查看文档Midjourney Imagine API 和 Midjourney Describe API。我们以任务 ID7489df4c-ef03-4de0-b598-e9a590793434为例演示如何使用该 API。设置请求头和请求体请求头包括accept: 指定响应格式为 JSON设置为application/json。authorization: 调用 API 的密钥申请后可直接选择。请求体包括id: 上传的任务 ID。ids: 任务 ID 的数组用于批量查询。action: 任务的操作方法支持retrieve单个查询和retrieve_batch批量查询。设置如下图所示代码示例以下是使用 CURL 和 Python 的示例代码CURLcurl -X POST https://api.acedata.cloud/midjourney/tasks \ -H accept: application/json \ -H authorization: Bearer {token} \ -H content-type: application/json \ -d { id: 7489df4c-ef03-4de0-b598-e9a590793434, action: retrieve }Pythonimport requests url https://api.acedata.cloud/midjourney/tasks headers { accept: application/json, authorization: Bearer {token}, content-type: application/json } payload { id: 7489df4c-ef03-4de0-b598-e9a590793434, action: retrieve } response requests.post(url, jsonpayload, headersheaders) print(response.text)响应示例成功请求后API 将返回图像任务的详细信息。例如{ _id: 668aae3f550a4144a540803b, id: 7489df4c-ef03-4de0-b598-e9a590793434, image_url: https://platform.cdn.acedata.cloud/midjourney/7489df4c-ef03-4de0-b598-e9a590793434.png?imageMogr2/thumbnail/!50p, success: true, ... }返回结果包含多个字段具体字段说明请参考 API 文档。批量查询操作若要查询多个任务 ID 的详细信息需将操作设置为retrieve_batch。请求体示例{ action: retrieve_batch, ids: [7489df4c-ef03-4de0-b598-e9a590793434, 807f62de-c63e-4add-8345-7f0ae6dd18e7] }批量查询的代码示例CURLcurl -X POST https://api.acedata.cloud/midjourney/tasks \ -H accept: application/json \ -H authorization: Bearer {token} \ -H content-type: application/json \ -d { action: retrieve_batch, ids: [7489df4c-ef03-4de0-b598-e9a590793434,807f62de-c63e-4add-8345-7f0ae6dd18e7] }Pythonimport requests url https://api.acedata.cloud/midjourney/tasks headers { accept: application/json, authorization: Bearer {token}, content-type: application/json } payload { action: retrieve_batch, ids: [7489df4c-ef03-4de0-b598-e9a590793434,807f62de-c63e-4add-8345-7f0ae6dd18e7] } response requests.post(url, jsonpayload, headersheaders) print(response.text)错误处理调用 API 时如果发生错误API 将返回相应的错误代码和信息例如400 token_mismatched: 请求无效可能由于缺少或无效的参数。401 invalid_token: 未授权令牌无效或缺失。429 too_many_requests: 请求过于频繁超出了速率限制。500 api_error: 内部服务器错误服务器出现问题。结论通过本文您已了解如何使用 Midjourney Tasks API 查询单个或批量图像任务的具体信息。希望本文能帮助您更好地集成和使用该 API。如有疑问请随时联系技术支持团队。技术标签MidjourneyAPI集成请求示例Python错误处理