API de Suno: prompts y guiones en un solo endpoint

Autenticación y URL base

Nuestra API utiliza la autenticación estándar de OpenAI. Solo necesitas una clave de API, que generas en la página Obtener clave de API. No se requiere número de teléfono ni tarjeta de crédito para comenzar; cada cuenta nueva recibe $0.50 en crédito de prueba válido por 7 días.

Configura la base URL en https://api.sunoapis.com/v1 en la configuración de tu cliente. El identificador de modelo que debes enviar en cada petición es uncensored. Es un modelo de pesos abiertos alojado en nuestros propios servidores GPU, ajustado para uso adulto y creativo sin las denegaciones típicas de los principales proveedores.

• URL base: https://api.sunoapis.com/v1
• ID del modelo: uncensored
• Cabecera de autenticación: Authorization: Bearer YOUR_API_KEY

Primera petición

Comienza de inmediato con una petición estándar de finalización de chat. El endpoint acepta cargas útiles en JSON que contienen tu prompt de sistema, instrucciones del usuario y cualquier metadato necesario para tu pipeline de texto a video o música con IA.

Esta es una API solo de texto. No genera audio, video ni imágenes; genera las instrucciones de texto que impulsan esas herramientas. Usa este endpoint para guionar escenas, escribir letras o extraer datos estructurados de tus activos creativos.

Copycurl https://api.sunoapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

SDK de Python

Integra la API en tus aplicaciones Python usando la SDK oficial de OpenAI. Al ser compatibles con OpenAI, puedes reutilizar tu código existente simplemente cambiando la URL base y la clave de API.

Este enfoque funciona para generar guiones para herramientas de generación de video o escribir metadatos para APIs de música. Asegúrate de que la versión de tu SDK esté actualizada para admitir las funciones de streaming y llamadas a funciones descritas en las siguientes secciones.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.sunoapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

SDK de Node.js

Para desarrolladores de JavaScript/TypeScript, el paquete @anthropic-ai/sdk o el paquete oficial openai funcionan con ajustes de configuración menores. Apunta tu cliente a nuestra base URL y utiliza el ID de modelo uncensored.

Esto te permite generar texto en el lado del servidor para tus aplicaciones creativas. Puedes usarlo para preprocesar entradas de usuario o postprocesar guiones generados antes de enviarlos a tus endpoints de generación de audio o video. La API devuelve respuestas JSON estándar compatibles con frameworks web modernos.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.sunoapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Respuestas en streaming

Para guiones largos o metadatos detallados, usa Eventos Enviados por Servidor (SSE) para recibir tokens en tiempo real. Establece stream: true en el cuerpo de tu petición. La API enviará una serie de fragmentos, permitiéndote mostrar el texto a medida que se genera.

Esto es particularmente útil para herramientas creativas interactivas donde los usuarios quieren ver cómo evoluciona el prompt a medida que se escribe. Cada fragmento contiene solo el texto delta, por lo que debes concatenar los fragmentos para reconstruir la respuesta completa.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Límites, errores y contexto

Cada cuenta está limitada a una clave de API, que puede regenerarse en cualquier momento (revocando la anterior). Tienes permitido realizar 300 peticiones por minuto por clave, con un tamaño máximo del cuerpo de la petición de 8 MB.

Los errores comunes incluyen 401 para claves inválidas, 402 si tienes crédito prepago insuficiente y 429 por límites de peticiones. El modelo admite una ventana de contexto de 100.000 tokens para entrada y salida combinadas.

Nota de contenido: El modelo no rechaza temas controvertidos o para adultos, pero bloquea estrictamente el contenido sexual que involucre a menores en todas las peticiones.