Referência de API

Suno Gerar persona

Use o endpoint generate persona para receber um resultado na mesma resposta.

Ver Markdown

Visão geral

Use o endpoint generate persona e leia o resultado na mesma resposta.

Início rápido

Crie uma Chave de API e defina-a como RUNAPI_API_KEY.
Envie uma requisição POST cujo corpo corresponda ao schema da requisição.
Leia o resultado do corpo da resposta bem-sucedida.

POST /api/v1/suno/generate_persona

URL base: https://runapi.ai
Versão da API: v1
Autenticação: Authorization: Bearer YOUR_API_TOKEN

Modelos suportados

Abra uma página de modelo para ver preços atuais, limites de taxa e detalhes de uso comercial.

Suno

Esquema de solicitação

Corpo JSON

Envie apenas os campos declarados para este endpoint.

Corpo da solicitação4 campos

audio_idstring

Obrigatório

ID do áudio dentro da tarefa de origem.

descriptionstring

Obrigatório

Descrição da persona.

namestring

Obrigatório

Nome da persona.

task_idstring

Obrigatório

ID de task de origem com vocais de referência.

Resposta de sucesso

HTTP 200

POST /api/v1/suno/generate_persona

Esquema de resposta

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
}

Exemplo de resposta

JSON

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

Erros

HTTP 401

POST /api/v1/suno/generate_persona

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

{
  "error": "Authentication required"
}

Erros

HTTP 400

POST /api/v1/suno/generate_persona

Esquema de resposta

JSON

{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "Mensagem de erro legível por humanos.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "Resumo de validação legível por humanos.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Mensagens de validação com chaves por campo de requisição público, com um array de strings legíveis por humanos para cada campo.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Exemplo de resposta

JSON

{
  "error": "Validation failed",
  "errors": {
    "task_id": [
      "is required"
    ]
  }
}

Erros

HTTP 402

POST /api/v1/suno/generate_persona

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

{
  "error": "Insufficient balance"
}

Erros

HTTP 429

POST /api/v1/suno/generate_persona

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Erros

HTTP 409

POST /api/v1/suno/generate_persona

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Erros

HTTP 429

POST /api/v1/suno/generate_persona

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Erros

HTTP 503

POST /api/v1/suno/generate_persona

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Erros

HTTP 504

POST /api/v1/suno/generate_persona

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Exemplos de Código Gerados

Use cURL diretamente ou instale um SDK para a sua linguagem. Cada exemplo submete a requisição validada mostrada nesta referência.

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 Gerar persona

Visão geral

Início rápido

Endpoint

Modelos suportados

Esquema de solicitação

Resposta de sucesso

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Exemplos de Código Gerados

Instalar

Guias Relacionados