Lançamento da API para Desenvolvedores do ClipMixAI

Hoje estamos abrindo os motores que alimentam o app web do ClipMixAI para quem quiser construir sobre eles. A nova API de Desenvolvedor em api.clipmixai.com/api/v1 expõe quatro serviços — tradução de vídeo, vídeo de memória, troca de rosto & avatares, e música com IA — por uma única superfície REST com Bearer token. Mesmos modelos, mesma qualidade, mesmos créditos. Sem assinatura obrigatória. Sem mínimo.

Se preferir ir direto ao ponto: /api tem a apresentação, /api/docs tem a referência completa, e /dashboard/api-keys é onde você cria sua chave.

Por que construímos isso

Ao longo do último ano, observamos usuários pagantes repetindo sempre os mesmos passos: abrir o painel, enviar 30 fotos, clicar em criar, aguardar a música, e manualmente empurrar o resultado para uma ferramenta de edição separada. Tínhamos fundadores traduzindo conteúdo de criadores para 10 idiomas, agências produzindo 100 peças de marca por semana, estúdios indie gerando música temporária para protótipos. Todos eles, em algum momento, faziam a mesma pergunta: "existe uma API?"

Agora existe. Os quatro serviços que sustentavam todos esses fluxos de trabalho podem ser chamados diretamente do seu código — sem o painel no meio do caminho, sem precisar aprender as particularidades de cada provedor, e com o mesmo preço por crédito que você já conhece do app web. Se um fluxo de trabalho que antes levava uma hora pode agora rodar em segundo plano num CRON job, isso é a vitória.

Início rápido

Gere uma chave no painel e então:

curl -X POST https://api.clipmixai.com/api/v1/music \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: my-fresh-key-1" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":   "Uplifting synthwave with female vocals",
    "lyrics":   "[verse]\nRunning through neon lights...",
    "duration_seconds": 60
  }'

Você recebe um job-id de volta imediatamente com status: "processing". Você pode consultar GET /v1/music/{id} até o status mudar para completed, ou — melhor ainda — vincular um webhook à sua chave ao criá-la, e enviaremos o resultado final para o seu endpoint via POST, assinado com HMAC-SHA256 para que você possa verificar a origem.

Três funcionalidades que os desenvolvedores pediam e ainda não tínhamos lançado

1. Chaves sandbox

Toda chave de API tem um modo: sk_live_ debita créditos e chama provedores reais; sk_test_ nunca debita, nunca chama provedor algum, e retorna um job completed sintético com test: true no corpo. Use chaves sandbox em CI para verificar sua integração sem gastar créditos, e mude para chaves live quando quiser resultados de verdade.

As chaves sandbox são gratuitas para todos — inclusive contas no plano gratuito. O único requisito para usar uma chave live é ter feito ao menos uma compra de créditos, o que coloca a API por trás do mesmo sinal de pagamento que o app web.

2. Idempotency-Key em todo POST

Novas tentativas de rede são o pesadelo de qualquer API sensível a cobranças. Adotamos a solução do Stripe: passe Idempotency-Key: <sua-string> em qualquer chamada de criação e o servidor armazena a resposta por 24 horas. Uma nova tentativa com a mesma chave + mesmo corpo retorna a resposta original — sem cobranças duplicadas. Uma nova tentativa com a mesma chave mas corpo diferente retorna 422 idempotency_key_reuse para que você encontre o bug em vez de gerar silenciosamente o job errado.

Os dois SDKs oficiais expõem isso como um único argumento nomeado:

# Python
c.music.create(prompt=..., lyrics=..., idempotency_key="order-42")

// JS
await c.music.create({ prompt, lyrics, idempotencyKey: "order-42" });

3. Webhooks com botão de disparo de teste

Configure uma URL de callback na sua chave e enviaremos eventos job.completed / job.failed via POST à medida que os jobs terminam. Cada entrega carrega uma assinatura HMAC em X-ClipMix-Signature: sha256=<hex> — verifique com um método auxiliar de qualquer um dos SDKs. Entregas com falha são reenviadas com backoff exponencial (0s → 30s → 5m → 1h, quatro tentativas no total).

O painel tem um botão Disparar teste que envia um evento webhook.test sintético para que você possa verificar a assinatura e o parsing do seu endpoint sem esperar por um job real. O mesmo painel exibe um histórico de 100 entregas por chave, para que quando algo der errado você não precise adivinhar onde falhou.

Três casos de uso que já estamos vendo

Tradução em massa de vídeos para criadores

Envie um vídeo, receba 10 versões dubladas em 10 idiomas, com clonagem de voz opcional que preserva o tom do locutor. Tivemos um criador do YouTube traduzindo seu podcast semanal para 9 idiomas no piloto automático — a chamada à API é disparada pelo hook de publicação existente e o webhook deposita o arquivo dublado diretamente no CMS.

Vídeos de marca personalizados por cliente

A saída de foto para vídeo de memória permite que uma loja de e-commerce parta da foto de um produto do cliente e gere um anúncio cinematográfico curto personalizado para aquele item. O endpoint family-videos expõe os quatro modos (Moment, Story, Album, Chronicle) que construímos para nossa interface ao consumidor; agências os estão usando como motor dentro de ferramentas white-label.

Prototipagem de áudio para jogos

Estúdios indie estão chamando o endpoint /v1/music de dentro do seu pipeline interno de assets. Um game designer digita um clima e um trecho de letra provisória, e uma faixa de 60 segundos aparece na pasta de áudio do projeto dez minutos depois. Eles iteram sobre músicas temporárias em segundos, em vez de esperar um sound designer para cada variação.

Versionamento e nossos compromissos

A v1 é estável. Não introduziremos mudanças incompatíveis dentro de /api/v1/ — novos campos e novos endpoints são apenas aditivos, e a superfície existente permanece como está. Qualquer coisa que precisemos alterar incompativelmente (raro) será lançada sob /api/v2/ com um período de transição anunciado. O changelog é a fonte da verdade.

O status operacional está disponível em /api/status — uma visão do estado de saúde por serviço, derivada dos últimos 5 minutos de tráfego real. Atualiza a cada 60 segundos e é a mesma visão que nossa equipe de plantão acompanha.

Preços

Mesmo saldo do app web. $1 = 100 créditos, com os bônus de volume existentes nas recargas. Uma música de 60 segundos custa 60 créditos ($0,60). Um avatar talking-head de 30 segundos custa 450 créditos no nível balanced. Traduzir um vídeo de 1 minuto no nível premium custa ~190 créditos. As chaves sandbox são gratuitas.

Planos de API em camadas (Pro / Business / Enterprise) com descontos por volume e workers prioritários estão a caminho. Se você se beneficiaria desses planos hoje, deixe seu e-mail em /contact?topic=api-tiers e avisaremos quando forem lançados.

Experimente

• /api — apresentação de cinco minutos
• /api/docs — referência (autenticação, idempotência, webhooks, sandbox, erros, SDKs)
• /api/status — saúde dos serviços em tempo real
• /api/changelog — o que foi lançado, o que vem a seguir
• /dashboard/api-keys — gere sua primeira chave

Relatos de bugs e solicitações de funcionalidades: GitHub Issues. Qualquer outra coisa: support@clipmixai.com.