Перейти к основному содержанию
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), но следует стандартному асинхронному потоку платформы — опрашивайте задачу после отправки.
ItemЗначение
actionDESCRIBE
Тарификацияmidjourney@describe[-speed]
Обязательноimage_urls (1 изображение)

​
Параметры

ПолеТипОбязат.По умолчаниюОписание
image_urlsstring[]Да—Одно изображение; в форме массива, используется только первое; ≤ 12 MiB
speedstringНетrelaxrelax / fast / turbo
metadataobjectНет—Пользовательские метаданные

​
Пример запроса

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

​
Response

Текстовый результат находится в prompt / description результата запроса; image_urls / grid_image_url не возвращаются. Результат — четыре пронумерованных предложения, разделённых \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; одно изображение больше 12 MiB возвращает 400.