guide
EvoLink에서 Midjourney V8.1 API 사용하는 방법: 페이로드, 폴링, 콜백
EvoLink Team
Product Team
2026년 6월 21일
8분 소요
코드에서 Midjourney V8.1을 사용하려면 엔드포인트만 아는 것으로는 부족합니다. 작업을 생성하고, 상태를 추적하고, 비용을 제어하며, 나중에 EvoLink의 다른 이미지 모델로도 전환 또는 비교할 수 있어야 합니다.
EvoLink에서 기본 이미지 생성은
POST https://api.evolink.ai/v1/images/generations에 model: "mj-v8.1"을 전달해 시작합니다. 응답은 비동기 작업입니다. 이후 GET https://api.evolink.ai/v1/tasks/{task_id}로 상태를 조회하거나 callback_url을 사용할 수 있습니다.빠른 답변
curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "mj-v8.1",
"prompt": "a premium product photo of a matte black espresso machine on a marble counter --ar 16:9 --s 250",
"quality": "standard",
"model_params": {
"speed": "fast"
},
"callback_url": "https://your-domain.com/webhooks/evolink-image-task"
}'응답의
id를 저장하세요. 이 값이 폴링, 콜백 대조, 오류 분석에 쓰는 task_id입니다.curl --request GET \
--url https://api.evolink.ai/v1/tasks/<task_id> \
--header 'Authorization: Bearer YOUR_API_KEY'EvoLink에서 확인된 사실
| 항목 | 현재 기준 |
|---|---|
| Endpoint | POST /v1/images/generations |
| Model | mj-v8.1 |
| Auth | Authorization: Bearer YOUR_API_KEY |
| 필수 필드 | model, prompt |
| 품질 | top-level quality: standard 또는 hd |
| 속도 | model_params.speed: draft, fast |
| 비동기 상태 | GET /v1/tasks/{task_id} |
| 출력 | Fast는 최대 4장, Draft는 최대 24장의 경량 0.5K 스케치 |
| 링크 유효 기간 | 생성 이미지 URL은 30일 동안 유효 |
요청 필드
| 필드 | 필수 | 예시 | 설명 |
|---|---|---|---|
model | 예 | mj-v8.1 | Midjourney V8.1 라우트 선택 |
prompt | 예 | a product photo... --ar 16:9 | 텍스트와 지원되는 MJ prompt 파라미터 |
quality | 아니오 | standard, hd | hd는 1.5x quality 배수 |
model_params.speed | 아니오 | draft, fast | draft와 hd는 함께 사용할 수 없음 |
callback_url | 아니오 | https://... | 최종 작업 이벤트용 HTTPS 콜백 |
quality를 model_params 안에 넣지 마세요. 이 EvoLink 라우트에서는 quality가 최상위 필드입니다.Text-to-image와 image-to-image
Text-to-image 예시:
{
"model": "mj-v8.1",
"prompt": "a cinematic product photo of a titanium travel mug on wet black stone --ar 16:9 --s 250",
"quality": "standard",
"model_params": {
"speed": "fast"
}
}Image-to-image에서는 이미지 URL을
prompt 맨 앞에 둡니다. 지원 형식은 PNG, GIF, WebP, JPG, JPEG입니다. 이미지 URL 1개만 있고 텍스트가 없는 요청은 유효하지 않습니다. 이미지 1장과 텍스트, 여러 이미지, 또는 여러 이미지와 텍스트를 사용하세요.{
"model": "mj-v8.1",
"prompt": "https://your-cdn.example.com/reference-sofa.jpg a luxury living room campaign image --ar 4:3 --iw 1.2",
"quality": "standard",
"model_params": {
"speed": "fast"
}
}프로덕션 콜백
callback_url은 HTTPS여야 하며, 2048자를 넘지 않아야 하고, 127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 같은 사설 IP 범위를 가리킬 수 없습니다. EvoLink는 작업이 completed, failed, cancelled 상태가 되면 콜백을 보냅니다. 타임아웃은 10초, 재시도는 최대 3회입니다.프로덕션 핸들러는 빠르게
2xx를 반환하고, GET /v1/tasks/{task_id}로 최종 상태를 확인하며, 반복 콜백을 작업 ID와 종료 상태 기준으로 중복 제거하고, 30일이 지나기 전에 결과 URL을 자체 스토리지에 복사해야 합니다.비용과 라우팅
| 선택 | 영향 | 권장 사용 |
|---|---|---|
fast | 표준 속도 | 대부분의 프로덕션 기본값 |
draft | 경량 스케치, hd와 조합 불가 | 초기 구도 탐색 |
standard | 기본 품질 | 프리뷰와 일반 앱 출력 |
hd | 1.5x quality 배수 | 최종 에셋 또는 캠페인 이미지 |
EvoLink의 장점은 Midjourney V8.1 하나에만 있지 않습니다. 같은 인증, 과금, 비동기 작업 패턴으로 Midjourney V7, Nano Banana Pro, GPT Image 2 같은 이미지 라우트도 비교할 수 있습니다.
프로덕션 체크리스트
| 영역 | 필요한 동작 |
|---|---|
| API Key | 서버 측에만 저장 |
| Logging | model, prompt hash, quality, model_params.speed, 사용자 ID, task_id 기록 |
| UI | pending, processing, completed, failed 표시 |
| Polling | 초기 확인 후 백오프 적용 |
| Callback | 빠르게 2xx 반환 후 비동기 처리 |
| Storage | 30일 이내 이미지 저장 |
| 비용 제어 | hd 접근을 명시적으로 제어 |
FAQ
EvoLink에서 Midjourney V8.1은 어떤 endpoint를 사용하나요?
Task 생성에는
POST /v1/images/generations, 상태 조회에는 GET /v1/tasks/{task_id}를 사용합니다.올바른 model name은 무엇인가요?
기본 생성 라우트의 model name은
mj-v8.1입니다.quality는 어디에 넣어야 하나요?
quality는 최상위 필드입니다. 유효한 값은 standard와 hd입니다.model_params.speed 값은 무엇인가요?
현재 문서 기준으로
draft, fast가 정의되어 있습니다.quality: "hd"와 speed: "draft"를 함께 쓸 수 있나요?
아니요. EvoLink docs에서는
quality: "hd"와 model_params.speed: "draft"가 동시 지정 불가라고 명시합니다.Image-to-image를 지원하나요?
예. 이미지 URL을 prompt 앞에 두고, 이미지가 1장뿐이라면 텍스트 설명도 함께 넣어야 합니다.
생성 이미지 URL은 얼마나 오래 유효한가요?
생성 이미지 URL은 30일 동안 유효합니다. 결과를 자체 스토리지에 저장하세요.
Polling과 callback 중 무엇을 써야 하나요?
테스트나 내부 도구에는 polling이 충분합니다. 프로덕션 워크플로에서는
callback_url을 사용하고 마지막에 작업 엔드포인트로 상태를 확인하는 것이 좋습니다.참고 링크
- EvoLink Midjourney V8.1 API 페이지
- EvoLink Midjourney V8.1 이미지 생성 문서
- EvoLink Midjourney V8.1 가격
- EvoLink 모델 카탈로그
EvoLink에서 Midjourney V8.1 시작하기
먼저 Midjourney V8.1 playground에서 prompt를 확인한 뒤, 같은 페이로드 구조를 백엔드로 옮기세요.
EvoLink에서 Midjourney V8.1 열기
