shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 内容与媒体无需 API Key

melogen

将乐谱转换为MIDI和MusicXML，将音频转录为MIDI，并通过Melogen CLI分析音乐结构。功能包括：乐谱OCR/OMR、PDF转MIDI、PNG/JPG乐谱转MIDI、MP3/WAV/FLAC/OGG/M4A音频转MIDI、复调转录、音轨分离、节拍量化、音乐理论分析（调性、和声、曲式、调式）。用途包括：音乐转录、音乐记谱、音乐制作、音频转录、乐谱数字化、MIDI转换、音乐AI、音乐分析、音乐生成工作流程。触发词：音乐、MIDI、乐谱、sheet2midi、music2midi、音频转MIDI、PDF转MIDI、mp3转MIDI、wav转MIDI、MusicXML、OMR、光学音乐识别、乐谱、钢琴转MIDI、吉他转MIDI、歌曲转MIDI、转录音乐、音乐记谱、音乐理论、和弦分析、调性检测、和声分析、melogen、melogenai

person作者: jakexiaohubgithub
open_in_new仓库download下载资源包

Melogen CLI

AI-powered music tools: convert sheet music to MIDI, transcribe audio to MIDI, and analyze music structure.

Setup

  1. Get your API key from melogenai.com/zh/mcp
  2. Install the CLI and set your key:
pip install melogenai
export MELOGEN_API_KEY=melo_xxx
  1. Verify your key works:
melogen auth verify

Commands

melogen sheet2midi FILE_URL

Convert sheet music (PDF/PNG/JPG) to MIDI and MusicXML.

# Basic conversion (outputs both MIDI and MusicXML)
melogen sheet2midi https://example.com/score.pdf

# Only MusicXML output
melogen sheet2midi https://example.com/score.pdf -f musicxml --no-midi

# Specify multiple output formats explicitly
melogen sheet2midi https://example.com/score.png -f midi -f musicxml

| Flag | Description | |------|-------------| | -f, --format | Output format: midi, musicxml (repeatable) | | --no-midi | Skip MIDI output |

melogen music2midi FILE_URL

Convert audio files (MP3/WAV/FLAC/OGG/M4A) to MIDI.

# Basic conversion
melogen music2midi https://example.com/song.mp3

# Save separated instrument stems
melogen music2midi https://example.com/song.wav --stems

# Quantize to nearest beat
melogen music2midi https://example.com/song.flac --quantize

# Both stems and quantization
melogen music2midi https://example.com/song.mp3 --stems --quantize

| Flag | Description | |------|-------------| | --stems | Save separated instrument stems | | --quantize | Quantize MIDI output to nearest beat |

melogen analysis

Analyze music structure, tonality, harmony, and form. Provide at least one input source.

# Analyze from sheet music image
melogen analysis --image https://example.com/score.png

# Analyze from PDF
melogen analysis --pdf https://example.com/score.pdf

# Analyze from MusicXML
melogen analysis --mxl https://example.com/score.mxl

# Specify language (default: en)
melogen analysis --image https://example.com/score.png --lang zh

# Disable streaming (get full result at once)
melogen analysis --pdf https://example.com/score.pdf --no-stream

| Flag | Description | |------|-------------| | --mxl | URL of a MusicXML (.mxl) file | | --image | URL of a sheet music image | | --pdf | URL of a PDF score | | --lang | Language for analysis output (default: en) | | --stream / --no-stream | Stream output as generated (default: stream) |

At least one of --mxl, --image, or --pdf is required.

Supported languages: en, zh, tw, ja, ko, de, fr, es, pt, it, ru, pl, el, vi

melogen auth verify

Verify your API key is valid. Reports user ID and scopes.

melogen auth verify

Global Options

These options apply to all commands:

| Option | Env Variable | Description | |--------|-------------|-------------| | --api-key | MELOGEN_API_KEY | Melogen API key | | --base-url | MELOGEN_BASE_URL | Override API base URL | | --version | | Show version and exit |

Error Handling

| Error | HTTP Status | Cause | Fix | |-------|-------------|-------|-----| | Invalid or expired API key | 401 | Bad or expired API key | Run melogen auth verify; get a new key from melogenai.com | | Insufficient credits | 402 | Account out of credits | Top up credits at melogenai.com | | Validation error | 422 | Invalid parameters or unsupported file format | Check file URL is accessible and format is supported | | Rate limit exceeded | 429 | Too many requests | Wait and retry; reduce request frequency | | Task ... timed out | -- | Processing exceeded timeout | Retry; for audio, shorter files process faster | | Task ... failed | -- | Server-side processing error | Retry with a different file or check input quality |

All errors print to stderr and exit with code 1.

Tips

  • Input quality matters: Use high-resolution scans (300+ DPI) for sheet music. Use lossless formats (WAV/FLAC) for audio when possible.
  • Format choice: For sheet music, multi-page PDFs are preferred over separate image files. For audio, WAV/FLAC give better accuracy than MP3.
  • Stems for complex audio: Enable --stems when converting multi-instrument recordings to get cleaner per-instrument MIDI tracks.
  • Quantize for clean MIDI: Use --quantize to snap notes to the nearest beat for cleaner MIDI output.
  • Streaming analysis: Analysis streams by default so you see results as they generate. Use --no-stream if you need the complete output at once.
  • Audio takes longer: Audio-to-MIDI conversion is more computationally intensive than sheet music conversion. The default polling timeout is 600 seconds.