mj-turbo-shorten의 기술 사양
| 항목 | 세부 정보 |
|---|---|
| 모델 ID | mj-turbo-shorten |
| 모델 계열 | Midjourney / Midjourney-proxy-style prompt analysis endpoint |
| 주요 기능 | 긴 Midjourney 프롬프트를 분석하여 의도를 유지하면서 짧게 줄이는 제안을 반환 |
| 연계 모드 | Turbo 모드 |
| 일반적인 엔드포인트 패턴 | /mj-turbo/mj/submit/shorten |
| 요청 방식 | 비동기 작업 제출 후 작업 상태 조회 |
| 공통 요청 필드 | prompt, botType |
일반적인 botType 값 | MID_JOURNEY |
| 결과 조회 패턴 | GET /mj/task/{id}/fetch |
| 입력 유형 | 텍스트 프롬프트 |
| 출력 유형 | 프롬프트 축약 분석 / 간결한 프롬프트 제안 |
| 관련 Midjourney 명령어 | /shorten, /turbo |
mj-turbo-shorten란?
mj-turbo-shorten는 Midjourney의 /shorten 동작과 Turbo 모드 라우팅을 결합한, Midjourney 호환 프롬프트 축약 기능에 대한 CometAPI의 플랫폼 식별자입니다. Midjourney의 공식 명령 목록은 /shorten을 긴 프롬프트를 제출하고 더 간결하게 만드는 제안을 받는 방법으로 설명하며, 별도로 /turbo를 Turbo 작동을 위한 모드 전환으로 나열합니다. 타사 Midjourney 프록시 구현에서는 일반적으로 Turbo 경로 하의 전용 shorten 엔드포인트를 통해 이를 제공하며, 보통 /mj-turbo/mj/submit/shorten입니다.
실무적으로 이 모델 ID는 범용 텍스트 LLM이 아니라 프롬프트 최적화를 위한 작업 지향적 Midjourney 도우미 엔드포인트로 이해하는 것이 가장 적절합니다. 이미 상세한 이미지 프롬프트를 보유한 개발자나 크리에이터가 시스템으로 하여금 해당 프롬프트를 분석하고, 압축 가능한 표현을 식별하여, 이후 Midjourney 워크플로에 적합한 더 간결한 표현을 반환받도록 설계되었습니다.
Midjourney 스타일의 프록시 API는 보통 비동기이므로, shorten 요청은 먼저 제출한 뒤 나중에 작업 조회 엔드포인트를 사용해 확인하는 것이 일반적입니다. Midjourney 프록시 호환 제공자의 문서는 이 패턴을 명확히 보여줍니다: shorten 작업을 제출하고, 작업 ID를 받은 뒤, /mj/task/{id}/fetch를 폴링해 상태와 결과를 가져옵니다.
mj-turbo-shorten의 주요 기능
- 프롬프트 축약: Midjourney의
/shorten기능에 맞춰 긴 Midjourney 프롬프트를 더 간결한 버전으로 줄이는 데 도움이 됩니다. - Turbo 모드 라우팅: Turbo 모드와 연계된 shorten 워크플로를 원하는 사용자를 위해, 일반적으로
/mj-turbo/mj하에서 사용되는 Midjourney 프록시 구현의 Turbo 경로 규약을 따릅니다. - Midjourney 호환 API 패턴: imagine, describe, shorten, action, modal, fetch 등 작업별로 엔드포인트가 구성된 보다 넓은 Midjourney 프록시 생태계에 맞춰져 있습니다.
- 비동기 작업 워크플로: 요청은 보통 즉시 최종 결과를 반환하는 대신 작업으로 제출되므로, 큐 기반 이미지 워크플로 시스템에 적합합니다.
- 단순 텍스트 입력: shorten 작업에는 주로 텍스트
prompt가 필요하며, 구현에 따라MID_JOURNEY와 같은botType도 일반적으로 허용합니다. - 프롬프트 정제 워크플로 지원: 문구를 단순화하고 중복을 제거하거나 이후 Midjourney 호출을 위해 더 깔끔한 프롬프트를 준비하고자 할 때, 이미지 생성 이전 단계에서 유용합니다. 이는 문서화된
/shorten동작과 프록시 엔드포인트 설계로부터의 추론입니다.
mj-turbo-shorten에 접근하고 통합하는 방법
1단계: API 키 등록
CometAPI에 가입하고 대시보드에서 API 키를 생성합니다. 이후 해당 키를 안전하게 보관하고, mj-turbo-shorten API에 대한 모든 요청에서 Authorization: Bearer YOUR_API_KEY 헤더로 사용하십시오.
2단계: mj-turbo-shorten API로 요청 보내기
CometAPI의 Midjourney 호환 엔드포인트 POST /mj/submit/shorten를 사용하십시오.
curl https://api.cometapi.com/mj/submit/shorten \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-d '{
"prompt": "a futuristic cityscape at sunset --v 6.1",
"botType": "MID_JOURNEY",
"accountFilter": {
"modes": ["TURBO"]
}
}'
3단계: 결과 조회 및 검증
API는 작업 ID가 포함된 작업 객체를 반환합니다. 작업이 종료 상태에 도달하면 GET /mj/task/{task_id}/fetch를 폴링하여 생성 상태를 확인하고 출력 이미지 URL을 가져오십시오.