MiniMax 노드는 n8n 워크플로를 MiniMax AI 모델에 연결합니다. 텍스트 프롬프트로 이미지를 생성하거나, 음성을 합성하거나, 텍스트 또는 이미지에서 비디오를 생성하거나, MiniMax 언어 모델에 메시지를 전송하는 데 사용합니다.

리소스 및 작업#

• Audio: MiniMax 음성 합성 모델을 사용하여 텍스트를 음성으로 변환합니다.
• Image: 텍스트 프롬프트로 이미지를 생성합니다.
• Text: MiniMax 언어 모델에 메시지를 전송하고 응답을 받습니다.
• Video: 텍스트 프롬프트 또는 첫 번째 프레임 이미지로 비디오를 생성합니다.

텍스트 음성 변환#

MiniMax 음성 합성 모델을 사용하여 텍스트를 음성으로 변환합니다.

파라미터

• Model (type: options, field: modelId): 사용할 음성 합성 모델입니다. 기본값: speech-2.8-hd
• Text (type: string, field: text): 음성으로 변환할 텍스트입니다. 최대 10,000자. 필수.
• Voice ID (type: string, field: voiceId): 합성에 사용할 음성입니다. 사용 가능한 음성은 MiniMax 문서{:target="_blank" .external-link}에서 확인하세요. 기본값: English_Graceful_Lady. 필수.
• Download Audio (type: boolean, field: downloadAudio): 생성된 오디오를 바이너리 데이터로 다운로드할지 여부입니다. 비활성화하면 노드는 오디오 URL만 반환합니다. 기본값: true

옵션

• Audio Format (type: options, field: audioFormat): 출력 오디오 형식입니다. 옵션: MP3, PCM, FLAC, WAV. WAV는 비스트리밍 모드에서만 지원됩니다. 기본값: mp3
• Emotion (type: options, field: emotion): 합성 음성에 적용할 감정입니다. 모델이 가장 자연스러운 감정을 자동으로 선택합니다. 기본값: calm
• Language Boost (type: options, field: languageBoost): 특정 언어의 인식 정확도를 향상시킵니다. 기본값: auto
• Pitch (type: number, field: pitch): 음성의 피치 조정값으로, –12에서 12까지입니다. 0은 원본 피치를 유지합니다. 기본값: 0
• Speed (type: number, field: speed): 음성 속도로, 0.5에서 2까지입니다. 값이 높을수록 빠른 음성을 생성합니다. 기본값: 1
• Volume (type: number, field: volume): 음성 볼륨으로, 0.1에서 10까지입니다. 값이 높을수록 큰 음성을 생성합니다. 기본값: 1

이미지 생성#

MiniMax 이미지 생성 모델을 사용하여 텍스트 프롬프트로 이미지를 생성합니다.

파라미터

• Model (type: options, field: modelId): 사용할 이미지 생성 모델입니다. 기본값: image-01
• Prompt (type: string, field: prompt): 생성할 이미지의 텍스트 설명입니다. 최대 1500자. 필수.
• Aspect Ratio (type: options, field: aspectRatio): 생성된 이미지의 종횡비입니다. 옵션: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9. 기본값: 1:1
• Number of Images (type: number, field: numberOfImages): 요청당 생성할 이미지 수로, 1개에서 9개까지입니다. 기본값: 1
• Download Image (type: boolean, field: downloadImage): 생성된 이미지를 바이너리 데이터로 다운로드할지 여부입니다. 비활성화하면 노드는 이미지 URL만 반환합니다. 기본값: true

옵션

• Prompt Optimizer (type: boolean, field: promptOptimizer): 더 나은 결과를 위해 프롬프트를 자동으로 최적화할지 여부입니다. 기본값: false
• Seed (type: number, field: seed): 재현 가능한 출력을 위한 랜덤 시드입니다. 동일한 파라미터로 동일한 시드를 사용하면 동일한 이미지가 생성됩니다. 기본값: 0

모델에 메시지 전송#

MiniMax 언어 모델에 하나 이상의 메시지를 전송하고 응답을 받습니다.

파라미터

• Model (type: options, field: modelId): 사용할 언어 모델입니다. 기본값: MiniMax-M2.7
• Messages (type: fixedCollection, field: messages): 대화를 구성하는 하나 이상의 메시지입니다. 각 메시지는 다음으로 구성됩니다:
  • Prompt (type: string, field: content): 메시지의 텍스트 내용입니다.
  • Role (type: options, field: role): 메시지 발신자의 역할입니다. 메시지를 전송하고 응답을 받으려면 user를, 모델의 톤이나 페르소나를 설정하려면 assistant를 사용합니다.
• Simplify Output (type: boolean, field: simplify): 활성화하면 노드가 전체 원시 API 출력 대신 간소화된 응답을 반환합니다. 기본값: true

옵션

• Hide Thinking (type: boolean, field: hideThinking): 응답에서 사고 과정(chain-of-thought) 추론을 제거하고 최종 답변만 반환합니다. 기본값: true
• Maximum Number of Tokens (type: number, field: maxTokens): 생성할 최대 토큰 수입니다. 기본값: 1024
• Max Tool Calls Iterations (type: number, field: maxToolsIterations): 모델이 중지하기 전에 실행하는 최대 도구 반복 횟수입니다. 한 번의 반복에 여러 도구 호출이 포함될 수 있습니다. 제한 없이 설정하려면 0으로 지정합니다. 기본값: 15
• Output Randomness (Temperature) (type: number, field: temperature): 출력의 무작위성을 제어합니다. 값이 낮을수록 출력이 더 결정적이고 반복적이 됩니다. 범위: 0–1. 기본값: 0.7
• Output Randomness (Top P) (type: number, field: topP): 샘플링 시 고려할 토큰의 최대 누적 확률입니다. 범위: 0–1. 기본값: 0.95
• System Message (type: string, field: system): 모델의 동작과 톤을 안내하는 시스템 수준 지시문입니다.

텍스트에서 비디오 생성#

MiniMax 비디오 생성 모델을 사용하여 텍스트 프롬프트로 비디오를 생성합니다.

파라미터

• Model (type: options, field: modelId): 사용할 비디오 생성 모델입니다. 기본값: MiniMax-Hailuo-2.3
• Prompt (type: string, field: prompt): 비디오의 텍스트 설명입니다. 최대 2000자. [command] 구문을 사용하여 카메라 움직임을 제어할 수 있습니다. 예: [Push in] 또는 [Pan left]. 필수.
• Duration (Seconds) (type: options, field: duration): 생성된 비디오의 길이입니다. 옵션: 6초 또는 10초. 기본값: 6
• Resolution (type: options, field: resolution): 생성된 비디오의 해상도입니다. 사용 가능한 옵션은 모델에 따라 다릅니다. 옵션: 720P, 768P, 1080P. 기본값: 768P
• Download Video (type: boolean, field: downloadVideo): 생성된 비디오를 바이너리 데이터로 다운로드할지 여부입니다. 비활성화하면 노드는 비디오 URL만 반환합니다. 기본값: true

옵션

• Prompt Optimizer (type: boolean, field: promptOptimizer): 더 나은 결과를 위해 프롬프트를 자동으로 최적화할지 여부입니다. 기본값: true

이미지에서 비디오 생성#

이미지를 첫 번째 프레임으로 사용하여 비디오를 생성합니다.

파라미터

• Model (type: options, field: modelId): 사용할 비디오 생성 모델입니다. 기본값: MiniMax-Hailuo-2.3
• Image Input Type (type: options, field: imageInputType): 첫 번째 프레임 이미지를 제공하는 방법입니다. 옵션: URL 또는 Binary File. 기본값: url
• Image URL (type: string, field: imageUrl): 첫 번째 프레임 이미지의 공개 URL입니다. JPG, JPEG, PNG, WebP 파일을 최대 20MB까지 지원합니다. Image Input Type이 URL일 때 표시됩니다. 필수.
• Input Data Field Name (type: string, field: binaryPropertyName): 바이너리 이미지 데이터가 포함된 입력 필드의 이름입니다. Image Input Type이 Binary File일 때 표시됩니다. 기본값: data. 필수.
• Prompt (type: string, field: prompt): 비디오의 선택적 텍스트 설명입니다. 최대 2000자. [command] 구문을 사용하여 카메라 움직임을 제어할 수 있습니다. 예: [Zoom in].
• Duration (Seconds) (type: options, field: duration): 생성된 비디오의 길이입니다. 옵션: 6초 또는 10초. 기본값: 6
• Resolution (type: options, field: resolution): 생성된 비디오의 해상도입니다. 사용 가능한 옵션은 모델에 따라 다릅니다. 옵션: 512P, 720P, 768P, 1080P. 기본값: 768P
• Download Video (type: boolean, field: downloadVideo): 생성된 비디오를 바이너리 데이터로 다운로드할지 여부입니다. 비활성화하면 노드는 비디오 URL만 반환합니다. 기본값: true

옵션

• Prompt Optimizer (type: boolean, field: promptOptimizer): 프롬프트를 자동으로 최적화할지 여부입니다. 기본값: true
• Last Frame Image Input Type (type: options, field: lastFrameInputType): 마지막 프레임 이미지를 제공하여 첫 번째와 마지막 프레임 비디오를 생성합니다. MiniMax-Hailuo-2.3 및 MiniMax-Hailuo-02에서만 지원됩니다. 기본값: none
  • Last Frame Image URL (type: string, field: lastFrameImageUrl): 마지막 프레임 이미지의 공개 URL입니다. Last Frame Image Input Type이 URL일 때 표시됩니다.
  • Last Frame Data Field Name (type: string, field: lastFrameBinaryPropertyName): 마지막 프레임 이미지가 포함된 바이너리 필드 이름입니다. Last Frame Image Input Type이 Binary File일 때 표시됩니다. 기본값: lastFrame
• Subject Reference Input Type (type: options, field: subjectReferenceInputType): 얼굴 사진을 제공하여 생성된 비디오에서 얼굴 일관성을 유지합니다. MiniMax-Hailuo-2.3에서만 지원됩니다. 기본값: none
  • Subject Reference Image URL (type: string, field: subjectReferenceImageUrl): 참조 얼굴 이미지의 공개 URL입니다. Subject Reference Input Type이 URL일 때 표시됩니다.
  • Subject Reference Data Field Name (type: string, field: subjectReferenceBinaryPropertyName): 참조 얼굴 이미지가 포함된 바이너리 필드 이름입니다. Subject Reference Input Type이 Binary File일 때 표시됩니다. 기본값: subjectReference

템플릿 및 예제#

관련 리소스#

서비스에 대한 자세한 내용은 MiniMax 문서{:target="_blank" .external-link}를 참조하세요.