opencode-audio

An OpenCode plugin that adds AI audio generation tools — music via Suno and text-to-speech via ElevenLabs and Fish Audio.

Tools

| Tool | Description | |------|-------------| | generate_music | Generate AI music with Suno (async polling, saves .mp3) | | download_music | Download previously generated Suno music by task ID | | generate_voice_elevenlabs | Text-to-speech with ElevenLabs (multilingual) | | list_elevenlabs_voices | Browse available ElevenLabs voices | | generate_voice_fish | Text-to-speech with Fish Audio (best for Chinese) | | list_fish_voices | Browse available Fish Audio voice models |

Install

npm install opencode-audio

Add to your opencode.json:

{
  "plugins": {
    "audio": "opencode-audio"
  }
}

Local development

Clone this repo into your project and point to it:

{
  "plugins": {
    "audio": "./path/to/opencode-audio"
  }
}

Configuration

Set API keys as environment variables (e.g. in .env):

# Music generation (Suno)
SUNO_API_KEY=your-key-here        # https://sunoapi.org

# Voice generation (use one or both)
ELEVENLABS_API_KEY=your-key-here  # https://elevenlabs.io
FISH_API_KEY=your-key-here        # https://fish.audio

Each tool requires its corresponding API key to be set as an environment variable. Keys are read once when the plugin loads.

Usage

Once installed, the tools are available to the AI assistant automatically.

Generate music

Generate epic orchestral background music, save to assets/audio/

The generate_music tool accepts:

| Parameter | Required | Description | |-----------|----------|-------------| | track_id | Yes | Output filename (without extension) | | prompt | Yes | Text description of the music | | style | Yes | Genre/style tags (e.g. "epic orchestral, cinematic, 90 bpm") | | output_dir | No | Output directory relative to project root | | instrumental | No | Instrumental only, no vocals (default: true) | | model | No | Suno model: "V4", "V4_5", "V4_5PLUS", "V4_5ALL", "V5" (default: "V4_5ALL") |

Download music

Download the music from task abc123, save to assets/audio/

Use download_music to retrieve tracks from a previous generate_music call — especially useful if the original request timed out. Suno generates 2 tracks per request.

| Parameter | Required | Description | |-----------|----------|-------------| | task_id | Yes | Task ID returned from a previous generate_music call | | filename | Yes | Output filename (without extension) | | output_dir | No | Output directory relative to project root | | track_index | No | Which track to download, 0 or 1 (default: 0) |

Text-to-speech (ElevenLabs)

List available voices, then generate "Welcome aboard" with a deep male voice

| Parameter | Required | Description | |-----------|----------|-------------| | text | Yes | Text to convert to speech | | voice_id | Yes | ElevenLabs voice ID (find via list_elevenlabs_voices) | | filename | Yes | Output filename (without extension) | | output_dir | No | Output directory relative to project root | | model_id | No | TTS model (default: "eleven_multilingual_v2") | | stability | No | Voice stability 0.0–1.0 (default: 0.5) | | similarity_boost | No | Similarity boost 0.0–1.0 (default: 0.75) | | style | No | Style exaggeration 0.0–1.0 (default: 0.4) | | format | No | "mp3_44100_128", "opus", "pcm_44100" (default: "mp3_44100_128") |

Text-to-speech (Fish Audio)

Generate Chinese speech "你好世界" using Fish Audio

| Parameter | Required | Description | |-----------|----------|-------------| | text | Yes | Text to convert to speech | | reference_id | Yes | Fish Audio voice model ID (find via list_fish_voices) | | filename | Yes | Output filename (without extension) | | output_dir | No | Output directory relative to project root | | format | No | "mp3", "wav", "opus" (default: "mp3") | | bitrate | No | Audio bitrate in kbps (default: 128) |

Development

npm install
npm run typecheck   # Type-check without emitting
npm run build       # Compile to dist/

License

MIT