跳转到主要内容
Midjourney Shorten API 的主要功能是接入 Midjourney 官方的 /shorten（Prompt 分析）指令，对一段 Prompt 进行分析，识别其中权重最高的关键词，并生成 5 条更精简的候选 Prompt。该接口非常适合：
  • 在调用 imagine 之前对长 Prompt 进行瘦身，提高出图相关性；
  • 通过候选 Prompt 反向理解 Midjourney 对各个 token 的权重，便于 Prompt 工程；
  • 配合自动化流水线，对用户输入的 Prompt 做关键词归并和精简。
本文档将详细介绍 Midjourney Shorten API 的对接说明，帮助您轻松集成该 API。

​
申请流程

要使用 Midjourney Shorten API，首先到 Ace Data Cloud 控制台 获取您的 API Token，留作备用。 如果你尚未登录或注册，会自动跳转到登录页面邀请你注册和登录，完成后会自动返回当前页面。 一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。 首次申请会赠送免费额度，可免费体验；额度不足时可在 控制台 充值通用余额。
📘 完整文档：Midjourney Shorten API →

​
请求示例

我们以一段较长的 Prompt 为例，演示如何使用该 API 对其进行分析与精简。

​
设置请求头和请求体

Request Headers 包括：
  • accept：指定接收 JSON 格式的响应结果，这里填写为 application/json。
  • authorization：调用 API 的密钥，申请之后可以直接下拉选择。
Request Body 包括：
  • prompt：要分析与精简的 Prompt 文本，建议输入英文。

​
代码示例

​
CURL

curl -X POST 'https://api.acedata.cloud/midjourney/shorten' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "prompt": "a serene mountain lake at sunrise, mist rising from the water, towering pine trees on the shore, golden hour lighting, ultra detailed, cinematic, 35mm film photography style, masterpiece --ar 16:9 --v 6"
}'

​
Python

import requests

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

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

payload = {
    "prompt": (
        "a serene mountain lake at sunrise, mist rising from the water, "
        "towering pine trees on the shore, golden hour lighting, ultra "
        "detailed, cinematic, 35mm film photography style, masterpiece "
        "--ar 16:9 --v 6"
    )
}

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

​
响应示例

请求成功后，API 将返回最多 5 条精简后的候选 Prompt。例如： 
{
  "prompts": [
    "a serene mountain lake at sunrise, mist rising from the water, golden hour lighting --ar 16:9",
    "mountain lake sunrise with mist, golden light --ar 16:9 --v 6",
    "tranquil alpine lake, dawn mist, warm golden tones, cinematic --ar 16:9",
    "sunrise over a misty mountain lake, rich golden hour photography --ar 16:9 --style raw",
    "misty lake at dawn, mountains in background, golden sunrise --ar 16:9"
  ]
}
可以看到，结果中有一个 prompts 字段，里面包含了若干个精简候选 Prompt，每条都保留了 Midjourney 内部权重最高的关键词，并去掉了重复或冗余的描述。

​
错误处理

在调用 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 Shorten API 对 Prompt 进行分析与精简。建议将该接口与 Midjourney Imagine API 结合使用：先用 Shorten API 获取多条精简候选，再选择最合适的一条传入 Imagine API 进行出图。如有任何问题，请随时联系我们的技术支持团队。