Pokretanje ClipMixAI Developer API-ja

Danas otvaramo motore koji pokreću ClipMixAI web aplikaciju svima koji žele da grade na njima. Novi Developer API na api.clipmixai.com/api/v1 izlaže četiri servisa — prevođenje videa, memory video, faceswap i avatare, te AI muziku — kroz jedinstvenu REST površinu sa Bearer tokenom. Isti modeli, isti kvalitet, isti krediti. Bez pretplate. Bez minimuma.

Ako želite da preskočite tekst: /api ima marketinški opis, /api/docs ima referentnu dokumentaciju, a /dashboard/api-keys je mesto gde kreirate svoj ključ.

Zašto smo ovo napravili

Tokom protekle godine gledali smo kako plaćeni korisnici rade iste stvari iznova i iznova: otvaraju kontrolnu tablu, otpremaju 30 fotografija, kliknu na kreiranje, čekaju pesmu, pa ručno guraju rezultat u poseban alat za uređivanje. Imali smo osnivače koji prevode sadržaj kreatora na 10 jezika, agencije koje proizvode 100 brendiranih spotova nedeljno, indie game studije koji generišu privremenu muziku za prototype. Svi su na kraju postavljali isto pitanje: "Da li postoji API?"

Sada postoji. Četiri servisa koji su pokretali sve te tokove rada sada se mogu pozivati iz vašeg koda — bez kontrolne table u petlji, bez potrebe da učite specifičnosti svakog provajdera, i uz iste cene po kreditu koje već poznajete iz web aplikacije. Ako tok rada koji je nekada trajao sat vremena sada može da se izvršava iz CRON posla u pozadini, to je prava pobeda.

Brzi početak

Generišite ključ iz kontrolne table, zatim:

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

Odmah dobijate job-id sa status: "processing". Možete da ankitirate GET /v1/music/{id} dok status ne pređe na completed, ili — što je bolje — povežite webhook sa svojim ključem pri kreiranju, i mi ćemo POST-ovati završeni rezultat na vaš endpoint, potpisan HMAC-SHA256 kako biste mogli da potvrdite da je stigao od nas.

Tri stvari koje su programeri tražili a mi dosad nismo isporučili

1. Sandbox ključevi

Svaki API ključ ima mod: sk_live_ naplaćuje kredite i poziva prave provajdere; sk_test_ nikad ne naplaćuje, nikad ne poziva provajdera, i vraća sintetički completed posao sa test: true u telu. Koristite sandbox ključeve u CI-u da proverite integraciju bez trošenja kredita, a prebacite se na live ključeve kada zaista želite izlaz.

Sandbox ključevi su besplatni za sve — uključujući i besplatne naloge. Jedini uslov za korišćenje live ključa je jedna prethodna kupovina kredita, koja stavlja API iza iste platne barijere kao i web aplikacija.

2. Idempotency-Key na svakom POST-u

Ponovni pokušaji mreže su prokletstvo svakog API-ja koji se tiče naplate. Pozajmili smo Stripe-ovo rešenje: prosledite Idempotency-Key: <vaš-string> pri bilo kom pozivu kreiranja i server kešira odgovor na 24 sata. Ponovni pokušaj sa istim ključem i istim telom vraća originalni odgovor — nikad ne naplaćuje duplo. Ponovni pokušaj sa istim ključem ali različitim telom vraća 422 idempotency_key_reuse kako biste pronašli grešku umesto da prećutno dobijete pogrešan posao.

Oba zvanična SDK-a izlažu ovo kao jedan argument sa ključnom reči:

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

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

3. Webhook-ovi sa dugmetom za testno slanje

Konfigurišite URL za povratni poziv na svom ključu i mi ćemo POST-ovati job.completed / job.failed događaje kako se poslovi završavaju. Svaka isporuka nosi HMAC potpis u X-ClipMix-Signature: sha256=<hex> — proverite ga jednim pomoćnim pozivom iz bilo kog SDK-a. Neuspele isporuke se ponavljaju sa eksponencijalnim odlaganjem (0s → 30s → 5m → 1h, ukupno četiri pokušaja).

Kontrolna tabla ima dugme Testno slanje koje šalje sintetički webhook.test događaj kako biste mogli da proverite potpis i parsiranje vašeg endpointa bez čekanja na pravi posao. Ista tabla prikazuje evidenciju od 100 isporuka po ključu, tako da kad nešto krene naopako ne morate da pogađate gde je zapalo.

Tri slučaja upotrebe koje već viđamo

Masovno prevođenje videa za kreatore

Otpremite jedan video, dobijete 10 sinhronizovanih verzija na 10 jezika, uz opciono kloniranje glasa koje čuva ton govornika. Imali smo YouTube kreatora koji automatski prevodi svoju nedeljnu podcast epizodu na 9 jezika — API poziv se okida njihovim postojećim hook-om za objavljivanje, a webhook spušta sinhronizovanu datoteku u njihov CMS.

Brendirani videi po kupcu

Izlaz memory videa od fotografija znači da prodavnica e-trgovine može da uzme fotografiju kupčevog proizvoda i generiše kratku filmsku reklamu personalizovanu za tu objavu. family-videos endpoint izlaže četiri moda (Moment, Story, Album, Chronicle) koje smo napravili za naš potrošački UI; agencije ih koriste kao motor unutar alata sa belom etiketom.

Prototipovanje audio sadržaja za igre

Indie studiji pozivaju /v1/music endpoint iz svojih internih pipeline-ova za sredstva. Dizajner igre unese raspoloženje i isečak privremenih stihova, a 60-sekundna numera sletuje u audio fasciklu projekta deset minuta kasnije. Iteriraju na privremenoj muzici za nekoliko sekundi umesto da čekaju tonskog dizajnera za svaku varijantu.

Verzionisanje i na šta se obavezujemo

v1 je stabilan. Nećemo uvoditi promene koje narušavaju kompatibilnost unutar /api/v1/ — nova polja i novi endpoint-i su samo dopunski, a postojeća površina ostaje kakva jeste. Sve što moramo da promenimo (retko) objavljujemo pod /api/v2/ uz najavljen period prelaza. Evidencija promena je izvor istine.

Operativni status je dostupan uživo na /api/status — snimak zdravlja po servisu koji se zasniva na poslednjih 5 minuta stvarnog saobraćaja. Ažurira se svakih 60 sekundi i isti je prikaz koji naš dežurni tim vidi.

Cene

Isti novčanik kao i web aplikacija. $1 = 100 kredita, uz postojeće bonuse za obim pri dopuni. Pesma od 60 sekundi košta 60 kredita ($0.60). Avatar sa govoreće glave od 30 sekundi košta 450 kredita na balansiranom nivou. Prevođenje video zapisa od 1 minute na premium nivou košta ~190 kredita. Sandbox ključevi su besplatni.

Nivoirani API planovi (Pro / Business / Enterprise) sa popustima za veće količine i prioritetnim radnicima su na putu. Ako bi vam to danas koristilo, ostavite svoju e-poštu na /contact?topic=api-tiers i obavestićemo vas čim budu dostupni.

Isprobajte

• /api — petominutni pregled
• /api/docs — referenca (autentifikacija, idempotentnost, webhook-ovi, sandbox, greške, SDK-ovi)
• /api/status — zdravlje servisa uživo
• /api/changelog — šta je objavljeno, šta sledi
• /dashboard/api-keys — generišite svoj prvi ključ

Prijave grešaka i zahtevi za funkcijama: GitHub Issues. Za ostalo: support@clipmixai.com.