Pular para o conteúdo principal
POST
Gerar música
Envie um model e um prompt para POST /v1/music/generate e receba uma faixa de qualquer provedor de música com um único formato de solicitação. O Phaseo cuida dos provedores síncronos e da consulta às filas dos provedores para você.

Ler o resultado

Uma geração concluída inclui audio_url ou audio_base64. status é queued, in_progress, completed ou failed. Enquanto ele ainda não for final, consulte GET /v1/music/generate/{music_id} com o mesmo id. id é o ID estável da solicitação no Phaseo. nativeResponseId é o identificador do provedor upstream, para correlação com o provedor e suporte. usage inclui output_audio_seconds quando o provedor informa a duração gerada.

Definir opções do Suno

Os modelos Suno aceitam um objeto suno opcional: prompt é obrigatório quando customMode é false, e quando customMode é true com instrumental definido como false. Uma solicitação que viola uma regra do provedor retorna 400:

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Corpo

application/json
model
string
obrigatório
models
string[]

Modelos de fallback opcionais e ordenados, tentados depois de model. model é obrigatório e é sempre o modelo principal. Quando uma tentativa falha com 429, 500, 502, 503 ou 504, a próxima entrada é tentada; os demais erros são retornados sem alteração. Aceita até 25 IDs de modelo ou predefinições; duplicatas e entradas iguais a model são ignoradas. Cada tentativa é validada, registrada e cobrada como uma solicitação separada, e o campo model da resposta e o rastreamento de roteamento mostram o modelo que atendeu a solicitação. Solicitações em streaming só recorrem a um fallback antes do primeiro byte, e trabalhos de vídeo e música apenas no envio. Solicitações de batch, realtime e council rejeitam models. Fallbacks definidos em uma rota dinâmica têm precedência, e phaseo/auto não pode ser combinado com models.

Required array length: 1 - 25 elements
Minimum string length: 1
Exemplo:
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 16 de novembro de 2026