FAQ

Generale

Che cos'è Atlas Cloud?

Atlas Cloud è una piattaforma di aggregazione di API per l'IA. Un'unica chiave API e un unico saldo ti danno accesso a oltre 400 modelli — modelli linguistici, immagine, video, audio e 3D — di molti provider diversi, senza doverti registrare separatamente presso ciascuno.

Come inizio?

1. Crea un account
2. Crea una chiave API
3. Segui la Guida rapida per la tua prima richiesta

Quali modelli sono disponibili?

Sfoglia la Libreria dei modelli. Il catalogo cambia spesso, quindi è quello l'elenco che fa fede — la documentazione evita deliberatamente di fissare nomi di modelli destinati a diventare obsoleti.

L'API è compatibile con OpenAI?

Sì, e non solo. Atlas Cloud accetta sei formati di richiesta: OpenAI Chat Completions, Completions, Responses e Images, oltre ad Anthropic Messages e Google Gemini. Vedi Protocolli API LLM.

API e aspetti tecnici

Chiamo un modello e ricevo un 400. Perché?

La causa più comune è l'uso del protocollo sbagliato per quel modello. Non tutti i modelli accettano tutti i formati:

• I modelli della famiglia Anthropic si aspettano POST /v1/messages, non /v1/chat/completions
• Alcuni modelli OpenAI di ragionamento e della famiglia codex si aspettano POST /v1/responses, non /v1/chat/completions

Ogni modello pubblica i protocolli che supporta. Controlla il riferimento API del modello prima di cambiare formato e vedi Protocolli API LLM per le differenze tra di essi.

Quali sono gli endpoint dell'API?

URL di base: https://api.atlascloud.ai

Il mio job è in stato processing da molto tempo. Posso annullarlo?

La generazione di immagini, video, audio e 3D è asincrona. Invia il job, poi interroga GET /api/v1/model/prediction/{id} finché non raggiunge uno stato terminale. I job video in particolare possono richiedere minuti.

Non esiste un endpoint di annullamento. I job che superano il timeout della piattaforma vengono terminati e rimborsati automaticamente.

Se stai facendo polling di frequente, passa invece ai webhook — ricevi una callback quando il job si conclude, invece di tenere aperto un ciclo di polling.

Supportate i webhook?

Sì, per i job di immagine, video e audio. Vedi Webhook per il formato del payload e la verifica della firma.

Come carico i file?

Usa POST /api/v1/model/uploadMedia e passa l'URL restituito nella tua richiesta di generazione. Puoi anche fornire direttamente un URL pubblico, oppure Base64 inline per la maggior parte dei campi immagine e audio. Vedi Carica file.

Ci sono limiti di frequenza?

Sì, applicati per account e per modello. Superarne uno restituisce 429.

Nota che gli endpoint LLM e media non restituiscono header di rate limit, quindi non puoi leggere la quota rimanente da una risposta — implementa invece un backoff esponenziale. Vedi Errori e limiti di frequenza.

Ti servono limiti più alti? Contattaci indicando il volume previsto.

Ricevo errori 401. Come faccio a fare debug?

Controlla in quest'ordine:

1. La chiave è corretta e ancora attiva? Verifica in Chiavi API
2. La chiave ha l'ambito giusto? Una chiave Coding Plan non può chiamare modelli che non la accettano
3. In un contesto di team, stai usando una chiave creata nell'account giusto?
4. Il percorso dell'URL è corretto? Il gateway autentica prima di instradare, quindi anche un errore di battitura nel percorso restituisce 401 anziché 404

Che cos'è il server MCP?

Un server MCP ufficiale che espone Atlas Cloud come strumenti dentro gli IDE assistiti dall'IA — genera media, chatta con i modelli e controlla il saldo senza uscire dall'editor.

Prezzi e fatturazione

Il prezzo sulla scheda di un modello è il costo totale?

No — per i modelli immagine e video è un prezzo unitario. Il costo finale dipende da parametri come durata, risoluzione e numero di output. Un modello video con prezzo al secondo costerà quella tariffa moltiplicata per la lunghezza della clip.

Per ottenere una cifra esatta prima di spendere qualsiasi cosa, usa la stima del prezzo prima di inviare. Vedi Come vengono fatturati i modelli per esempi svolti.

Perché il prezzo che ho visto non corrisponde alla mia fattura?

Tre elementi possono differire:

• La scheda del modello mostra un prezzo unitario di listino
• Il playground ricalcola man mano che modifichi i parametri
• La tua fattura riflette anche sconti e promozioni sull'account

Immagini e video usano una fatturazione asincrona: al momento dell'invio viene bloccato un importo, che viene poi conguagliato sull'utilizzo effettivo quando il job termina. Un blocco in attesa non è un addebito definitivo.

Le richieste fallite costano?

No. I job che falliscono, vanno in timeout o vengono rifiutati dalla moderazione dei contenuti non vengono fatturati. Se noti un addebito che non riesci a giustificare, contatta il supporto indicando l'ID della predizione.

Il mio saldo può diventare negativo?

Può scendere leggermente sotto lo zero con un utilizzo LLM ad alta concorrenza, perché le chiamate ai modelli linguistici non sono pre-autorizzate. Un saldo negativo blocca le richieste successive. Attiva la ricarica automatica per evitare interruzioni.

I crediti Coding Plan si possono usare per immagini o video?

No. Un Coding Plan è un'assegnazione in abbonamento separata, destinata all'uso dei modelli linguistici, e non può essere spesa per la generazione di immagini, video o audio. Queste attingono al tuo saldo ordinario. I crediti Coding Plan inoltre non possono essere convertiti in saldo dell'account.

Come ottengo una fattura?

Richiedila o falla riemettere dallo storico di fatturazione nella tua dashboard. I link di download hanno una validità limitata nel tempo: salva il PDF nel momento in cui lo generi.

Quali metodi di pagamento sono accettati?

Carte di credito e debito (tramite Stripe), WeChat Pay, Alipay e criptovalute. I pagamenti vengono elaborati in USD.

Ci sono bonus di iscrizione o programmi referral?

Atlas Cloud propone di tanto in tanto promozioni sulle ricariche — controlla la pagina di fatturazione per vedere quali sono attive al momento. Esiste anche un programma referral: condividi il tuo link e guadagni crediti quando una persona che hai invitato completa la sua prima ricarica. Vedi Saldo e crediti.

I crediti scadono?

I crediti prepagati sono validi per un periodo definito a partire dalla data di acquisto, e i crediti promozionali possono avere condizioni proprie. Vedi Saldo e crediti e la Politica di uso accettabile.

Contenuti e moderazione

La mia generazione video è fallita con un errore di copyright o di audio sensibile. Cosa faccio?

Di solito il problema viene dalla traccia audio, non dal video. Le opzioni:

• Disattiva la generazione dell'audio se non ti serve — molti modelli video accettano un flag come generate_audio: false
• Fornisci un tuo audio royalty-free da usare come colonna sonora
• Riformula il prompt chiedendo musica originale invece di nominare un brano o un artista esistente

Le richieste bloccate dalla moderazione non vengono fatturate.

La mia generazione è stata bloccata dalla moderazione dei contenuti. Perché?

I prompt che descrivono persone reali, minori o altri contenuti soggetti a restrizioni vengono rifiutati. Alcuni modelli supportano la generazione guidata da riferimenti con materiale che carichi tu: è questa la strada supportata per il lavoro sulla somiglianza. Vedi la Politica di uso accettabile.

Un modello che usavo è sparito. Che cosa è successo?

I modelli vengono talvolta ritirati quando un provider li dismette o quando la loro affidabilità cala. La Libreria dei modelli rispecchia sempre ciò che è disponibile in questo momento. Se è sparito un modello da cui dipendi, contatta il supporto: possiamo suggerirti un sostituto.

Account e team

Ho effettuato l'accesso con GitHub ma non riesco ad aggiungere credito.

GitHub non restituisce sempre un indirizzo email, e la fatturazione ne richiede uno. Aggiungi un'email dalle impostazioni dell'account, poi ricarica normalmente.

Ho effettuato l'accesso e il mio saldo è sparito.

Potresti aver creato un secondo account. Accedere con Google, GitHub o email crea account separati anche con lo stesso indirizzo, a meno che non siano stati collegati. Accedi con lo stesso metodo che hai usato per registrarti. Se esistono duplicati, contatta il supporto.

Cosa possono fare i team?

Gli account team condividono un saldo, supportano più membri con ruoli e ti permettono di creare chiavi API circoscritte al team. La spesa può essere suddivisa per chiave e per membro, e il saldo può essere trasferito tra un account personale e un team. Vedi Account Team e Controllo Accessi Basato sui Ruoli.

Come elimino il mio account?

Contatta il supporto dal tuo indirizzo email registrato, indicando l'UUID dell'account. Tieni presente che:

• Il saldo residuo non è rimborsabile — spendilo prima
• C'è un periodo di ripensamento durante il quale puoi annullare la richiesta
• Dopo la chiusura, la stessa email non può essere usata per registrarsi di nuovo

Se vuoi solo rimuovere i contenuti generati senza chiudere l'account, puoi eliminare direttamente i record dello storico. Vedi Politica di cancellazione dei dati.

Dati e sicurezza

Come vengono trattati i miei dati?

Le richieste vengono trasmesse su TLS. Atlas Cloud conserva il contenuto delle richieste solo per un breve periodo, per l'erogazione del servizio e la fatturazione, e ogni provider a monte ha una propria politica di conservazione. Vedi Conservazione dei dati e l'Informativa sulla privacy.

I miei contenuti vengono usati per addestrare i modelli?

No. Atlas Cloud non usa i contenuti inviati tramite la piattaforma per addestrare, mettere a punto, valutare o sottoporre a benchmark i modelli che ospita, salvo tua autorizzazione scritta.

Posso controllare per quanto tempo vengono conservati i miei dati?

Sì. Le richieste di generazione di media accettano header di conservazione per singola richiesta, che riducono il tempo di conservazione dei file generati e dei record di richiesta. Vedi Conservazione dei dati.

E per quanto riguarda i diritti sulla protezione dei dati?

Puoi richiedere in qualsiasi momento l'accesso, la cancellazione o l'esportazione dei tuoi dati personali. Scrivi a [email protected]. Vedi Politica di cancellazione dei dati per sapere che cosa viene rimosso e che cosa deve essere conservato per obblighi legali e contabili.

Come ottenere aiuto

• Documentazione — sfoglia la barra laterale, oppure parti dalla Guida rapida
• Supporto via email — [email protected]
• Community — Discord
• Vendite e prezzi per volumi — [email protected]
• Richieste sulla privacy — [email protected]

Quando segnali un problema dell'API, includi l'header X-Request-ID della risposta fallita, oppure l'ID della predizione per un job di generazione. Vedi Errori e limiti di frequenza.