# Mureka | Generate Remix

Mureka Remix turns any song or uploaded audio into fresh remix versions with new styles, tempo, and energy for music producers and creators on eachlabs.

## API Information

- **Model Slug:** mureka-generate-remix
- **Branded URL:** https://www.eachlabs.ai/mureka/mureka/mureka-generate-remix
- **Provider:** Mureka
- **Category:** Text to Voice
- **Output Type:** object
- **Status:** active
- **Base Cost:** $0.20 per generation
- **Estimated Processing Time:** 100 seconds
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/mureka-generate-remix

## Pricing

- **Charge Type:** dynamic
- **Estimate:** $0.20 per generation
- **Pricing Details:** default: $0.2

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| lyrics | string | Yes | - | - | Lyrics used to drive the remix vocal performance. Maximum 3000 characters. Supports the same 10 languages as song generation (English, Chinese, Japanese, Korean, Portuguese, Spanish, German, Italian, French, Russian). Use square-bracket structure tags (e.g. [Verse], [Chorus], [Bridge]) to guide remix structure. |
| song_id | string | No | - | - | ID of an existing Mureka song to remix. IMPORTANT: this is the inner `choices[N].id` from a previous POST /v1/song/generate response, NOT the top-level task `id`. Passing the task id returns 'The corresponding song is not found.'. Only songs generated within the last month are supported. Instrumental and BGM songs are not supported. Mutually exclusive with upload_audio_id. |
| upload_audio_id | string | No | - | - | Upload ID returned by POST /v1/files/upload with purpose=remix (mp3/m4a). Only uploads from the last month are supported. Mutually exclusive with song_id. |
| prompt | string | Yes | - | - | Free-text style prompt steering the remix's genre, mood, instrumentation and vocal delivery (e.g. 'jazz, upbeat, brass-driven'). Maximum 1024 characters. |
| n | integer | No | 2 | 1–3 | Number of remix variants to generate per request (1-3). Each generated remix is billed separately. Default is 2 for an A/B comparison; pick 1 for a single output or 3 for maximum variety. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "mureka-generate-remix",
  "input": {
    "lyrics": "[verse 1]\nWhere ideas spark and the future begins,\neach::labs is the place where creation wins.\nFrom text to image, from sound to light,\nWe turn imagination into something bright.\n\n[chorus]\neach::labs, the power, the speed, the way,\nFrom a single thought to a product in a day.\nBuild it, shape it, let it rise,\nBring your vision to life before your eyes.\n\n[verse 2]\nModels in motion, connected as one,\nAPIs flowing till the work is done.\nCreators and builders, side by side,\nTurning bold dreams into tools with pride.",
    "prompt": "Dreamy soft pop, ethereal and floating, gentle piano and airy synths, female vocals, smooth and delicate, builds into rhythmic upbeat sections with light percussion and pulsing bass, magical and mystical mood, bittersweet atmosphere"
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "object",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `Authorization` bearer token |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**Mureka | Generate Remix Overview**

**Mureka | Generate Remix** is a music remix generation model from Mureka, available on each::labs for creators who want to transform an existing song or uploaded audio into a fresh remix. It is designed to solve a common production problem: turning a finished track or stem-like audio into new variations without rebuilding the arrangement from scratch. The model’s main differentiator is its remix-first workflow, which focuses on changing style, tempo, and energy while preserving the musical identity of the input. In practice, **Mureka | Generate Remix** is best suited for rapid ideation, alternate cuts, and content variations for music producers, marketers, and creators working through **Mureka text-to-voice**-style audio generation workflows on each::labs.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `Authorization: Bearer YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.