Saltar al contenido
Referencia de API
Referencia de API

Suno Crear mashup

Usa el endpoint de creación de mashup para crear una Task asíncrona.

Ver Markdown
01

Descripción general

Usa el endpoint de creación de mashup con un modelo compatible. Usa el ID de Task devuelto para recuperar su estado, o proporciona callback_url para las entregas documentadas a continuación.

Inicio rápido

  1. Cree una Clave de API y establézcala como RUNAPI_API_KEY.
  2. Elija un modelo compatible y envíe una solicitud POST cuyo cuerpo coincida con el esquema de ese modelo.
  3. Almacena el ID de tarea devuelto, luego sondea hasta alcanzar un estado terminal o gestiona las devoluciones de llamada documentadas a continuación.

Endpoint

POST /api/v1/suno/create_mashup
URL base
https://runapi.ai
Versión de la API
v1
Autenticación
Authorization: Bearer YOUR_API_TOKEN
02

Modelos compatibles

Abra una página de modelo para conocer los precios actuales, los límites de velocidad y los detalles de uso comercial.

03

Esquema de solicitud

Cuerpo JSON

Los campos y los valores permitidos dependen del modelo seleccionado. Cuando se proporciona, callback_url recibe las entregas de tareas documentadas a continuación.

suno-v414 campos
audio_weightnumber
Opcional

Peso del audio (0-1).

Rango: 0 - 1
callback_urlstring
Opcional

URL de webhook para notificaciones asíncronas.

lyricsstring
Opcional

Letra exacta de mashup para cantar.

Límite: 5000
modelstring
Obligatorio

Identificador del modelo.

persona_idstring
Opcional

ID de persona.

persona_typestring
Opcional

Tipo de persona.

Valores permitidos: style, voice
promptstring
Opcional

Resumen de mashup para letras automáticas.

Límite: 5000
stylestring
Opcional

Estilo musical.

Límite: 1000
style_weightnumber
Opcional

Peso de adherencia al estilo (0-1).

Rango: 0 - 1
titlestring
Opcional

Título musical.

Límite: 80
upload_url_listarray
Obligatorio

Dos URLs de audio para mezclar.

Rango de elementos: 2 - 2
vocal_genderstring
Opcional

Género vocal.

Valores permitidos: male, female
vocal_modestring
Obligatorio

Modo de generación vocal.

Valores permitidos: auto_lyrics, exact_lyrics, instrumental
weirdness_constraintnumber
Opcional

Restricción de rareza (0-1).

Rango: 0 - 1
suno-v4.514 campos
audio_weightnumber
Opcional

Peso del audio (0-1).

Rango: 0 - 1
callback_urlstring
Opcional

URL de webhook para notificaciones asíncronas.

lyricsstring
Opcional

Letra exacta de mashup para cantar.

Límite: 5000
modelstring
Obligatorio

Identificador del modelo.

persona_idstring
Opcional

ID de persona.

persona_typestring
Opcional

Tipo de persona.

Valores permitidos: style, voice
promptstring
Opcional

Resumen de mashup para letras automáticas.

Límite: 5000
stylestring
Opcional

Estilo musical.

Límite: 1000
style_weightnumber
Opcional

Peso de adherencia al estilo (0-1).

Rango: 0 - 1
titlestring
Opcional

Título musical.

Límite: 80
upload_url_listarray
Obligatorio

Dos URLs de audio para mezclar.

Rango de elementos: 2 - 2
vocal_genderstring
Opcional

Género vocal.

Valores permitidos: male, female
vocal_modestring
Obligatorio

Modo de generación vocal.

Valores permitidos: auto_lyrics, exact_lyrics, instrumental
weirdness_constraintnumber
Opcional

Restricción de rareza (0-1).

Rango: 0 - 1
suno-v4.5-all14 campos
audio_weightnumber
Opcional

Peso del audio (0-1).

Rango: 0 - 1
callback_urlstring
Opcional

URL de webhook para notificaciones asíncronas.

lyricsstring
Opcional

Letra exacta de mashup para cantar.

Límite: 5000
modelstring
Obligatorio

Identificador del modelo.

persona_idstring
Opcional

ID de persona.

persona_typestring
Opcional

Tipo de persona.

Valores permitidos: style, voice
promptstring
Opcional

Resumen de mashup para letras automáticas.

Límite: 5000
stylestring
Opcional

Estilo musical.

Límite: 1000
style_weightnumber
Opcional

Peso de adherencia al estilo (0-1).

Rango: 0 - 1
titlestring
Opcional

Título musical.

Límite: 80
upload_url_listarray
Obligatorio

Dos URLs de audio para mezclar.

Rango de elementos: 2 - 2
vocal_genderstring
Opcional

Género vocal.

Valores permitidos: male, female
vocal_modestring
Obligatorio

Modo de generación vocal.

Valores permitidos: auto_lyrics, exact_lyrics, instrumental
weirdness_constraintnumber
Opcional

Restricción de rareza (0-1).

Rango: 0 - 1
suno-v4.5-plus14 campos
audio_weightnumber
Opcional

Peso del audio (0-1).

Rango: 0 - 1
callback_urlstring
Opcional

URL de webhook para notificaciones asíncronas.

lyricsstring
Opcional

Letra exacta de mashup para cantar.

Límite: 5000
modelstring
Obligatorio

Identificador del modelo.

persona_idstring
Opcional

ID de persona.

persona_typestring
Opcional

Tipo de persona.

Valores permitidos: style, voice
promptstring
Opcional

Resumen de mashup para letras automáticas.

Límite: 5000
stylestring
Opcional

Estilo musical.

Límite: 1000
style_weightnumber
Opcional

Peso de adherencia al estilo (0-1).

Rango: 0 - 1
titlestring
Opcional

Título musical.

Límite: 80
upload_url_listarray
Obligatorio

Dos URLs de audio para mezclar.

Rango de elementos: 2 - 2
vocal_genderstring
Opcional

Género vocal.

Valores permitidos: male, female
vocal_modestring
Obligatorio

Modo de generación vocal.

Valores permitidos: auto_lyrics, exact_lyrics, instrumental
weirdness_constraintnumber
Opcional

Restricción de rareza (0-1).

Rango: 0 - 1
suno-v514 campos
audio_weightnumber
Opcional

Peso del audio (0-1).

Rango: 0 - 1
callback_urlstring
Opcional

URL de webhook para notificaciones asíncronas.

lyricsstring
Opcional

Letra exacta de mashup para cantar.

Límite: 5000
modelstring
Obligatorio

Identificador del modelo.

persona_idstring
Opcional

ID de persona.

persona_typestring
Opcional

Tipo de persona.

Valores permitidos: style, voice
promptstring
Opcional

Resumen de mashup para letras automáticas.

Límite: 5000
stylestring
Opcional

Estilo musical.

Límite: 1000
style_weightnumber
Opcional

Peso de adherencia al estilo (0-1).

Rango: 0 - 1
titlestring
Opcional

Título musical.

Límite: 80
upload_url_listarray
Obligatorio

Dos URLs de audio para mezclar.

Rango de elementos: 2 - 2
vocal_genderstring
Opcional

Género vocal.

Valores permitidos: male, female
vocal_modestring
Obligatorio

Modo de generación vocal.

Valores permitidos: auto_lyrics, exact_lyrics, instrumental
weirdness_constraintnumber
Opcional

Restricción de rareza (0-1).

Rango: 0 - 1
suno-v5.514 campos
audio_weightnumber
Opcional

Peso del audio (0-1).

Rango: 0 - 1
callback_urlstring
Opcional

URL de webhook para notificaciones asíncronas.

lyricsstring
Opcional

Letra exacta de mashup para cantar.

Límite: 5000
modelstring
Obligatorio

Identificador del modelo.

persona_idstring
Opcional

ID de persona.

persona_typestring
Opcional

Tipo de persona.

Valores permitidos: style, voice
promptstring
Opcional

Resumen de mashup para letras automáticas.

Límite: 5000
stylestring
Opcional

Estilo musical.

Límite: 1000
style_weightnumber
Opcional

Peso de adherencia al estilo (0-1).

Rango: 0 - 1
titlestring
Opcional

Título musical.

Límite: 80
upload_url_listarray
Obligatorio

Dos URLs de audio para mezclar.

Rango de elementos: 2 - 2
vocal_genderstring
Opcional

Género vocal.

Valores permitidos: male, female
vocal_modestring
Obligatorio

Modo de generación vocal.

Valores permitidos: auto_lyrics, exact_lyrics, instrumental
weirdness_constraintnumber
Opcional

Restricción de rareza (0-1).

Rango: 0 - 1

Reglas condicionales

Estos requisitos se aplican cuando todas las condiciones enumeradas coinciden.

  1. Cuando vocal_mode = auto_lyrics
    Obligatorio
    prompt
    No aceptado
    lyrics, style, title
  2. Cuando vocal_mode = exact_lyrics
    Obligatorio
    lyrics, style, title
    No aceptado
    prompt
  3. Cuando vocal_mode = instrumental
    Obligatorio
    style, title
    No aceptado
    prompt, lyrics
04

Crear aceptación

HTTP 202

POST /api/v1/suno/create_mashup

Esquema de respuesta
JSON 
{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    },
    "task_replayed": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "processing"
}
05

Consulta en proceso

HTTP 200

GET /api/v1/suno/create_mashup/:id

Esquema de respuesta
JSON 
{
  "properties": {
    "audios": {
      "items": {
        "properties": {
          "audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "duration": {
            "type": "number"
          },
          "id": {
            "type": "string"
          },
          "image_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "lyrics": {
            "type": "string"
          },
          "model_name": {
            "type": "string"
          },
          "stream_audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    },
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "generation_stage": {
      "enum": [
        "text_generated",
        "first_audio_ready"
      ],
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "generation_stage": "text_generated",
  "id": "tsk_reference_demo",
  "status": "processing"
}
06

Consulta completada

HTTP 200

GET /api/v1/suno/create_mashup/:id

Esquema de respuesta
JSON 
{
  "properties": {
    "audios": {
      "items": {
        "properties": {
          "audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "duration": {
            "type": "number"
          },
          "id": {
            "type": "string"
          },
          "image_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "lyrics": {
            "type": "string"
          },
          "model_name": {
            "type": "string"
          },
          "stream_audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    },
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "generation_stage": {
      "enum": [
        "text_generated",
        "first_audio_ready",
        "all_audios_ready",
        "failed"
      ],
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "audios",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "audios": [
    {
      "audio_url": "https://file.runapi.ai/reference-audio.mp3",
      "id": "audio_reference"
    }
  ],
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "tsk_reference_demo",
  "status": "completed"
}
07

Consulta fallida

HTTP 200

GET /api/v1/suno/create_mashup/:id

Esquema de respuesta
JSON 
{
  "properties": {
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "error": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "error": "Task processing failed.",
  "id": "tsk_reference_demo",
  "status": "failed"
}
08

Devolución de llamada del cliente: procesando

HTTP 200

POST callback_url

Esquema de respuesta
JSON 
{
  "properties": {
    "audios": {
      "items": {
        "properties": {
          "audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "duration": {
            "type": "number"
          },
          "id": {
            "type": "string"
          },
          "image_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "lyrics": {
            "type": "string"
          },
          "model_name": {
            "type": "string"
          },
          "stream_audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    },
    "generation_stage": {
      "enum": [
        "text_generated",
        "first_audio_ready"
      ],
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "processing"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "generation_stage": "text_generated",
  "id": "tsk_reference_demo",
  "status": "processing"
}
09

Devolución de llamada del cliente: completado

HTTP 200

POST callback_url

Esquema de respuesta
JSON 
{
  "properties": {
    "audios": {
      "items": {
        "properties": {
          "audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "duration": {
            "type": "number"
          },
          "id": {
            "type": "string"
          },
          "image_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "lyrics": {
            "type": "string"
          },
          "model_name": {
            "type": "string"
          },
          "stream_audio_url": {
            "type": "string",
            "x-runapi-generated-media": true
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object",
        "unevaluatedProperties": false
      },
      "type": "array"
    },
    "generation_stage": {
      "enum": [
        "text_generated",
        "first_audio_ready",
        "all_audios_ready",
        "failed"
      ],
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "completed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "audios"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "audios": [
    {
      "audio_url": "https://file.runapi.ai/reference-audio.mp3",
      "id": "audio_reference"
    }
  ],
  "id": "tsk_reference_demo",
  "status": "completed"
}
10

Devolución de llamada del cliente: fallido

HTTP 200

POST callback_url

Esquema de respuesta
JSON 
{
  "properties": {
    "error": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "properties": {
            "code": {
              "type": "string"
            },
            "limit_cents": {
              "type": "integer"
            },
            "message": {
              "type": "string"
            },
            "reset_at": {
              "format": "date-time",
              "type": [
                "string",
                "null"
              ]
            },
            "used_cents": {
              "type": "integer"
            },
            "window": {
              "enum": [
                "1h",
                "1d",
                "7d",
                "daily",
                "weekly",
                "monthly",
                "lifetime"
              ],
              "type": "string"
            }
          },
          "required": [
            "code",
            "message"
          ],
          "type": "object",
          "unevaluatedProperties": false
        }
      ]
    },
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "failed"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "status",
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "error": {
    "code": "generation_failed",
    "message": "Task processing failed."
  },
  "id": "tsk_reference_demo",
  "status": "failed"
}
11

Errores

HTTP 401

POST /api/v1/suno/create_mashup

Esquema de respuesta
JSON 
{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "error": "Authentication required"
}
12

Errores

HTTP 401

GET /api/v1/suno/create_mashup/:id

Esquema de respuesta
JSON 
{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "error": "Authentication required"
}
13

Errores

HTTP 400

POST /api/v1/suno/create_mashup

Esquema de respuesta
JSON 
{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "Mensaje de error legible por personas.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "Resumen de validación legible por personas.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Mensajes de validación con clave por campo de solicitud público, con un array de cadenas legibles por personas para cada campo.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Ejemplo de respuesta

JSON 
{
  "error": "model must be one of: suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, suno-v5.5"
}
14

Errores

HTTP 402

POST /api/v1/suno/create_mashup

Esquema de respuesta
JSON 
{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "error": "Insufficient balance"
}
15

Errores

HTTP 429

POST /api/v1/suno/create_mashup

Esquema de respuesta
JSON 
{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "error": "API key credit limit exceeded"
}
16

Errores

HTTP 409

POST /api/v1/suno/create_mashup

Esquema de respuesta
JSON 
{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "error": "The request uses features that are not supported for the selected model"
}
17

Errores

HTTP 429

POST /api/v1/suno/create_mashup

Esquema de respuesta
JSON 
{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "error": "Rate limit reached. Please retry later."
}
18

Errores

HTTP 503

POST /api/v1/suno/create_mashup

Esquema de respuesta
JSON 
{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "error": "Service under maintenance, please try again later"
}
19

Errores

HTTP 504

POST /api/v1/suno/create_mashup

Esquema de respuesta
JSON 
{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "error": "The request timed out"
}
20

Errores

HTTP 404

GET /api/v1/suno/create_mashup/:id

Esquema de respuesta
JSON 
{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON 
{
  "error": "Task with id 'tsk_reference_demo' not found"
}
21

Ejemplos de código generados

Usa cURL directamente o instala un SDK para tu lenguaje. Cada muestra envía la solicitud validada que se muestra en esta referencia.

Instalar

Shell 
pip install runapi-suno
PYTHON 
import os
from runapi.suno import SunoClient

client = SunoClient(api_key=os.environ["RUNAPI_API_KEY"])
task = client.create_mashup.create(
  model="suno-v5",
  upload_url_list=["https://cdn.runapi.ai/public/samples/music.mp3", "https://cdn.runapi.ai/public/samples/audio-2.mp3"],
  vocal_mode="auto_lyrics",
  prompt="Blend both tracks into an energetic pop mashup.",
  persona_id="persona_reference",
  persona_type="style"
)