跳轉到主要內容
Midjourney Shorten API 的主要功能是接入 Midjourney 官方的 /shorten（Prompt 分析）指令，對一段 Prompt 進行分析，識別其中權重最高的關鍵詞，並生成 5 條更精簡的候選 Prompt。該介面非常適合：
  • 在調用 imagine 之前對長 Prompt 進行瘦身，提高出圖相關性；
  • 通過候選 Prompt 反向理解 Midjourney 對各個 token 的權重，便於 Prompt 工程；
  • 配合自動化流水線，對用戶輸入的 Prompt 做關鍵詞歸併和精簡。
本文檔將詳細介紹 Midjourney Shorten API 的對接說明，幫助您輕鬆集成該 API。

​
申請流程

要使用 Midjourney Shorten API，需要先到申請頁面 Midjourney Shorten API 申請相應的服務，進入頁面之後，點擊「Acquire」按鈕。 如果您尚未登入或註冊，會自動跳轉到登入頁面邀請您來註冊和登入，登入註冊之後會自動返回當前頁面。 首次申請時會有免費額度贈送，可以免費使用該 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，可能由於缺少或無效參數。
  • 400 api_not_implemented：Bad request，可能由於缺少或無效參數。
  • 401 invalid_token：Unauthorized，無效或缺少授權令牌。
  • 429 too_many_requests：Too many requests，您已超出速率限制。
  • 500 api_error：Internal server error，伺服器發生錯誤。

​
錯誤響應示例

{
  "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 進行出圖。如有任何問題，請隨時聯繫我們的技術支援團隊。