MiniMax 노드 문서
n8n v2.34요약
MiniMax 노드는 n8n 워크플로를 MiniMax AI 모델에 연결합니다. 이 노드의 인증 정보는 여기에서 확인할 수 있습니다. MiniMax 음성 합성 모델을 사용하여 텍스트를 음성으로 변환합니다. MiniMax 이미지 생성 모델을 사용하여 텍스트 프롬프트로부터 이미지를 생성합니다.
MiniMax 노드는 n8n 워크플로를 MiniMax AI 모델에 연결합니다. 이 노드를 사용하여 텍스트 프롬프트로 이미지를 생성하고, 음성을 합성하고, 텍스트나 이미지로 영상을 생성하고, MiniMax 언어 모델에 메시지를 전송할 수 있습니다.
리소스 및 작업#
- Audio: MiniMax 음성 합성 모델을 사용하여 텍스트를 음성으로 변환합니다.
- Image: 텍스트 프롬프트로부터 이미지를 생성합니다.
- Text: MiniMax 언어 모델에 메시지를 전송하고 응답을 받습니다.
- Video: 텍스트 프롬프트 또는 첫 프레임 이미지로부터 영상을 생성합니다.
텍스트를 음성으로 변환#
MiniMax 음성 합성 모델을 사용하여 텍스트를 음성으로 변환합니다.
매개변수
- Model (유형: options, 필드:
modelId): 사용할 음성 합성 모델. 기본값:speech-2.8-hd - Text (유형: string, 필드:
text): 음성으로 변환할 텍스트. 최대 10,000자. 필수. - Voice ID (유형: string, 필드:
voiceId): 합성에 사용할 음성. 사용 가능한 음성은 MiniMax 문서에서 확인할 수 있습니다. 기본값:English_Graceful_Lady. 필수. - Download Audio (유형: boolean, 필드:
downloadAudio): 생성된 오디오를 바이너리 데이터로 다운로드할지 여부. 비활성화하면 노드는 오디오 URL만 반환합니다. 기본값:true
옵션
- Audio Format (유형: options, 필드:
audioFormat): 출력 오디오 형식. 옵션: MP3, PCM, FLAC, WAV. 이 노드는 비스트리밍 모드에서만 WAV를 지원합니다. 기본값:mp3 - Emotion (유형: options, 필드:
emotion): 합성된 음성에 적용할 감정. 모델이 가장 자연스러운 감정을 자동으로 선택합니다. 기본값:calm - Language Boost (유형: options, 필드:
languageBoost): 특정 언어에 대한 인식 정확도를 향상합니다. 기본값:auto - Pitch (유형: number, 필드:
pitch): 음성의 피치 조정 값으로 –12에서 12까지입니다.0은 원래 피치를 유지합니다. 기본값:0 - Speed (유형: number, 필드:
speed): 0.5에서 2까지의 음성 속도. 값이 높을수록 더 빠른 음성을 생성합니다. 기본값:1 - Volume (유형: number, 필드:
volume): 0.1에서 10까지의 음성 볼륨. 값이 높을수록 더 큰 음성을 생성합니다. 기본값:1
이미지 생성#
MiniMax 이미지 생성 모델을 사용하여 텍스트 프롬프트로부터 이미지를 생성합니다.
매개변수
- Model (유형: options, 필드:
modelId): 사용할 이미지 생성 모델. 기본값:image-01 - Prompt (유형: string, 필드:
prompt): 생성할 이미지에 대한 텍스트 설명. 최대 1500자. 필수. - Aspect Ratio (유형: options, 필드:
aspectRatio): 생성된 이미지의 종횡비. 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9를 포함한 옵션이 있습니다. 기본값:1:1 - Number of Images (유형: number, 필드:
numberOfImages): 요청당 생성할 이미지 수로, 1개에서 9개까지입니다. 기본값:1 - Download Image (유형: boolean, 필드:
downloadImage): 생성된 이미지를 바이너리 데이터로 다운로드할지 여부. 비활성화하면 노드는 이미지 URL만 반환합니다. 기본값:true
옵션
- Prompt Optimizer (유형: boolean, 필드:
promptOptimizer): 더 나은 결과를 위해 프롬프트를 자동으로 최적화할지 여부. 기본값:false - Seed (유형: number, 필드:
seed): 재현 가능한 출력을 위한 랜덤 시드. 동일한 매개변수로 같은 시드를 사용하면 동일한 이미지가 생성됩니다. 기본값:0
모델에 메시지 전송#
MiniMax 언어 모델에 하나 이상의 메시지를 전송하고 응답을 받습니다.
매개변수
- Model (유형: options, 필드:
modelId): 사용할 언어 모델. 기본값:MiniMax-M2.7 - Messages (유형: fixedCollection, 필드:
messages): 대화를 구성하는 하나 이상의 메시지. 각 메시지는 다음을 포함합니다.- Prompt (유형: string, 필드:
content): 메시지의 텍스트 콘텐츠. - Role (유형: options, 필드:
role): 메시지 발신자의 역할. 메시지를 전송하고 응답을 받으려면user를 사용하고, 모델의 어조나 페르소나를 설정하려면assistant를 사용합니다.
- Prompt (유형: string, 필드:
- Simplify Output (유형: boolean, 필드:
simplify): 활성화하면 노드는 전체 원시 API 출력이 아닌 단순화된 응답을 반환합니다. 기본값:true
옵션
- Hide Thinking (유형: boolean, 필드:
hideThinking): 응답에서 사고 과정(chain-of-thought) 추론을 제거하고 최종 답변만 반환합니다. 기본값:true - Maximum Number of Tokens (유형: number, 필드:
maxTokens): 생성할 최대 토큰 수. 기본값:1024 - Max Tool Calls Iterations (유형: number, 필드:
maxToolsIterations): 모델이 중지하기 전에 실행하는 최대 도구 반복 주기 수. 한 번의 반복에는 여러 도구 호출이 포함될 수 있습니다. 제한을 두지 않으려면0으로 설정합니다. 기본값:15 - Output Randomness (Temperature) (유형: number, 필드:
temperature): 출력의 무작위성을 제어합니다. 값이 낮을수록 출력이 더 결정적이고 반복적으로 됩니다. 범위: 0–1. 기본값:0.7 - Output Randomness (Top P) (유형: number, 필드:
topP): 샘플링 시 고려할 토큰의 최대 누적 확률. 범위: 0–1. 기본값:0.95 - System Message (유형: string, 필드:
system): 모델의 동작과 어조를 안내하는 시스템 수준 지시문.
텍스트로 영상 생성#
MiniMax 영상 생성 모델을 사용하여 텍스트 프롬프트로부터 영상을 생성합니다.
매개변수
- Model (유형: options, 필드:
modelId): 사용할 영상 생성 모델. 기본값:MiniMax-Hailuo-2.3 - Prompt (유형: string, 필드:
prompt): 영상에 대한 텍스트 설명. 최대 2000자.[command]구문을 사용하여 카메라 움직임을 제어할 수 있습니다. 예:[Push in]또는[Pan left]. 필수. - Duration (Seconds) (유형: options, 필드:
duration): 생성된 영상의 길이. 옵션: 6초 또는 10초. 기본값:6 - Resolution (유형: options, 필드:
resolution): 생성된 영상의 해상도. 사용 가능한 옵션은 모델에 따라 다릅니다. 옵션: 720P, 768P, 1080P. 기본값:768P - Download Video (유형: boolean, 필드:
downloadVideo): 생성된 영상을 바이너리 데이터로 다운로드할지 여부. 비활성화하면 노드는 영상 URL만 반환합니다. 기본값:true
옵션
- Prompt Optimizer (유형: boolean, 필드:
promptOptimizer): 더 나은 결과를 위해 프롬프트를 자동으로 최적화할지 여부. 기본값:true
이미지로 영상 생성#
이미지를 첫 프레임으로 사용하여 영상을 생성합니다.
매개변수
- Model (유형: options, 필드:
modelId): 사용할 영상 생성 모델. 기본값:MiniMax-Hailuo-2.3 - Image Input Type (유형: options, 필드:
imageInputType): 첫 프레임 이미지를 제공하는 방식. 옵션: URL 또는 Binary File. 기본값:url - Image URL (유형: string, 필드:
imageUrl): 첫 프레임 이미지의 공개 URL. 최대 20MB의 JPG, JPEG, PNG, WebP 파일을 지원합니다. Image Input Type이URL일 때 표시됩니다. 필수. - Input Data Field Name (유형: string, 필드:
binaryPropertyName): 바이너리 이미지 데이터가 포함된 입력 필드의 이름. Image Input Type이Binary File일 때 표시됩니다. 기본값:data. 필수. - Prompt (유형: string, 필드:
prompt): 영상에 대한 선택적 텍스트 설명. 최대 2000자.[command]구문을 사용하여 카메라 움직임을 제어할 수 있습니다. 예:[Zoom in]. - Duration (Seconds) (유형: options, 필드:
duration): 생성된 영상의 길이. 옵션: 6초 또는 10초. 기본값:6 - Resolution (유형: options, 필드:
resolution): 생성된 영상의 해상도. 사용 가능한 옵션은 모델에 따라 다릅니다. 옵션: 512P, 720P, 768P, 1080P. 기본값:768P - Download Video (유형: boolean, 필드:
downloadVideo): 생성된 영상을 바이너리 데이터로 다운로드할지 여부. 비활성화하면 노드는 영상 URL만 반환합니다. 기본값:true
옵션
- Prompt Optimizer (유형: boolean, 필드:
promptOptimizer): 프롬프트를 자동으로 최적화할지 여부. 기본값:true - Last Frame Image Input Type (유형: options, 필드:
lastFrameInputType): 마지막 프레임 이미지를 제공하여 첫-마지막 프레임 영상을 생성합니다. MiniMax-Hailuo-2.3과 MiniMax-Hailuo-02만 이 옵션을 지원합니다. 기본값:none- Last Frame Image URL (유형: string, 필드:
lastFrameImageUrl): 마지막 프레임 이미지의 공개 URL. Last Frame Image Input Type이URL일 때 표시됩니다. - Last Frame Data Field Name (유형: string, 필드:
lastFrameBinaryPropertyName): 마지막 프레임 이미지가 포함된 바이너리 필드 이름. Last Frame Image Input Type이Binary File일 때 표시됩니다. 기본값:lastFrame
- Last Frame Image URL (유형: string, 필드:
- Subject Reference Input Type (유형: options, 필드:
subjectReferenceInputType): 생성된 영상에서 얼굴 일관성을 유지하기 위해 얼굴 사진을 제공합니다. MiniMax-Hailuo-2.3만 이 옵션을 지원합니다. 기본값:none- Subject Reference Image URL (유형: string, 필드:
subjectReferenceImageUrl): 참조 얼굴 이미지의 공개 URL. Subject Reference Input Type이URL일 때 표시됩니다. - Subject Reference Data Field Name (유형: string, 필드:
subjectReferenceBinaryPropertyName): 참조 얼굴 이미지가 포함된 바이너리 필드 이름. Subject Reference Input Type이Binary File일 때 표시됩니다. 기본값:subjectReference
- Subject Reference Image URL (유형: string, 필드:
템플릿 및 예제#
MiniMax 노드 문서 통합 템플릿을 살펴보거나 모든 템플릿을 검색해보세요
관련 리소스#
이 서비스에 대한 자세한 내용은 MiniMax 문서를 참조하세요.