API Magnific

API Magnific

Questo articolo è una traduzione. La versione inglese è la versione di riferimento e quella che prevale in caso di dubbi.

Integra la biblioteca di contenuti in stock e gli strumenti potenziati dall’IA di Magnific nelle tue applicazioni

L'API Magnific consente agli sviluppatori di integrare i contenuti e le funzionalità IA di Magnific direttamente nei propri prodotti, piattaforme e workflow. Invece di usare il sito web di Magnific manualmente, puoi cercare risorse in stock, generare immagini IA e video, modificare contenuti e altro ancora in modo programmatico tramite le standard chiamate API REST

Il riferimento tecnico completo (endpoint, parametri, dettagli di autenticazione, esempi di codice e schemi di risposta) si trova nella documentazione API su docs.magnific.com. Questo articolo copre gli elementi essenziali per aiutarti a capire cosa offre l'API e come iniziare

In questo articolo

• Cosa puoi fare con l'API

• Per iniziare

• Dashboard API

• Prezzi e fatturazione

• Limiti di velocità

• Regole di utilizzo

• Codici di errore comuni

• Risorse e assistenza

Cosa puoi fare con l'API

L'API è organizzata in diverse aree di servizio:

I servizi e i modelli disponibili possono variare man mano che Magnific aggiunge nuove funzionalità IA. Consulta docs.magnific.com per l'elenco aggiornato degli endpoint

Per iniziare

Come consumare crediti tramite API

Passaggio 1 — Accedi alle impostazioni
Apri il menu Utente e vai nelle Impostazioni dell'organizzazione. All'interno, troverai la sezione chiavi API

Passaggio 2 — Crea una chiave API
Crea una nuova chiave API con un nome identificativo. Il sistema genererà automaticamente:

• La chiave API

• Il segreto di firma del webhook

Entrambi vengono mostrati una sola volta. Assicurati di copiarli prima di chiudere la finestra

Passaggio 3 — Gestisci le tue chiavi

• Puoi rinominare qualsiasi chiave dal menu Azioni senza perdere il suo segreto o la cronologia dei consumi

• Puoi disattivare temporaneamente una chiave (utile per la rotazione o in caso di emergenza) senza perderla

• Puoi eliminare definitivamente una chiave previa conferma

Passaggio 4 — Controlla l'utilizzo dei crediti
Puoi controllare il consumo del pool di crediti filtrando per una specifica chiave API per un controllo granulare sull'utilizzo

Account Enterprise: se non vedi ancora la sezione Chiavi API, contatta il tuo referente Magnific designato per richiedere l'accesso. Una volta abilitato, i passaggi precedenti si applicano allo stesso modo

Dashboard API (legacy)

La Dashboard API è il tuo hub centrale per gestire tutto ciò che riguarda l'utilizzo della tua API. Puoi accedervi facendo clic sulla tua immagine del profilo nell'angolo in alto a destra e selezionando Dashboard API, oppure andando direttamente su magnific.com/developers/dashboard

Dalla dashboard puoi:

• Visualizzare e rigenerare la tua chiave API

• Monitorare l'utilizzo e controllare il volume delle richieste in tempo reale

• Imposta un budget mensile per controllare la spesa

• Controlla i limiti di frequenza e i prezzi per ogni servizio

• Gestisci le informazioni di fatturazione e i metodi di pagamento

Pannello di amministrazione API basato su modello a crediti

Gli utenti API con abbonamento possono gestire i propri account tramite il pannello di amministrazione, situato all'interno del pannello abbonamento. Da qui, puoi eseguire le seguenti azioni:

• Crea chiavi API

• Verifica e gestisci le autorizzazioni per le chiavi API

• Controlla i crediti spesi da ogni chiave

Prezzi e fatturazione

Le API Magnific utilizzano un sistema di abbonamento con un modello basato su crediti

Strumenti di generazione IA

Ogni richiesta di generazione tramite API — immagini, video, audio, upscaling, editing e altro — scala crediti dal tuo saldo

Per utilizzare l'API, puoi scegliere tra i seguenti piani di abbonamento:

• Premium: 1 chiave API, 20.000 crediti/mese o 240.000 crediti/anno

• Premium+: 1 chiave API, 45.000 crediti/mese o 600.000 crediti/anno

• Pro: 3 chiavi API, 300.000 crediti/mese o 4 milioni di crediti/anno

• Business: 5 chiavi API, 90.000 crediti/mese o 1,08 milioni/anno

• Enterprise: chiavi API illimitate, crediti annuali personalizzati, scalabilità in base al tuo utilizzo

Troverai i costi dettagliati in crediti per ogni strumento e generazione nel nostro Centro assistenza

Tutti gli abbonamenti ti consentono inoltre di generare contenuti direttamente sul nostro sito web

Se il tuo piano include l'utilizzo "Illimitato", tieni presente che questo si applica solo all'interno della web app di Magnific: le chiamate API consumano sempre crediti

Download di contenuti in stock

• Piani Premium, Premium+ e Pro: i download di contenuti in stock tramite API non consumano crediti, ma sono limitati a 100 al giorno

• Piani Business ed Enterprise: download di contenuti in stock illimitati, ognuno dei quali viene detratto dal saldo crediti come qualsiasi altra chiamata API

Limiti di frequenza

L'API impone limiti di frequenza per garantire stabilità e un utilizzo equo per tutti gli sviluppatori. I limiti si applicano sia a livello di chiave API che di indirizzo IP

Se superi questi limiti, le richieste potrebbero essere limitate o temporaneamente bloccate fino al ripristino del limite. Se la tua applicazione richiede limiti più elevati, contatta il team Sales per discutere un piano personalizzato

Regole di utilizzo

L'API Magnific è progettata per l'integrazione in prodotti digitali e workflow. Per mantenere attivo il tuo accesso all'API, segui queste regole:

• Non utilizzare l'API per data mining, scraping di contenuti o addestramento di modelli IA

• Non vendere o ridistribuire contenuti Magnific senza modifiche

• Segnala i download in modo accurato: attiva una richiesta di download ogni volta che una risorsa viene utilizzata in modo univoco da un utente. Ad esempio, quando qualcuno seleziona un'immagine per un post di un blog, la imposta come intestazione o la usa come sfondo

• La memorizzazione nella cache è consentita a condizione che tu mantenga un piano attivo e riporti tutti i download in modo accurato e tempestivo

Importante

La violazione di queste regole comporterà l'immediata revoca dell'accesso alle API

Codici di errore comuni

Quando si verifica un problema con una richiesta, l'API restituisce i codici di stato HTTP standard. Ecco i più comuni:

Per l'elenco completo dei codici di risposta e i relativi significati, consulta la documentazione API

Risorse e assistenza

Se riscontri problemi o hai domande sulla tua integrazione API, puoi contattare il team di assistenza tramite il modulo di contatto su magnific.com/api#contact o attraverso la pagina di assistenza generale