Lancio dell'API Developer di ClipMixAI

Da oggi apriamo i motori che alimentano l'app web di ClipMixAI a chiunque voglia costruirci sopra. La nuova API Developer su api.clipmixai.com/api/v1 espone quattro servizi — traduzione video, memory video, faceswap & avatar e musica IA — attraverso un'unica interfaccia REST con autenticazione Bearer token. Stessi modelli, stessa qualità, stessi crediti. Nessun abbonamento richiesto. Nessun minimo.

Se preferisci saltare l'articolo: /api ha la presentazione commerciale, /api/docs ha la documentazione di riferimento, e /dashboard/api-keys è dove puoi creare la tua chiave.

Perché l'abbiamo costruita

Nell'ultimo anno abbiamo visto gli utenti paganti fare sempre la stessa cosa: aprire la dashboard, caricare 30 foto, cliccare su crea, aspettare il brano, e poi spostare manualmente il risultato in uno strumento di editing separato. Avevamo fondatori che traducevano contenuti di creator in 10 lingue, agenzie che producevano 100 spot per brand a settimana, studi indie che generavano musica provvisoria per i prototipi dei loro giochi. Alla fine, ognuno di loro faceva sempre la stessa domanda: "c'è un'API?"

Ora c'è. I quattro servizi che hanno alimentato tutti questi flussi di lavoro sono ora richiamabili dal tuo codice — senza dover aprire la dashboard, senza dover imparare le particolarità di ciascun provider, e con lo stesso pricing a crediti che già conosci dall'app web. Se un flusso che prima richiedeva un'ora di lavoro manuale ora può girare in background con un CRON job, questo è il vantaggio.

Quickstart

Genera una chiave dalla dashboard, poi:

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
  }'

Ricevi immediatamente un job-id con status: "processing". Puoi fare polling su GET /v1/music/{id} finché lo stato non diventa completed, oppure — meglio ancora — collegare un webhook alla tua chiave al momento della creazione: ti invieremo in POST il risultato completato al tuo endpoint, firmato con HMAC-SHA256 così puoi verificare che provenga da noi.

Tre cose che gli sviluppatori chiedevano e che non avevamo ancora rilasciato

1. Chiavi sandbox

Ogni chiave API ha una modalità: sk_live_ addebita crediti e chiama i provider reali; sk_test_ non addebita mai nulla, non chiama alcun provider, e restituisce un job sintetico con stato completed e test: true nel body. Usa le chiavi sandbox in CI per verificare la tua integrazione senza consumare crediti, e passa alle chiavi live quando vuoi un output reale.

Le chiavi sandbox sono gratuite per tutti — inclusi gli account gratuiti. L'unico requisito per usare una chiave live è aver effettuato almeno un acquisto di crediti in precedenza, che pone l'API dietro lo stesso segnale di pagamento dell'app web.

2. Idempotency-Key su ogni POST

I retry di rete sono il tormento di ogni API con fatturazione. Abbiamo preso in prestito la soluzione di Stripe: passa Idempotency-Key: <tua-stringa> su qualsiasi chiamata di creazione e il server mette in cache la risposta per 24 ore. Un retry con la stessa chiave e lo stesso body restituisce la risposta originale — senza doppi addebiti. Un retry con la stessa chiave ma un body diverso restituisce 422 idempotency_key_reuse, così trovi il bug invece di produrre silenziosamente il job sbagliato.

Entrambi gli SDK ufficiali espongono questo come un semplice argomento keyword:

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

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

3. Webhook con pulsante di test

Configura un URL di callback sulla tua chiave e ti invieremo in POST gli eventi job.completed / job.failed al termine dei job. Ogni consegna include una firma HMAC nell'header X-ClipMix-Signature: sha256=<hex> — verificabile con un helper incluso in entrambi gli SDK. Le consegne fallite vengono ritentate con backoff esponenziale (0s → 30s → 5m → 1h, quattro tentativi in totale).

La dashboard ha un pulsante Fire test che invia un evento sintetico webhook.test così puoi verificare la firma e il parsing del tuo endpoint senza aspettare un job reale. Lo stesso pannello mostra un log di 100 consegne per chiave, così quando qualcosa va storto non devi indovinare dove si è inceppato.

Tre casi d'uso che stiamo già osservando

Traduzione video in blocco per i creator

Carichi un video, ottieni 10 versioni doppiate in 10 lingue, con clonazione vocale opzionale che preserva il tono del parlante. Abbiamo un creator di YouTube che traduce il suo podcast settimanale in 9 lingue in automatico — la chiamata API viene attivata dal suo hook di pubblicazione esistente, e il webhook deposita il file doppiato direttamente nel suo CMS.

Video brandizzati per ogni cliente

L'output photo-to-video consente a un e-commerce di prendere la foto di un prodotto di un cliente e generare un breve spot cinematografico personalizzato per quell'inserzione. L'endpoint family-videos espone le quattro modalità (Moment, Story, Album, Chronicle) che abbiamo costruito per la nostra UI consumer; le agenzie le usano come motore all'interno di strumenti white-label.

Prototipazione audio per videogiochi

Gli studi indie richiamano l'endpoint /v1/music direttamente dalla loro pipeline interna di asset. Un game designer scrive un mood e un testo di placeholder, e una traccia da 60 secondi arriva nella cartella audio del progetto dieci minuti dopo. Iterano sulla musica provvisoria in pochi secondi invece di aspettare un sound designer per ogni variazione.

Versionamento e i nostri impegni

La v1 è stabile. Non introdurremo modifiche incompatibili all'interno di /api/v1/ — nuovi campi e nuovi endpoint sono solo aggiuntivi, e la superficie esistente rimane invariata. Qualsiasi cosa che dobbiamo modificare in modo incompatibile (raro) verrà rilasciata sotto /api/v2/ con un periodo di transizione annunciato. Il changelog è la fonte di verità.

Lo stato operativo è disponibile in tempo reale su /api/status — uno snapshot della salute per ogni servizio, derivato dal traffico reale degli ultimi 5 minuti. Si aggiorna ogni 60 secondi ed è la stessa vista che consulta il nostro team di on-call.

Prezzi

Stesso portafoglio dell'app web. $1 = 100 crediti, con i bonus volume già esistenti sui ricarichi. Una canzone da 60 secondi costa 60 crediti ($0.60). Un avatar parlante da 30 secondi costa 450 crediti al tier bilanciato. Tradurre un video di 1 minuto al tier premium costa ~190 crediti. Le chiavi sandbox sono gratuite.

Piani API a livelli (Pro / Business / Enterprise) con sconti su volumi elevati e worker prioritari sono in arrivo. Se ti interessano già oggi, lascia la tua email su /contact?topic=api-tiers e ti contatteremo non appena saranno disponibili.

Prova subito

• /api — presentazione in cinque minuti
• /api/docs — documentazione di riferimento (auth, idempotency, webhook, sandbox, errori, SDK)
• /api/status — stato dei servizi in tempo reale
• /api/changelog — cosa è stato rilasciato, cosa è in arrivo
• /dashboard/api-keys — genera la tua prima chiave

Segnalazioni di bug e richieste di funzionalità: GitHub Issues. Per tutto il resto: support@clipmixai.com.