메인 콘텐츠로 건너뛰기
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~3초에 동기로 응답하지만 플랫폼 표준 비동기 플로우를 따릅니다 — 제출 후 평소처럼 작업을 폴링하세요.
항목내용
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"
}

​
응답

텍스트 결과는 조회 결과의 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~3초에 동기로 응답하지만, 결과를 얻으려면 GET /v1/tasks/{task_id}(또는 GET /v1/midjourney/{task_id})를 폴링해야 합니다.
  • 이미지 누락 시 400, 단일 이미지가 12 MiB를 초과해도 400을 반환합니다.