Per sviluppatori e agenti AI

Una sola API per immagini e video nel tuo stack, più MCP nativo per Claude e agenti

Richiama text-to-image, editing delle immagini, rimozione dello sfondo, avatar e video da un'unica REST API, oppure collega DesignerBox direttamente a Claude e ai tuoi agenti via MCP. Scegli il modello a ogni richiesta, invia job idempotenti con un clientRequestId e paghi a credito invece che per ogni shooting.

Ottieni la tua API key, inizia gratis

Un'unica API per ogni job di generazione

Text-to-image, editing, rimozione dello sfondo, avatar e video con un'unica struttura di richiesta coerente.

2,Scegli il modello a ogni richiesta tra Nano Banana Pro, Nano Banana GPT...
$15Inizia con il piano FREE e cresci da a $200 man mano che aumenta il volume...
$200 mInizia con il piano FREE e cresci da $15 a an mano che aumenta il volume...

Genera, modifica ed elabora immagini

Usa text-to-image (generate_image), editing delle immagini (edit_image), rimozione dello sfondo (remove_background), avatar (create_avatar) e video (generate_video) con un'unica struttura di richiesta coerente. Ottieni accesso in produzione senza dover allestire la tua pipeline GPU.

Scegli il modello a ogni richiesta

Indirizza al motore giusto a ogni chiamata. Nano Banana Pro (14 cr) primeggia su fotorealismo ad alta risoluzione e resa del testo; Seedream 5 (4 cr) e Nano Banana 2 (7 cr) rinunciano a un po' di fedeltà per un prezzo più basso, mentre GPT Image 2 (22 cr) e Flux (Pro 1.1 a 5 cr, Flux 2 Flex a 7 cr) completano il catalogo.

MCP per agenti AI e Claude

Esponi DesignerBox come una superficie di strumenti che i tuoi agenti richiamano direttamente su mcp.designerbox.ai. MCP offre agli LLM un'interfaccia JSON-RPC universale verso strumenti esterni ed è supportato dalle principali piattaforme per agenti, così il tuo stack di agenti resta portabile.

Generazione video nella stessa API

Genera video con generate_video usando la stessa autenticazione, lo stesso modello di job e gli stessi webhook che usi per le immagini. Nessuna integrazione separata: il video arriva nel tuo prodotto sulla stessa struttura delle chiamate per immagini.

Dalla API key al primo asset

Un flusso semplice, dalla registrazione all'URL dell'immagine o del video finito.

1
Ottieni una key, scegli un percorso
Registrati sul piano FREE, prendi una API key dalla tua dashboard e decidi come richiamare DesignerBox: REST per i servizi backend, oppure il server MCP per Claude Desktop, Cursor e i runtime degli agenti.
2
Invia un job
Invia in POST il tuo prompt o l'immagine sorgente con un modello e un clientRequestId. L'API restituisce subito un job ID per le generazioni lunghe, così il thread della tua richiesta non si blocca mai.
3
Ricevi una notifica, o fai polling
Ricevi un webhook quando il job si completa, oppure interroga l'endpoint del job a intervalli per riconciliare lo stato. Considera il webhook come notifica a bassa latenza e il polling come la tua garanzia.
4
Recupera l'asset
Preleva l'URL dell'immagine o del video finito, salvalo e portalo nel tuo prodotto, CMS o pipeline. Rifare la richiesta con lo stesso clientRequestId restituisce lo stesso risultato invece di rieseguire il lavoro.
5
Scala e ottimizza
Tieni d'occhio il consumo di crediti nella dashboard, cambia modello dove costo o qualità lo giustificano e passa a piani superiori man mano che cresce il throughput, senza bisogno di rifare l'architettura.

Pensato per integrazioni in produzione

Autenticazione e chiavi API

Autenticati con una API key bearer legata al tuo team. Ruota le chiavi dalla dashboard e tieni chiavi separate per staging e produzione, così consumo e limiti restano puliti.

Invio di job idempotenti

Genera un valore univoco lato client e invialo come clientRequestId. Il server lo registra, così una richiesta ritentata o duplicata restituisce la risposta originale senza addebitare di nuovo: è lo schema standard per API sicure e ripetibili.

Webhook e polling dello stato

Registra un URL webhook per gli eventi di completamento e aggiungi un polling periodico come rete di sicurezza. Traccia gli ID evento con un TTL più lungo della finestra di retry, così le riconsegne vengono deduplicate.

Catalogo modelli e parametri

Ogni richiesta accetta un modello più parametri specifici del modello, come risoluzione, formato, maschere di modifica e immagini di riferimento. I modelli per immagini comprendono Nano Banana Pro (14 cr), Nano Banana 2 (7 cr), GPT Image 2 (22 cr), Seedream 5 (4 cr) e Flux (Pro 1.1 a 5 cr, Flux 2 Flex a 7 cr), con il video tramite generate_video.

Integrazione del server MCP

Collega il server MCP di DesignerBox su mcp.designerbox.ai a Claude Desktop, Cursor o al tuo agent loop. Il tuo agente richiama strumenti come generate_image, edit_image, remove_background, create_avatar e generate_video in modo nativo, con gli stessi crediti e limiti della REST API.

Crediti, limiti e piani

Il consumo è misurato in crediti. FREE ($0) serve per integrazione e test; BASIC ($15 / 500 cr), PRO ($35 / 1000 cr), PREMIUM ($75 / 2500 cr) e ULTRA ($200 / 8000 cr) scalano con il throughput. Controlla i limiti del piano in tempo reale dall'API prima di grandi esecuzioni batch.

FAQ su API per sviluppatori e MCP

Registrati, ottieni una API key e invia in POST un prompt con un modello e un clientRequestId all'endpoint di generazione. Per i job lunghi ricevi subito un job ID, poi arriva un webhook o interroghi l'endpoint del job per l'URL dell'asset finito. La stessa struttura di richiesta copre editing delle immagini, rimozione dello sfondo, avatar e video.

MCP (Model Context Protocol) è uno standard aperto introdotto da Anthropic a fine 2024 che offre agli LLM un'interfaccia universale verso strumenti esterni. DesignerBox mette a disposizione un server MCP su mcp.designerbox.ai, così Claude e altri agenti possono richiamare la generazione di immagini e video come strumenti nativi. Dal lancio l'adozione sulle piattaforme per agenti è stata rapida.

Generi un clientRequestId univoco e lo invii con ogni richiesta. Il server registra il valore, così qualsiasi retry con lo stesso clientRequestId restituisce la risposta originale invece di rieseguire, e riaddebitare, il job. Questo rende sicuri i retry di rete e la consegna dei webhook con garanzia at-least-once.

Sì, la scelta del modello è per singola richiesta. Per le immagini puoi indirizzare a Nano Banana Pro (14 cr), Nano Banana 2 (7 cr), GPT Image 2 (22 cr), Seedream 5 (4 cr) e Flux (Pro 1.1 a 5 cr, Flux 2 Flex a 7 cr); il video è disponibile tramite generate_video. Ogni modello bilancia diversamente qualità, velocità e costo: Nano Banana Pro primeggia su fotorealismo e resa del testo, mentre Seedream 5 ha un prezzo più basso.

Il consumo è misurato in crediti su tutti i piani: FREE $0, BASIC $15 (500 cr), PRO $35 (1000 cr), PREMIUM $75 (2500 cr) e ULTRA $200 (8000 cr). Il costo in crediti per generazione dipende dal modello e dalla risoluzione che scegli. Puoi interrogare i limiti del piano dall'API prima di avviare grandi esecuzioni batch.

Entrambi. Registra un URL webhook per essere avvisato nel momento in cui un job si completa e aggiungi un polling periodico come rete di sicurezza per la riconciliazione, così una consegna mancata non lascia mai un job in sospeso. Lo schema consigliato è webhook per la latenza più polling per la garanzia.

Porta immagini e video AI nel tuo prodotto questa settimana

Prendi una API key gratuita, collega il server MCP o l'endpoint REST e genera la tua prima immagine in pochi minuti. Paghi a credito, cambi modello liberamente e aumenti la spesa solo quando aumenta il tuo utilizzo.

Ottieni la tua API key gratuita