API e MCP

Metti Covely dentro il tuo stack, e dentro i tuoi agenti.

Genera in modo programmatico via REST, oppure esponi Covely come strumento che i tuoi agenti richiamano via MCP. Entrambi usano le stesse chiavi API a permessi limitati e lo stesso modello asincrono — e in entrambi puoi passare il brief o passare il prompt.

Ottieni una chiave API Parla con il commerciale

Una chiave raggiunge tutti i motori. Nessuna integrazione da scrivere per ogni modello, e nessuna libreria client per fornitore.

Un nucleo Covely collegato all'esterno tramite API e MCP: da una parte il tuo sistema, gli agenti AI, gli strumenti interni, i database e i flussi su misura; dall'altra una griglia di marchi di strumenti e canali di terze parti e una fila di tipi di agente; e un pannello con una richiesta JSON per un video social e il file che restituisce

Integri una volta sola

Una chiave, una chiamata, e tutti i motori che ci sono dietro.

Nessuna integrazione da scrivere per ogni modello e nessun SDK a cui legarsi: una chiave bearer a permessi limitati, una chiamata asincrona, e tutto il resto viene da sé.

01
Colleghi una volta
Una chiave raggiunge tutti i motori. Dalla tua parte non c'è niente da aggiungere quando ne colleghiamo uno nuovo.
02
Invia un job
Un solo POST: passi un brief, oppure indichi il modello e mandi tu il prompt.
03
Raccogli il risultato
Ogni formato che hai chiesto, sul brand kit che hai indicato.

Director o modello

Passa il brief, oppure parla tu direttamente al modello.

I due modi di lavorare dell'app sono entrambi richiamabili. La differenza è la stessa che c'è nello studio: quante decisioni deleghi. Stessa chiave, stesso modello asincrono, stesso motore sotto.

Modalità Director

Mandi il brief e l'agente di Covely prende in mano la cosa da lì: legge il brand kit, calcola quello che può, scrive il prompt e ti riporta le decisioni prese insieme agli asset. Può anche tornare da te con una domanda — la stessa conversazione che fa l'app, sullo stesso endpoint — così un lavoro a cui manca una risposta la chiede invece di tirare a indovinare.

Tu mandi. L'obiettivo, il prodotto, il brand kit — in una sola chiamata o nel corso di una conversazione.
Decide lui. Modalità, formato, durata, stile, luce, grammatica di ripresa — e a quale motore va il lavoro.
Ti torna indietro. Gli asset, e quello che ha scelto per farli.

Questo è Autopilot, richiamato dal tuo codice.

Modalità modello

Ti rivolgi direttamente ai motori. Covely è già integrato con ognuno di essi, quindi indichi il modello, mandi il tuo prompt e lo raggiungi con la stessa chiave — nessun account per fornitore, nessun contratto, nessuna libreria client da mantenere.

Tu mandi. Il modello, il prompt, i formati e qualsiasi leva tu voglia fissare.
Decide lui. Niente di quello che hai specificato.
Ti torna indietro. Gli asset, riproducibili dalla stessa richiesta e dallo stesso seed.

Questo è PRO, richiamato dal tuo codice.

il brief, in modalità Directorjson

{
  "mode": "director",
  "type": "video",
  "brand_kit_id": "bk_7Qd2",
  "product_id": "prod_A19f",
  "brief": "spring refill promo, for Instagram",
  "formats": ["9:16", "1:1"]
}

lo stesso job, in modalità modellojson

{
  "mode": "model",
  "model": "seedance-2.5",
  "type": "video",
  "brand_kit_id": "bk_7Qd2",
  "prompt": "morning kitchen counter, slow push in",
  "formats": ["9:16"],
  "seed": 42841
}

È un solo campo a decidere in quale delle due ti trovi. Tutto il resto — permessi, coda, polling, webhook — è identico, e la stessa chiave funziona in entrambi i modi. Conferma i nomi esatti dei campi nella tua dashboard: sono versionati per account.

I motori

Collegati oggi, e raggiungibili con la stessa chiave.

La modalità modello ne indica uno di questi. La modalità Director sceglie per te e ti dice quale ha scelto. In ogni caso l'integrazione è nostra e resta funzionante: nessun account tuo presso il fornitore, nessun secondo contratto, nessuna libreria client per modello.

Video

Un brief o un prompt in entrata, un montaggio finito in uscita — nei formati e nelle durate che il posizionamento richiede.

Seedance 2.5ByteDance
Veo 3.1Google, su Vertex
KlingKuaishou
Wan 3.0Alibaba
Gemini Omni FlashGoogle, su Vertex
GrokxAI

Immagini

Still, set, varianti e oggetti 3D, dalla stessa richiesta da cui esce il video.

SeedreamByteDance
Nano BananaGoogle, su Vertex
FluxBlack Forest Labs
GPT Image 2OpenAI
Hunyuan3DTencent
GrokxAI

Audio

Voce, narrazione e dialoghi, nella lingua che il mercato parla.

ElevenLabsElevenLabs

I modelli sono infrastruttura. Le regole di instradamento stanno nel codice, non in un prompt, quindi un motore migliore è una modifica alle regole e non al tuo modo di lavorare — e non una migrazione a casa tua.

Creative Automation

Un metodo di produzione, non un tipo di contenuto.

È così che gli altri sei risultati girano su larga scala: le stesse regole di brand e gli stessi flussi, innescati dai tuoi dati invece che da una persona. Cataloghi, fogli di calcolo e chiamate API in entrata, creatività finita in uscita.

01
Approvi una direzione
Fai bene una singola creatività, con le regole del brand allegate.
02
Trasformalo in un template
Salvi la struttura, così può ripartire senza rifarla da capo.
03
Puntalo sui dati
Dai in pasto un catalogo, un foglio o un payload API con le righe da produrre.
04
Lancia il batch
Genera su più prodotti, formati, lingue e mercati.
05
Raccogli l'output
Riporta gli asset finiti dentro il tuo stack tramite l'API.

Adatta e riusa

Riformatta per altri canali. Un asset approvato ricomposto per ogni formato e posizionamento, non stirato.
Traduci e localizza. Testi, voce e grafiche a schermo per ogni mercato, dalla stessa sorgente.
Genera varianti nuove. Più esecuzioni da una direzione che già funziona.
Aggiorna un dettaglio. Cambi il prezzo, la promessa, la confezione o la stagione senza rigenerare l'asset.
Da video lungo a clip brevi. Un montaggio lungo spezzato nei pezzi corti che il feed accetta davvero.

Clona un riferimento

Clona un annuncio. Prendi una struttura che funziona e ricostruiscila con il tuo prodotto e il tuo brand.
Clona uno stile visivo. Riproduci un look che ti è stato dato, e poi applicalo a tutto un set.
Ricrea uno scatto. Ricostruisci un fotogramma preciso che non puoi rifare, con dentro il tuo prodotto.
Rifai un asset vincente. Il tuo pezzo migliore, prodotto di nuovo per un prodotto o un mercato nuovo.

Una chiamata, tre formati

Una richiesta di generazione fa riferimento a un brand kit e a un prodotto, così l'output arriva coerente con il brand e in tutti i formati che hai chiesto.

POST /v1/generationscurl

curl -X POST https://api.covely.ai/v1/generations \
  -H "Authorization: Bearer $COVELY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "model",
    "type": "image",
    "brand_kit_id": "bk_7Qd2",
    "product_id": "prod_A19f",
    "prompt": "morning kitchen counter, natural light",
    "formats": ["1:1", "4:5", "9:16"]
  }'

GET /v1/generations/gen_8kPz2mQjson

{
  "id": "gen_8kPz2mQ",
  "status": "succeeded",
  "assets": [
    { "format": "1:1",  "url": "https://cdn.covely.ai/..." },
    { "format": "4:5",  "url": "https://cdn.covely.ai/..." },
    { "format": "9:16", "url": "https://cdn.covely.ai/..." }
  ]
}

Conferma i percorsi esatti degli endpoint, i nomi dei campi e i limiti attuali nella tua dashboard quando crei una chiave. Sono versionati per account.

MCP

Covely come strumento che i tuoi agenti possono richiamare.

MCP espone le stesse funzioni ai flussi degli agenti invece che al codice che hai scritto a mano. Punti il tuo client MCP al server e ti autentichi con la stessa chiave.

Stessi ambiti, stesso modello asincrono
In entrambe le modalità: passi il brief dell'agente al Director, o lo lasci mandare il suo prompt
Gli agenti possono generare e poi raccogliere gli asset
Utile quando l'innesco è una conversazione, non un cron job

mcp client configjson

{
  "mcpServers": {
    "covely": {
      "url": "https://mcp.covely.ai",
      "headers": { "Authorization": "Bearer ${COVELY_API_KEY}" }
    }
  }
}

Dove si inserisce

Le integrazioni che i team chiedono per prime.

Il pannello dei connettori: API e MCP da una parte, e dall'altra gli agenti, gli strumenti e i canali che raggiungono — Colleghi, integri, crei — le stesse funzioni che ha l'app, raggiungibili dal tuo codice e da un agente.

Catalogo e PIM

Fa partire la generazione quando una SKU compare o cambia.

DAM

Rimandi gli asset finiti dove il tuo team li cerca già.

Strumenti di campagna

Produci i formati che un posizionamento richiede già dentro la costruzione della campagna.

Agenti

Lascia che un agente concateni le generazioni in un compito più lungo via MCP.

Prendi una chiave e prova una chiamata.

Crea un account, o parlaci di volumi e ambienti dedicati.

Ottieni una chiave API Parla con il commerciale

Metti Covely dentro il tuo stack, e dentro i tuoi agenti.

Colleghi una volta

Invia un job

Raccogli il risultato