メインコンテンツへスキップ
POST
/
v1
/
midjourney
/
generations
/
describe
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/describe \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "image_urls": [
      "https://example.com/input.png"
    ],
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/describe \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "image_urls": [
      "https://example.com/input.png"
    ],
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
画像から prompt を逆生成します。通常 1〜3s で同期応答しますが、プラットフォーム標準の非同期フローに従います——送信後は通常どおりタスクをポーリングします。
項目内容
actionDESCRIBE
課金midjourney@describe[-speed]
必須image_urls（1 枚）

​
パラメータ

フィールド型必須既定説明
image_urlsstring[]はい—1 枚の画像。配列形式で、最初の 1 枚のみ使用。≤ 12 MiB
speedstringいいえrelaxrelax / fast / turbo
metadataobjectいいえ—カスタムメタデータ

​
リクエスト例

{
  "image_urls": ["https://example.com/input.png"],
  "speed": "fast"
}

​
レスポンス

テキスト結果は取得結果の prompt / description に入ります。image_urls / grid_image_url は返りません。結果は番号付きの 4 候補で、\n 区切り・数字絵文字 1️⃣2️⃣3️⃣4️⃣ のプレフィックス付きです： 
{
  "id": "task_xxx",
  "status": "SUCCESS",
  "action": "DESCRIBE",
  "mode": "DESCRIBE",
  "prompt": "1️⃣ a serene mountain lake at sunrise --ar 3:2\n2️⃣ mountain landscape with reflections --v 6.1\n3️⃣ panoramic view of alpine lake --ar 16:9\n4️⃣ dawn light over still water --s 250",
  "description": "1️⃣ a serene mountain lake at sunrise --ar 3:2\n..."
}

​
注意

  • describe は独立した処理チャネルを使い、通常の画像生成の同時実行枠を消費しません。
  • 通常 1〜3s で同期応答しますが、結果取得には GET /v1/tasks/{task_id}（または GET /v1/midjourney/{task_id}）のポーリングが必要です。
  • 画像欠落は 400、1 枚が 12 MiB を超える場合も 400 を返します。