Base URL: https://api.apimart.ai인증: Authorization: Bearer <token>새 /v1/midjourney/... 라우트는 model=midjourney를 자동 주입하므로 요청 본문에 model을 전달할 필요가 없습니다.
빠른 시작
# 1. Imagine 작업 제출
curl -X POST https://api.apimart.ai/v1/midjourney/generations \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"prompt": "a cute cat, watercolor style --ar 16:9"}'
# 2. 통합 작업 API를 status=completed까지 폴링
curl https://api.apimart.ai/v1/tasks/task_01JWXXXX \
-H "Authorization: Bearer <token>"
# 3. 첫 번째 이미지 업스케일
curl -X POST https://api.apimart.ai/v1/midjourney/generations/upscale \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"task_id": "task_01JWXXXX", "index": 1}'
API 개요
각 기능의 전체 필드, 예시, 주의사항은 해당 하위 페이지를 참고하세요.
| 기능 | 경로 | 문서 |
|---|
| 텍스트→이미지(기본 엔드포인트) | POST /v1/midjourney/generations | Imagine |
| 텍스트→이미지(명시적 엔드포인트) | POST /v1/midjourney/generations/imagine | Imagine |
| 다중 이미지 블렌드 | POST /v1/midjourney/generations/blend | Blend |
| 이미지→텍스트 | POST /v1/midjourney/generations/describe | Describe |
| 이미지 편집 | POST /v1/midjourney/generations/edits | Edits |
| 업스케일 | POST /v1/midjourney/generations/upscale | Upscale |
| 변형 | POST /v1/midjourney/generations/variation | Variation |
| 강한 변형 | POST /v1/midjourney/generations/high-variation | High Variation |
| 약한 변형 | POST /v1/midjourney/generations/low-variation | Low Variation |
| 리롤 | POST /v1/midjourney/generations/reroll | Reroll |
| 줌 아웃 | POST /v1/midjourney/generations/zoom | Zoom |
| 팬 | POST /v1/midjourney/generations/pan | Pan |
| 인페인트 | POST /v1/midjourney/generations/inpaint | Inpaint |
| Modal 추가 파라미터 | POST /v1/midjourney/generations/modal | Modal |
| 이미지→동영상 | POST /v1/midjourney/generations/video | Video |
| 리셰이프(강 / 약) | POST /v1/midjourney/generations/remix-strong · /remix-subtle | Remix |
| 작업 조회 | GET /v1/tasks/{task_id} · /v1/midjourney/{task_id} | 작업 조회 |
전체 흐름
오류 처리
오류 응답 형식
{
"error": {
"type": "invalid_request_error",
"message": "prompt is required"
}
}
일반 오류
| HTTP | type | 설명 |
|---|
| 400 | invalid_request_error | 파라미터 오류 (필수 누락, 형식 오류 등) |
| 401 | authentication_error | API Key 무효 |
| 402 | payment_required | 잔액 부족 |
| 404 | not_found | 작업이 존재하지 않음 |
| 429 | rate_limit_error | 요청 빈도 초과 |
| 500 | internal_error | 서버 내부 오류 |
작업 실패
작업 실패 시 fail_reason이 원인을 반환합니다. 일반적인 값:
Banned prompt detected — 금지어 포함Task timeout — 작업 시간 초과 (30분 초과). 자동 전액 환불 완료No available upstream — 서비스 일시적으로 사용 불가, 잠시 후 재시도
MJ 새 라우트의 통합 모델명은 midjourney입니다. action, version, speed로 과금 key를 생성합니다. 일반적인 매칭 순서는 다음과 같습니다.
midjourney@<action>-<version>-<speed>
-> midjourney@<action>-<version>
-> midjourney@<action>-<speed>
-> midjourney@<action>
-> midjourney
| 작업 | 과금 키 | 설명 |
|---|
| Imagine | midjourney@imagine[-version][-speed] | 텍스트→이미지 / 참조 이미지 생성 |
| Blend | midjourney@blend[-speed] | 다중 이미지 블렌드 |
| Describe | midjourney@describe[-speed] | 이미지→텍스트 |
| Edits | midjourney@edits[-speed] | 이미지 편집 |
| Upscale | midjourney@upscale[-version][-speed] | 업스케일 |
| Variation | midjourney@variation[-version][-speed] | 변형 |
| High Variation | midjourney@high_variation[-version][-speed] | 강한 변형 |
| Low Variation | midjourney@low_variation[-version][-speed] | 약한 변형 |
| Reroll | midjourney@reroll[-version][-speed] | 다시 생성 |
| Zoom | midjourney@zoom[-version][-speed] | 줌 아웃 / 확장 |
| Pan | midjourney@pan[-version][-speed] | 팬 확장 |
| Inpaint | midjourney@inpaint[-version][-speed] | 인페인트 진입 |
| Modal | midjourney@modal[-speed] | 인페인트 추가 파라미터 |
| Video | midjourney@video / midjourney@video-720p | 이미지→동영상, 실제 청구 × batch_size |
| Remix Strong | midjourney@remix_strong[-speed] | 강 리셰이프(v8 / v8.1 전용) |
| Remix Subtle | midjourney@remix_subtle[-speed] | 약 리셰이프(v8 / v8.1 전용) |
speed=relax 또는 speed 미전달 시 speed 접미사가 추가되지 않습니다. fast / turbo는 해당 접미사를 추가합니다.- 주 버전은
v8.1, v7, v6.1, v5.2, v5.1로 정규화됩니다.
niji=true + version=7/6은 niji7 / niji6으로 정규화됩니다.
자세한 가격은 콘솔의 모델 가격 페이지 참조. 실패 시 자동 전액 환불.