# DiffRhythm Song Generator

> Run DiffRhythm Song Generator by infsh online or via API. Pay per run, no setup.

**URL:** https://inference.sh/apps/infsh/diffrythm
**Last updated:** 2026-07-29

---

Generates complete songs quickly and simply using advanced latent diffusion technology.

- app: `infsh/diffrythm`
- maker: [infsh](https://inference.sh/apps/infsh.md)
- category: [audio](https://inference.sh/apps/category/audio.md)
- tasks: [music generation](https://inference.sh/apps/tag/music-generation.md)
- price: GPU time, billed per millisecond
- runs via: api, javascript and python sdk, belt cli, mcp

## diffrythm API Guide

### About
generates complete songs quickly and simply using advanced latent diffusion technology.

### 1. Calling the API

#### Install the Client

```bash
pip install inferencesh
```

#### Setup Your API Key
Set `INFERENCE_API_KEY` as an environment variable. Get your key from settings → api keys.

```bash
export INFERENCE_API_KEY="inf_your_key"
```

#### Run and Get Result

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])


result = client.run({
        "app": "infsh/diffrythm@7hzves1a",
        "input": {
            "lyrics": "lyrics"
        }
    })

print(result["output"])
```

#### Stream Live Updates

```python
import os
from inferencesh import inference

client = inference(api_key=os.environ["INFERENCE_API_KEY"])


## stream=True yields updates as they arrive
for update in client.run({
        "app": "infsh/diffrythm@7hzves1a",
        "input": {
            "lyrics": "lyrics"
        }
    }, stream=True):
    if update.get("progress"):
        print(f"progress: {update['progress']}%")
    if update.get("output"):
        print(f"output: {update['output']}")
```

### 2. Authentication
The API uses API keys for authentication. See the authentication docs for detailed setup instructions.

### 3. Files

#### Automatic Upload

```python
## local file paths are automatically uploaded
result = client.run({
    "app": "infsh/diffrythm@7hzves1a",
    "input": {
        "image": "/path/to/local/image.png",  # detected & uploaded
        "audio": "https://example.com/audio.mp3",  # url passed through
    }
})
```

#### Manual Upload

```python
## upload and get a hosted URL
file = client.files.upload("/path/to/file.png")
print(file.uri)  # https://cloud.inference.sh/...
```

### 4. Schema

#### Input
- **lyrics** (string) *required*: The lyrics to generate music for in LRC format
- **style_prompt** (string): Text prompt describing the desired music style
- **reference_audio** (string): Reference audio file to use as style
- **audio_length** (integer): Length of generated song in seconds (95 or 285)
- **edit_mode** (boolean): Whether to use edit mode
- **reference_song** (string): Reference song for editing
- **edit_segments** (string): Time segments to edit in format [[start1,end1],...]
- **batch_size** (integer): Number of songs to generate per batch
- **chunked_processing** (boolean): Whether to use chunked processing

#### Output
- **generated_audio** (string): The generated audio file

## other audio apps

- [Eleven Flash v2.5](https://inference.sh/apps/elevenlabs/eleven-flash-v2-5.md): $0.04/1K characters
- [Eleven Multilingual v2](https://inference.sh/apps/elevenlabs/eleven-multilingual-v2.md): $0.08/1K characters
- [Eleven v3](https://inference.sh/apps/elevenlabs/eleven-v3.md): $0.08/1K characters
- [Eleven v4 Turbo](https://inference.sh/apps/elevenlabs/eleven-v4-turbo.md): $0.04/1K characters
- [Eleven v4](https://inference.sh/apps/elevenlabs/eleven-v4.md): $0.08/1K characters

## faq

### how much does DiffRhythm Song Generator cost?

GPU time, billed per millisecond. you pay per run from your inference shell credits. no subscription is required.

### how do I run DiffRhythm Song Generator via api?

call infsh/diffrythm with the javascript or python sdk, the rest api, or `belt app run infsh/diffrythm` from a terminal. the api reference on this page lists every input.

### who makes DiffRhythm Song Generator?

DiffRhythm Song Generator is made by infsh and runs on inference shell. every infsh app is listed at https://inference.sh/apps/infsh.

### can my agent use DiffRhythm Song Generator?

yes. agents call it as a tool through the inference shell mcp server (https://api.inference.sh/mcp), the belt cli or the sdk, and pay per run like you do.

### what are the alternatives to DiffRhythm Song Generator?

other audio apps on inference shell include Eleven Flash v2.5, Eleven Multilingual v2, Eleven v3, Eleven v4 Turbo. they run through the same api, so switching is a one-line change.