API v1

Documentação da API FM9

Construa recursos poderosos de geração de música em seus aplicativos com nossa REST API.

Início Rápido

Gere sua primeira faixa com uma única chamada de API.

Requestbash

curl -X POST https://api.fm9.ai/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "música eletrônica dançante animada"}'

Responsejson

{
  "id": "gen_abc123",
  "status": "processing",
  "estimated_time": 30
}

Autenticação

Todas as solicitações de API requerem uma chave de API. Inclua sua chave no cabeçalho Authorization:

Obtenha sua chave de API no painel do desenvolvedor.

Authorization: Bearer YOUR_API_KEY

Endpoints

POST/v1/generate

Gerar Música

Cria uma nova tarefa de geração de música.

Parameters

prompt-Descrição textual da música a gerar (obrigatório)
duration-Duração da faixa em segundos (30-180, padrão: 60)
style-Preset de estilo musical (opcional)
instrumental-Se deve gerar apenas instrumental (padrão: false)

Retorna um objeto de geração com ID da tarefa e status.

GET/v1/generation/:id

Obter Status da Geração

Verifica o status de uma tarefa de geração.

Retorna o objeto de geração com status atual e URLs de download quando concluído.

GET/v1/generations

Listar Gerações

Recupera uma lista do seu histórico de geração.

Parameters

limit-Número de resultados a retornar (padrão: 20, máx: 100)
offset-Deslocamento de paginação (padrão: 0)
status-Filtrar por status (pending, processing, completed, failed)

Preços da API

Preços simples e transparentes baseados em uso.

Starter

Grátis

10 gerações/mês

Acesso básico à API
Qualidade padrão
Suporte da comunidade

Developer

$49/mo

500 gerações/mês

Acesso completo à API
Saída de alta qualidade
Suporte prioritário
Callbacks Webhook

Enterprise

Personalizado

Ilimitado

Infraestrutura dedicada
Modelos personalizados
Garantia SLA
Suporte 24/7

Limites de Taxa

Para garantir uso justo e estabilidade do serviço, os seguintes limites se aplicam:

Starter: 10 solicitações/minuto
Developer: 60 solicitações/minuto
Enterprise: Limites personalizados

Se você exceder o limite, receberá uma resposta 429 Too Many Requests.

Códigos de Erro

A API usa códigos de resposta HTTP padrão para indicar sucesso ou falha.

Code	Description
400	Bad Request - Parâmetros inválidos
401	Unauthorized - Chave de API inválida ou ausente
402	Payment Required - Créditos insuficientes
429	Too Many Requests - Limite de taxa excedido
500	Internal Server Error - Algo deu errado do nosso lado

Precisa de Ajuda?

Nossa equipe de suporte ao desenvolvedor está aqui para ajudar.

Email: [email protected]

Documentação completa disponível em docs.fm9.ai