メインコンテンツへスキップ

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の一部を分析して最も重要なキーワードを識別し、より簡潔な候補Promptを5つ生成することです。このインターフェースは非常に便利です：
  • imagine 呼び出し前に長いPromptを短縮し、出力画像の関連性を向上させるために
  • 候補Promptを通じてMidjourneyが各トークンの重み付けを逆に理解し、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呼び出し時にエラーが発生した場合、対応するエラーコードとメッセージが返されます。例：
  • 400 token_mismatched：リクエスト不正、パラメータ不足または無効
  • 400 api_not_implemented：リクエスト不正、未実装
  • 401 invalid_token：認証失敗、トークン無効または未提供
  • 429 too_many_requests：リクエスト過多、レートリミット超過
  • 500 api_error：サーバー内部エラー

​
エラー応答例

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

​
まとめ

本ドキュメントを通じて、Midjourney Shorten APIを使ったPromptの分析と簡素化方法を理解いただけたと思います。このAPIは、Midjourney Imagine APIと併用することを推奨します。まずShorten APIで複数の候補を取得し、その中から最適なものを選び、Imagine APIに渡して画像生成を行います。ご不明点があれば、いつでもサポートチームまでご連絡ください。