Midjourney Translate API 的对接和使用

Midjourney Translate API 的对接和使用

因为 Midjourney 的 prompt 只支持英文，所以对于一些其他语言的描述，Midjourney 并不能很好地支持，所以有一个需求就是把非中文的 prompt 转换为英文。

Midjourney Translate API 的主要功能是通过输入非英文 prompt 来获取英文的 prompt。

本文档将详细介绍 Midjourney Translate API 的对接说明，帮助您轻松集成并充分利用该 API 的强大功能。通过 Midjourney Translate API ，您可以轻松实现将非中文 prompt 转换为英文的 prompt。

申请流程

要使用 Midjourney Translate API，需要先到 申请页面 Midjourney Translate API 申请相应的服务，进入页面之后，点击「Acquire」按钮，如图所示：

如果您尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

首次申请时会有免费额度赠送，可以免费使用该 API。

请求示例

我们以一个中文 prompt 为例，演示如何使用该 API。假设中文 prompt 为：精致，无暇，洁白的天使，接下来演示如何上传中文 prompt 并获取英文 prompt。

设置请求头和请求体

Request Headers 包括：

• accept：指定接收 JSON 格式的响应结果，这里填写为 application/json。
• authorization：调用 API 的密钥，申请之后可以直接下拉选择。

Request Body 包括：

• content：上传的中文 prompt。

设置如下图所示：

代码示例

可以发现，在页面右侧已经自动生成了各种语言的代码，如图所示：

部分代码示例如下：

CURL

curl -X POST 'https://api.acedata.cloud/midjourney/translate' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "content": "精致，无暇，洁白的天使"
}'

Python

import requests

url = "https://api.acedata.cloud/midjourney/translate"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "content": "精致，无暇，洁白的天使"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

响应示例

请求成功后，API 将返回中文 prompt 翻译后的 1 条描述信息。例如：

{
  "content": "Exquisite, flawless, pure white angel"
}

可以看到，结果中有一个 content 字段，里面包含了翻译后的英文 prompt，它是对应中文 prompt 的翻译结果。

• content：生成对应的英文 prompt，可以用于图像生成任务的 prompt。

错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：

• 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
• 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
• 401 invalid_token：Unauthorized, invalid or missing authorization token.
• 429 too_many_requests：Too many requests, you have exceeded the rate limit.
• 500 api_error：Internal server error, something went wrong on the server.

错误响应示例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

结论

通过本文档，您已经了解了如何使用 Midjourney Translate API 实现将上传的非英文 prompt 翻译为英文的 prompt。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。