Skip to main content
POST
Gerar música
Gere música por meio de uma API independente do provedor. O Phaseo gerencia respostas síncronas e consulta as filas dos provedores em segundo plano. Quando a geração for concluída, a resposta incluirá audio_url ou audio_base64. Se um provedor retornar um trabalho ainda não finalizado, use o mesmo id da resposta com GET /music/generate/{music_id}.

Formato da solicitação

Opções do Suno

  • suno.customMode (booleano; padrão: false)
  • suno.instrumental (booleano; padrão: false)
  • suno.prompt (substituição opcional de prompt no nível superior)
  • suno.style, suno.title (obrigatório quando customMode = true)
  • suno.personaId, suno.personaModel
  • suno.negativeTags, suno.vocalGender
  • suno.styleWeight, suno.weirdnessConstraint, suno.audioWeight

Regras de validação

  • Quando customMode = false, prompt é obrigatório.
  • Quando customMode = true, style e title são obrigatórios.
  • Quando customMode = true e instrumental = false, prompt é obrigatório.
Erros de validação retornam 400 com:

Resposta

  • id é o ID estável da solicitação no Phaseo. Use-o para recuperar a solicitação por meio de GET /music/generate/{music_id}.
  • nativeResponseId é o identificador do provedor de origem e serve para correlacionar a solicitação com o provedor e acionar o suporte.
  • status pode ser queued, in_progress, completed ou failed.
  • usage pode incluir output_audio_seconds quando o provedor informar a duração gerada.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

application/json
model
string
obrigatório
prompt
string
duration
integer
format
enum<string>
Opções disponíveis:
mp3,
wav,
ogg,
aac
provider
object

Preferências de roteamento de provedores para seleção pelo gateway.

suno
object
elevenlabs
object
echo_upstream_request
boolean
debug
object

Controles de depuração do gateway. Essas opções nunca são encaminhadas ao provedor.

Resposta

200 - application/json

Resposta da geração de música

id
string
obrigatório

ID estável da solicitação Phaseo, usado com GET /music/generate/{music_id}.

object
enum<string>
obrigatório
Opções disponíveis:
music
status
enum<string>
obrigatório
Opções disponíveis:
queued,
in_progress,
completed,
failed
model
string
obrigatório
provider
string
obrigatório
nativeResponseId
string | null

Identificador do provedor upstream para correlação e suporte.

audio_url
string<uri>
audio_base64
string
result
any

Metadados do resultado do provedor normalizados pelo Phaseo.

output
object[]
usage
object
Última modificação em 2 de outubro de 2026