curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "mj-v8.2",
"prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
"quality": "standard",
"model_params": {
"speed": "fast"
}
}
'{
"created": 1757165031,
"id": "task-unified-1757165031-mjv82",
"model": "mj-v8.2",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"estimated_time": 45
},
"type": "image",
"usage": {
"billing_rule": "per_call",
"credits_reserved": 1.8,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: mj-v8.2",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Midjourney V8.2
Midjourney V8.2 이미지 생성
- Midjourney V8.2 모델은 자연어 프롬프트를 통해 고품질 이미지를 생성할 수 있습니다. Fast 모드는 매회 4장을 생성하고, Draft 모드는 단일 실행으로 24장의 경량 512 px 스케치 이미지를 반환합니다
- 텍스트-이미지 및 이미지-이미지 생성 지원 (prompt에 이미지 URL 참조)
- 입력 이미지 URL은 공개적으로 접근 가능하고 약 10초 이내에 가져올 수 있어야 합니다. 업스트림은 작업 생성 시 이미지를 동기적으로 가져오며, 실패하면 400을 반환합니다. 중국 본토 외 이미지 호스팅(imgur, ibb, raw.githubusercontent, pinimg, picsum)은 실제로 실패합니다. 이미지를 빠른 CDN에 호스팅하거나 플랫폼 파일 업로드를 사용하세요
- V8.2 특징: V8.1 대비 미학과 화질 향상, 정밀도는 prompt 안의 네이티브
--quality/--q매개변수(1-4, 4 = 고품질 모드)로 설정하며 추가 비용 없음, 네이티브 2K 출력(quality=hd). V8.2에서는 turbo를 사용할 수 없습니다 (업스트림 문서에서 V8은 turbo를 지원하지 않는 것으로 명시) - 스타일 참조(
--sref) 지원.--oref/--cref는 V8.2에서 지원되지 않으며 업스트림에서 거부됩니다. 프롬프트 매개변수 가이드 참고 - 업스트림이 지원하지 않는 프롬프트 매개변수는 그대로 전달됩니다. 작업은 매개변수 오류(
invalid_parameters)로 실패하고 예약된 크레딧은 환불됩니다 (더 이상 조용히 무시되지 않음) - 비동기 처리 모드, 반환된 작업 ID로 상태 조회
- 생성된 이미지 링크는 30일간 유효하며, 가능한 빨리 저장하세요
- 타임아웃: 약 20분
- 매개변수 안내: 본 인터페이스는 V8.2로 고정되며 niji를 지원하지 않습니다. 속도 모드는
model_params.speed, 출력 품질은 최상위quality매개변수로 설정하세요. 정밀도는 prompt에--quality/--q(1-4)로 작성하며 그대로 전달됩니다 mj-v8.2-edit/mj-v8.2-upload-paint는 캔버스 편집(img_pos + mask)입니다. 업스트림의 지시 기반 편집 엔드포인트(--edit, 최대 4장의 참조 이미지)는 아직 본 라우트에서 제공되지 않으며 제공 일정을 조율 중입니다
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://api.evolink.ai/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "mj-v8.2",
"prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
"quality": "standard",
"model_params": {
"speed": "fast"
}
}
'{
"created": 1757165031,
"id": "task-unified-1757165031-mjv82",
"model": "mj-v8.2",
"object": "image.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"estimated_time": 45
},
"type": "image",
"usage": {
"billing_rule": "per_call",
"credits_reserved": 1.8,
"user_group": "default"
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: mj-v8.2",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}Midjourney에는 콘텐츠 검토 시스템이 내장되어 있습니다. 검토는 이미지 단위로 진행되며, 필터링된 이미지는 결과에 포함되지 않고 나머지 이미지는 정상적으로 반환되므로 평소보다 적은 수의 이미지를 받을 수 있습니다. 한 장이라도 검토를 통과하면 작업은
completed가 되고 정상 과금됩니다. 모든 이미지가 필터링되면 작업은 failed가 되고 예약된 크레딧은 전액 환불됩니다. 프롬프트와 참조 이미지가 콘텐츠 가이드라인을 준수하는지 확인해 주세요.인증
##모든 인터페이스는 Bearer Token 인증이 필요합니다##
API Key 발급:
API Key 관리 페이지에서 API Key를 발급받으세요
요청 헤더에 다음을 추가하세요:
Authorization: Bearer YOUR_API_KEY
본문
application/json
모델 이름
사용 가능한 옵션:
mj-v8.2 프롬프트, Midjourney V8.2의 모든 네이티브 매개변수 구문 지원 (예: --ar 16:9 --s 500).
이미지에서 이미지: 프롬프트 시작 부분에 이미지 URL을 배치하세요. 지원 형식: .png, .gif, .webp, .jpg, .jpeg
이미지에서 이미지 규칙:
- 이미지 1장 + 텍스트 없음 = 무효 (오류 반환)
- 이미지 1장 + 텍스트 설명 = 유효
- 이미지 2장 이상 + 텍스트 없음 = 유효
- 이미지 2장 이상 + 텍스트 설명 = 유효
지원되지 않는 매개변수: 업스트림이 지원하지 않는 매개변수(예: --oref, --cref, --stop, --bs)는 그대로 전달되어 업스트림에서 명시적으로 거부됩니다. 작업은 매개변수 오류(invalid_parameters)로 실패하고 예약된 크레딧은 환불됩니다. --v / --version / --niji 및 속도 / hd 매개변수는 제거되며 API 매개변수로 제어됩니다. --quality / --q(1-4)는 그대로 전달됩니다.
Maximum string length:
2048예시:
"A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500"
출력 품질
standard: 표준 해상도 (기본값), 1배 배율hd: 네이티브 HD 출력, 1.5배 배율.speed: draft와 상호 배타적
비용 안내: 품질 배율은 speed 배율과 상승(곱셈) 관계입니다.
사용 가능한 옵션:
standard, hd 모델 매개변수
Show child attributes
Show child attributes
작업 완료 후 HTTPS 콜백 주소
콜백 시점:
- 작업 완료(completed) 또는 실패(failed) 시 트리거
- 과금 확인 완료 후 전송
보안 제한:
- HTTPS 프로토콜만 지원
- 내부 네트워크 IP 주소로의 콜백 금지 (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x 등)
- URL 길이 최대
2048자
콜백 메커니즘:
- 타임아웃:
10초 - 실패 후 최대
3회 재시도 (실패 후1초/2초/4초에 각각 재시도) - 콜백 응답 형식은 작업 조회 인터페이스 반환 형식과 동일
- 콜백 주소가 2xx 상태 코드를 반환하면 성공, 기타 상태 코드는 재시도 트리거
예시:
"https://your-domain.com/webhooks/image-task-completed"
응답
작업 생성 성공
작업 생성 타임스탬프
예시:
1757165031
작업 ID
예시:
"task-unified-1757165031-mjv82"
실제 사용된 모델 이름
예시:
"mj-v8.2"
작업 유형
사용 가능한 옵션:
image.generation.task 작업 진행률 (0-100)
필수 범위:
0 <= x <= 100예시:
0
작업 상태
사용 가능한 옵션:
pending, processing, completed, failed 예시:
"pending"
비동기 작업 정보
Show child attributes
Show child attributes
작업 출력 유형
사용 가능한 옵션:
text, image, audio, video 예시:
"image"
사용량 및 과금 정보
Show child attributes
Show child attributes