Documentation Index
Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
Use this file to discover all available pages before exploring further.
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.xhuoapi.ai/v1/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.xhuoapi.ai/v1/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"
}
