
Escreve músicas completas a partir de uma descrição de estilo, com vocais, arranjos e mixagens, ou instrumentais e covers.
Escreve músicas completas a partir de uma descrição de estilo, com vocais, arranjos e mixagens, ou instrumentais e covers.
A geração é assíncrona e geralmente leva de dezenas de segundos a alguns minutos.
Também conhecido como StepFun StepAudio 3 Music
stepaudio-3-music/v1/audio/generationsstepaudio-3-music-previewstepfun/stepaudio-3-musicTarifas pay-as-you-go ao vivo do catálogo EmpirioLabs. Você paga só pelo que usa, sem mínimo mensal.
StepAudio 3 Music roda por POST /v1/audio/generations. A requisição retorna um job_id na hora; consulte GET /v1/jobs/{job_id} até o job terminar e leia as URLs de saída do resultado. Obtenha uma chave de API no painel EmpirioLabs.
curl https://api.empiriolabs.ai/v1/audio/generations \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "stepaudio-3-music",
"prompt": "Describe what you want StepAudio 3 Music to generate."
}'curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/audio/generations",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "stepaudio-3-music",
"prompt": "Describe what you want StepAudio 3 Music to generate.",
},
)
job = response.json()
# Generation runs as an async job. Poll until it completes.
import time
while True:
status = requests.get(
f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
).json()
if status.get("status") in ("completed", "failed"):
print(status)
break
time.sleep(5)Parâmetros de requisição suportados pela API StepAudio 3 Music na EmpirioLabs. Os padrões valem quando um campo é omitido.
| Parâmetro | Tipo | Padrão | Intervalo / valores | Descrição |
|---|---|---|---|---|
| prompt | string | - | - | Descrição de estilo: gênero, vocais, clima, instrumentos e tonalidade. |
| lyrics | string | - | - | Letras opcionais. Tags de seção como [Verso], [Refrão] e [Outro] moldam a estrutura. Se deixadas vazias, o modelo as escreve. Necessárias para um cover ou arranjo vocal. |
| task | enum | text_to_music | text_to_music, music_cover, vocal_to_music | Escreva uma música nova, faça um cover de uma música de referência ou construa um arranjo em torno de um vocal seco. |
| instrumental | boolean | false | - | Gerar uma faixa sem vocais. Não pode ser combinado com letras. |
| song_audio | string | - | - | Canção de referência Base64. Necessária para um cover. |
| vocal_audio | string | - | - | Voz seca base64 sem acompanhamento. Necessário para arranjo vocal. |
| response_format | enum | mp3 | mp3, wav, flac, opus, pcm | Formato de áudio de saída. |
| temperature | number | 0.85 | 0.01 a 2 | Temperatura de amostragem. Maior é mais variado. |
| top_p | number | 0.92 | 0 a 1 | Amostragem do núcleo com a probabilidade de massa. |
| lyrics_rewrite | boolean | false | - | Deixe a modelo reescrever as letras que você forneceu. |
Descreva o estilo e o modelo escreve e executa uma música completa. Forneça letras ou deixe o modelo escrevê-las, defina instrumental para uma faixa sem vocais, ou anexe uma música de referência para um cover ou um vocal seco para construir um arranjo em volta. Tags de seção como [Verso], [Refrão] e [Outro] moldam a estrutura. O comprimento de saída é escolhido pelo modelo e normalmente é de um a três minutos, então não é definido por um parâmetro e duas execuções do mesmo prompt podem ser diferentes. O faturamento segue o comprimento gerado. Instrumental e letra não podem ser combinados. Este modelo está em prévia e suas capacidades podem mudar.
Na EmpirioLabs, StepAudio 3 Music é cobrado por uso: Geração musical $0.0018 por segundo gerado. A tabela de tarifas ao vivo desta página sempre corresponde ao que a API cobra.
StepAudio 3 Music é servido por POST /v1/audio/generations em api.empiriolabs.ai com autenticação padrão por token Bearer.
Sim. O playground da EmpirioLabs executa StepAudio 3 Music no navegador com os mesmos parâmetros que a API expõe, para você testar prompts antes de escrever código.
Crie uma conta EmpirioLabs e gere uma chave em API Keys no painel. A cobrança usa créditos pay-as-you-go, então você paga apenas pelas requisições que faz.
Confira nossos preços ou entre em contato se quiser que seu próprio modelo seja implementado em nossa pilha.