Referencia de API

Suno Generar persona

Usa el endpoint de generación de persona para recibir un resultado en la misma respuesta.

Ver Markdown

Descripción general

Usa el endpoint de generación de persona y lee el resultado de la misma respuesta.

Inicio rápido

Cree una Clave de API y establézcala como RUNAPI_API_KEY.
Envíe una solicitud POST cuyo cuerpo coincida con el esquema de la solicitud.
Lea el resultado en el cuerpo de la respuesta exitosa.

POST /api/v1/suno/generate_persona

URL base: https://runapi.ai
Versión de la API: v1
Autenticación: Authorization: Bearer YOUR_API_TOKEN

Modelos compatibles

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

Suno

Esquema de solicitud

Cuerpo JSON

Envíe únicamente los campos declarados para este endpoint.

Cuerpo de la solicitud4 campos

audio_idstring

Obligatorio

ID de audio dentro de la tarea de origen.

descriptionstring

Obligatorio

Descripción de la persona.

namestring

Obligatorio

Nombre de la persona.

task_idstring

Obligatorio

ID de Task fuente con vocales de referencia.

Respuesta de éxito

HTTP 200

POST /api/v1/suno/generate_persona

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
    },
    "persona": {
      "properties": {
        "description": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "name",
        "description"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  },
  "required": [
    "persona",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON

{
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "persona": {
    "description": "A warm and expressive vocal character.",
    "id": "persona_reference",
    "name": "Studio Voice"
  }
}

Errores

HTTP 401

POST /api/v1/suno/generate_persona

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"
}

Errores

HTTP 400

POST /api/v1/suno/generate_persona

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": "Validation failed",
  "errors": {
    "task_id": [
      "is required"
    ]
  }
}

Errores

HTTP 402

POST /api/v1/suno/generate_persona

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"
}

Errores

HTTP 429

POST /api/v1/suno/generate_persona

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"
}

Errores

HTTP 409

POST /api/v1/suno/generate_persona

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"
}

Errores

HTTP 429

POST /api/v1/suno/generate_persona

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."
}

Errores

HTTP 503

POST /api/v1/suno/generate_persona

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"
}

Errores

HTTP 504

POST /api/v1/suno/generate_persona

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"
}

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"])
result = client.generate_persona.run(
  task_id="tsk_reference_demo",
  audio_id="audio_reference",
  name="Studio Style",
  description="A warm and expressive acoustic pop style."
)

Instalar

Shell

npm install @runapi.ai/suno

JAVASCRIPT

import { SunoClient } from "@runapi.ai/suno";

const client = new SunoClient({ apiKey: process.env.RUNAPI_API_KEY });
const result = await client.generatePersona.run({
  "task_id": "tsk_reference_demo",
  "audio_id": "audio_reference",
  "name": "Studio Style",
  "description": "A warm and expressive acoustic pop style."
});

CURL

curl -X POST https://runapi.ai/api/v1/suno/generate_persona \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"task_id":"tsk_reference_demo","audio_id":"audio_reference","name":"Studio Style","description":"A warm and expressive acoustic pop style."}'

Instalar

Shell

go get github.com/runapi-ai/suno-sdk/go@latest

package main

import (
  "context"
  "log"
  "os"

  "github.com/runapi-ai/core-sdk/go/option"
  suno "github.com/runapi-ai/suno-sdk/go/suno"
)

func main() {
  client, err := suno.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY")))
  if err != nil {
    log.Fatal(err)
  }

  result, err := client.GeneratePersona.Run(context.Background(), suno.GeneratePersonaParams{
    TaskID: "tsk_reference_demo",
    AudioID: "audio_reference",
    Name: "Studio Style",
    Description: "A warm and expressive acoustic pop style.",
  })
  if err != nil {
    log.Fatal(err)
  }
  _ = result
}

import os from runapi.suno import SunoClient client = SunoClient(api_key=os.environ["RUNAPI_API_KEY"]) result = client.generate_persona.run( task_id="tsk_reference_demo", audio_id="audio_reference", name="Studio Style", description="A warm and expressive acoustic pop style." )

import { SunoClient } from "@runapi.ai/suno"; const client = new SunoClient({ apiKey: process.env.RUNAPI_API_KEY }); const result = await client.generatePersona.run({ "task_id": "tsk_reference_demo", "audio_id": "audio_reference", "name": "Studio Style", "description": "A warm and expressive acoustic pop style." });

curl -X POST https://runapi.ai/api/v1/suno/generate_persona \ -H 'Authorization: Bearer YOUR_API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"task_id":"tsk_reference_demo","audio_id":"audio_reference","name":"Studio Style","description":"A warm and expressive acoustic pop style."}'

package main import ( "context" "log" "os" "github.com/runapi-ai/core-sdk/go/option" suno "github.com/runapi-ai/suno-sdk/go/suno" ) func main() { client, err := suno.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY"))) if err != nil { log.Fatal(err) } result, err := client.GeneratePersona.Run(context.Background(), suno.GeneratePersonaParams{ TaskID: "tsk_reference_demo", AudioID: "audio_reference", Name: "Studio Style", Description: "A warm and expressive acoustic pop style.", }) if err != nil { log.Fatal(err) } _ = result }

{ "billing": { "refund": null, "reservation": null, "settlement": null }, "persona": { "description": "A warm and expressive vocal character.", "id": "persona_reference", "name": "Studio Voice" } }

Suno Generar persona

Descripción general

Inicio rápido

Endpoint

Modelos compatibles

Esquema de solicitud

Respuesta de éxito

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Ejemplos de código generados

Instalar

Guías relacionadas