suno/chirp-v5

Texto a Audio

Suno chirp-v5 API by SUNO

suno/chirp-v5

Chirp-v5

Suno text-to-music (chirp): generate a full song from a text prompt (and optional lyrics). Async; returns 2 variations.

Entrada

Prompt *

Make instrumental

Salida

Inactivo

Tu audio generado aparecerá aquí

Escribe texto y haz clic en Ejecutar para sintetizar voz.

Parámetros

Ejemplo de código
import requests
import time

# Step 1: Start audio generation
generate_url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "suno/chirp-v5",  # Required. Model name. options: suno/chirp-v5
    "prompt": "upbeat indie pop about summer nights, bright female vocal, catchy chorus",  # Required. Describe the song: style, mood, genre, instrumentation, theme (and lyrics inline if desired)
    "make_instrumental": False,  # Generate an instrumental track (no vocals)
}

generate_response = requests.post(generate_url, headers=headers, json=data)
generate_result = generate_response.json()
prediction_id = generate_result["data"]["id"]

# Step 2: Poll for result
poll_url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"

def check_status():
    while True:
        response = requests.get(poll_url, headers={"Authorization": "Bearer $ATLASCLOUD_API_KEY"})
        result = response.json()

        if result["data"]["status"] in ["completed", "succeeded"]:
            print("Generated audio:", result["data"]["outputs"][0])
            return result["data"]["outputs"][0]
        elif result["data"]["status"] == "failed":
            raise Exception(result["data"]["error"] or "Generation failed")
        else:
            # Still processing, wait 2 seconds
            time.sleep(2)

audio_url = check_status()

Instalar

Instala el paquete de dependencias necesario.

pip install requests

Autenticación

Todas las solicitudes de API requieren autenticación mediante una clave de API. Puedes obtener tu clave de API desde el panel de Atlas Cloud.

export ATLASCLOUD_API_KEY="your-api-key-here"

Encabezados HTTP

import os

API_KEY = os.environ.get("ATLASCLOUD_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

Mantén tu clave de API segura

Nunca expongas tu clave de API en código del lado del cliente ni en repositorios públicos. Usa variables de entorno o un proxy de backend en su lugar.

Enviar una solicitud

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}
data = {
    "model": "your-model",
    "text": "Hello, welcome to AtlasCloud text-to-speech."
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Enviar una solicitud

Envía una solicitud de generación asíncrona. La API devuelve un ID de predicción que puedes usar para verificar el estado y obtener el resultado.

POST/api/v1/model/generateAudio

Cuerpo de la solicitud

import requests

url = "https://api.atlascloud.ai/api/v1/model/generateAudio"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer $ATLASCLOUD_API_KEY"
}

data = {
    "model": "suno/chirp-v5",
    "text": "Hello, welcome to AtlasCloud text-to-speech."
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

print(f"Prediction ID: {result['data']['id']}")
print(f"Status: {result['data']['status']}")

Respuesta

{
  "code": 200,
  "data": {
    "id": "pred_abc123",
    "status": "processing",
    "model": "model-name",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

Verificar estado

Consulta el endpoint de predicción para verificar el estado actual de tu solicitud.

GET/api/v1/model/prediction/{prediction_id}

Ejemplo de polling

import requests
import time

prediction_id = "pred_abc123"
url = f"https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}"
headers = { "Authorization": "Bearer $ATLASCLOUD_API_KEY" }

while True:
    response = requests.get(url, headers=headers)
    result = response.json()
    status = result["data"]["status"]
    print(f"Status: {status}")

    if status in ["completed", "succeeded"]:
        output_url = result["data"]["outputs"][0]
        print(f"Output URL: {output_url}")
        break
    elif status == "failed":
        print(f"Error: {result['data'].get('error', 'Unknown')}")
        break

    time.sleep(3)

Valores de estado

processingLa solicitud aún se está procesando.

completedLa generación está completa. Las salidas están disponibles.

succeededLa generación fue exitosa. Las salidas están disponibles.

failedLa generación falló. Verifica el campo de error.

Respuesta completada

{
  "data": {
    "id": "pred_abc123",
    "status": "completed",
    "outputs": [
      "https://storage.atlascloud.ai/outputs/result.mp3"
    ],
    "metrics": {
      "predict_time": 8.3
    },
    "created_at": "2025-01-01T00:00:00Z",
    "completed_at": "2025-01-01T00:00:10Z"
  }
}

Schema de entrada

Los siguientes parámetros se aceptan en el cuerpo de la solicitud.

Total: 3Obligatorio: 2Opcional: 1

modelstringrequired

Model name.

Default: "suno/chirp-v5"

suno/chirp-v5

promptstringrequired

Describe the song: style, mood, genre, instrumentation, theme (and lyrics inline if desired). e.g. "upbeat indie pop about summer nights, female vocal".

Default: "upbeat indie pop about summer nights, bright female vocal, catchy chorus"

make_instrumentalboolean

Generate an instrumental track (no vocals).

Default: false

Ejemplo de cuerpo de solicitud

{
  "model": "suno/chirp-v5",
  "prompt": "upbeat indie pop about summer nights, bright female vocal, catchy chorus",
  "make_instrumental": false
}

Schema de salida

La API devuelve una respuesta de predicción con las URL de salida generadas.

idstring

modelstring

statusstring

created|processing|completed|failed

outputsarray

Generated song URLs (2 variations).

Ejemplo de respuesta

{
  "id": "pred_abc123",
  "status": "completed",
  "model": "model-name",
  "outputs": [
    "https://storage.atlascloud.ai/outputs/result.png"
  ],
  "metrics": {
    "predict_time": 8.3
  },
  "created_at": "2025-01-01T00:00:00Z",
  "completed_at": "2025-01-01T00:00:10Z"
}

Atlas Cloud Skills

Atlas Cloud Skills integra más de 400 modelos de IA directamente en tu asistente de codificación con IA. Un solo comando para instalar y luego usa lenguaje natural para generar imágenes, videos y chatear con LLM.

Clientes compatibles

Claude Code

OpenAI Codex

Gemini CLI

Cursor

Windsurf

VS Code

Trae

GitHub Copilot

Cline

Roo Code

Amp

Goose

Replit

40+ clientes compatibles

Instalar

npx skills add AtlasCloudAI/atlas-cloud-skills

Configurar clave de API

Obtén tu clave de API desde el panel de Atlas Cloud y configúrala como variable de entorno.

export ATLASCLOUD_API_KEY="your-api-key-here"

Funcionalidades

Una vez instalado, puedes usar lenguaje natural en tu asistente de IA para acceder a todos los modelos de Atlas Cloud.

Generación de imágenesGenera imágenes con modelos como Nano Banana 2, Z-Image y más.

Creación de videosCrea videos a partir de texto o imágenes con Kling, Vidu, Veo, etc.

Chat con LLMChatea con Qwen, DeepSeek y otros modelos de lenguaje de gran escala.

Carga de mediosSube archivos locales para flujos de trabajo de edición de imágenes e imagen a video.

Más información

github.com/AtlasCloudAI/atlas-cloud-skills

MCP Server

Atlas Cloud MCP Server conecta tu IDE con más de 400 modelos de IA a través del Model Context Protocol. Funciona con cualquier cliente compatible con MCP.

Clientes compatibles

Cursor

VS Code

Windsurf

Claude Code

OpenAI Codex

Gemini CLI

Cline

Roo Code

100+ clientes compatibles

Instalar

npx -y atlascloud-mcp

Configuración

Agrega la siguiente configuración al archivo de configuración de MCP de tu IDE.

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": [
        "-y",
        "atlascloud-mcp"
      ],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Herramientas disponibles

atlas_generate_imageGenera imágenes a partir de indicaciones de texto.

atlas_generate_videoCrea videos a partir de texto o imágenes.

atlas_chatChatea con modelos de lenguaje de gran escala.

atlas_list_modelsExplora más de 400 modelos de IA disponibles.

atlas_quick_generateCreación de contenido en un solo paso con selección automática de modelo.

atlas_upload_mediaSube archivos locales para flujos de trabajo de API.

Más información

github.com/AtlasCloudAI/mcp-server

API Schema

{
  "info": {
    "title": "AtlasCloud API",
    "version": "1.0.0",
    "description": "The AtlasCloud API."
  },
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/model/generateAudio": {
      "post": {
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Input"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "The request status."
          }
        }
      },
      "x-api-name": "model_run"
    },
    "/api/v1/model/prediction/{request_id}": {
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "request_id",
            "required": true,
            "schema": {
              "type": "string",
              "description": "Request ID"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PredictionResponse"
                }
              }
            },
            "description": "Result."
          }
        }
      },
      "x-api-name": "model_result"
    }
  },
  "components": {
    "schemas": {
      "Input": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "description": "Model name.",
            "default": "suno/chirp-v5",
            "enum": [
              "suno/chirp-v5"
            ]
          },
          "prompt": {
            "type": "string",
            "description": "Describe the song: style, mood, genre, instrumentation, theme (and lyrics inline if desired). e.g. \"upbeat indie pop about summer nights, female vocal\".",
            "default": "upbeat indie pop about summer nights, bright female vocal, catchy chorus",
            "x-ui-component": "textarea",
            "maxLength": 2000
          },
          "make_instrumental": {
            "type": "boolean",
            "description": "Generate an instrumental track (no vocals).",
            "default": false,
            "x-ui-component": "switch"
          }
        },
        "required": [
          "model",
          "prompt"
        ],
        "x-order-properties": [
          "model",
          "prompt",
          "make_instrumental"
        ]
      },
      "PredictionResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "description": "created|processing|completed|failed"
          },
          "outputs": {
            "type": "array",
            "description": "Generated song URLs (2 variations).",
            "items": {
              "type": "string",
              "x-format": "audio"
            }
          },
          "urls": {
            "type": "object"
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.atlascloud.ai"
    }
  ]
}

Plantilla de Prompt Compatible con LLM

# suno/chirp-v5

> Suno text-to-music (chirp): generate a full song from a text prompt (and optional lyrics). Async; returns 2 variations.


## Overview

- **Submit endpoint (POST)**: `https://api.atlascloud.ai/api/v1/model/generateAudio` — start an async generation; returns a `prediction_id`
- **Poll endpoint (GET)**: `https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}` — poll this until the prediction finishes
- **Model ID**: `suno/chirp-v5`


## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.


### Input Schema

The API accepts the following input parameters:

- **`model`** (`string`, _required_):
  Model name.
  - Default: `"suno/chirp-v5"`
  - Options: "suno/chirp-v5"

- **`prompt`** (`string`, _required_):
  Describe the song: style, mood, genre, instrumentation, theme (and lyrics inline if desired). e.g. "upbeat indie pop about summer nights, female vocal".
  - Default: `"upbeat indie pop about summer nights, bright female vocal, catchy chorus"`

- **`make_instrumental`** (`boolean`, _optional_):
  Generate an instrumental track (no vocals).
  - Default: `false`



**Required Parameters Example**:

```json
{
  "model": "suno/chirp-v5",
  "prompt": "upbeat indie pop about summer nights, bright female vocal, catchy chorus"
}
```


**Full Example**:

```json
{
  "model": "suno/chirp-v5",
  "prompt": "upbeat indie pop about summer nights, bright female vocal, catchy chorus",
  "make_instrumental": false
}
```


### Output Schema

The API returns the following output format:


- **`id`** (`string`, _optional_):

- **`model`** (`string`, _optional_):

- **`status`** (`string`, _optional_):
  created|processing|completed|failed

- **`outputs`** (`array[string]`, _optional_):
  Generated song URLs (2 variations).

- **`urls`** (`object`, _optional_):



**Example Response**:

```json
{
  "id": "",
  "model": "",
  "status": "",
  "outputs": [
    ""
  ],
  "urls": {}
}
```


## Usage Examples

### cURL

```bash
# Step 1: Start generation (async)
curl -X POST "https://api.atlascloud.ai/api/v1/model/generateAudio" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "suno/chirp-v5",
  "prompt": "upbeat indie pop about summer nights, bright female vocal, catchy chorus",
  "make_instrumental": false
}'

# Response will contain: {"code": 200, "data": {"id": "prediction_id", "status": "processing"}}

# Step 2: Poll for result (replace {prediction_id} with the id returned above)
curl -X GET "https://api.atlascloud.ai/api/v1/model/prediction/{prediction_id}" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

# Keep polling until status is "completed", "succeeded" or "failed"
# When completed, outputs will contain the generated content URL(s)
```

## Additional Resources

### Documentation

- [Model Playground](https://www.atlascloud.ai/models/suno/chirp-v5)

upbeat indie pop about summer nights, bright female vocal

Cargando...

Suno Music

Generate a full song — vocals or instrumental — from a text prompt, powered by Suno.

Highlights

Text-to-music: describe the style / mood / genre / theme in prompt; the model composes music + vocals to match.
Each generation returns 2 variations (audio URLs).
make_instrumental: true for an instrumental-only track.

Parameters

field	required	notes
`prompt`	yes	song description (style, mood, theme), ≤2000 chars
`make_instrumental`	no	instrumental only, no vocals

Seed Audio 1.0

Doubao‑Audio‑Generate‑1.0 is Doubao Voice’s next‑generation audio‑generation engine. The industry‑first commercial tool creates film‑grade audio with just one prompt. It eliminates cumbersome audio‑engineering work. Creators generate publish‑ready radio dramas, podcasts and branded audio easily, shifting from a simple voice‑generator to an AI audio director. It serves audiobooks, serialized episodes and commercial audio for high‑quality narrative‑driven production.

xAI TTS v1

xAI TTS v1 is a high-fidelity text-to-speech model that converts text into natural, expressive speech with sub-second latency, supporting 20 languages and 80+ voices with fine-grained delivery control.

ElevenLabs v3 Text-to-Speech

ElevenLabs v3 Text-to-Speech model. High-quality speech generation from text prompts.

MiniMax Music 2.6

MiniMax text-to-music (latest): generate a full vocal or instrumental song from a style prompt plus lyrics with [Verse]/[Chorus] structure tags. Synchronous single-call generation.

Seed ASR 2.0

BytePlus Seed Speech recording-file recognition (ASR 2.0): transcribe an audio file to text with punctuation, ITN, sentence segmentation, speaker diarization, and 51-language support.

xAI STT v1

xAI STT v1 is a production-grade speech-to-text model that transcribes audio into accurate, formatted text. It supports 24+ languages with automatic language detection, word-level timestamps, speaker diarization, multichannel transcription, and inverse text normalization.

From

$0.002/minuto

Una sola API para toda la IA multimedia.

Explorar Todos los Modelos

Suno chirp-v5 API by SUNO

Entrada

Salida

Parámetros

Ejemplo de código

Instalar

Autenticación

Encabezados HTTP

Enviar una solicitud

Enviar una solicitud

Cuerpo de la solicitud

Respuesta

Verificar estado

Ejemplo de polling

Valores de estado

Respuesta completada

Schema de entrada

Ejemplo de cuerpo de solicitud

Schema de salida

Ejemplo de respuesta

Atlas Cloud Skills

Clientes compatibles

Instalar

Configurar clave de API

Funcionalidades

MCP Server

Clientes compatibles

Instalar

Configuración

Herramientas disponibles

API Schema

Plantilla de Prompt Compatible con LLM

Suno Music

Highlights

Parameters

Explorar Modelos Similares

Suno chirp-auk

Suno chirp-fenix

Suno chirp-v3-0

Suno chirp-v3-5

Suno chirp-v3-5-tau

Suno chirp-v4

Suno chirp-v4-tau

Seed Audio 1.0

xAI TTS v1

ElevenLabs v3 Text-to-Speech

MiniMax Music 2.6

Seed ASR 2.0

xAI STT v1

Una sola API para toda la IA multimedia.

Join our Discord community

Entrada

Salida

Parámetros

Ejemplo de código

Instalar

Autenticación

Encabezados HTTP

Enviar una solicitud

Enviar una solicitud

Cuerpo de la solicitud

Respuesta

Verificar estado

Ejemplo de polling

Valores de estado

Respuesta completada

Schema de entrada

Ejemplo de cuerpo de solicitud

Schema de salida

Ejemplo de respuesta

Atlas Cloud Skills

Clientes compatibles

Instalar

Configurar clave de API

Funcionalidades

MCP Server

Clientes compatibles

Instalar

Configuración

Herramientas disponibles