Come funziona Atlas Cloud

Panoramica dell'architettura

Atlas Cloud e una piattaforma di aggregazione API di IA che si posiziona tra la tua applicazione e molteplici provider di modelli di IA. Invece di integrarti con ogni provider separatamente, usi una singola chiave API di Atlas Cloud e endpoint API coerenti per accedere a oltre 300 modelli da decine di provider.

Your Application
      |
      v
  Atlas Cloud API  ------  Unified authentication, billing, and monitoring
      |
      |-- DeepSeek (V3, Coder)
      |-- Alibaba (Qwen, Qwen-Image)
      |-- ByteDance (Seedream, Seedance, Kling)
      |-- Black Forest Labs (FLUX)
      |-- Luma AI (Video)
      |-- MiniMax (Hailuo)
      +-- ... 20+ more providers

Come funzionano le richieste

API sincrone (LLM / Chat)

I completamenti chat LLM restituiscono risposte in modo sincrono, proprio come l'API di OpenAI:

1. Invii una richiesta POST a /v1/chat/completions con il tuo prompt
2. Atlas Cloud instrada la richiesta al provider del modello selezionato
3. Ricevi la risposta direttamente (o tramite chunk di streaming)

Client  ->  POST /v1/chat/completions  ->  Atlas Cloud  ->  Model Provider
Client  <-  Response (text/stream)     <-  Atlas Cloud  <-  Model Provider

API asincrone (generazione immagini / video)

Le attivita di generazione di immagini e video vengono eseguite in modo asincrono perche richiedono piu tempo per l'elaborazione:

1. Invii una richiesta POST per avviare un'attivita di generazione
2. Atlas Cloud restituisce un ID di predizione immediatamente
3. Interroghi l'endpoint /api/v1/model/prediction/{id} per verificare lo stato dell'attivita
4. Una volta completata, ricevi gli URL di output

Client  ->  POST /api/v1/model/generateImage  ->  Atlas Cloud
Client  <-  { data: { id: "abc123" } }              <-  Atlas Cloud

Client  ->  GET /api/v1/model/prediction/abc123       ->  Atlas Cloud
Client  <-  { data: { status: "processing" } }        <-  Atlas Cloud

Client  ->  GET /api/v1/model/prediction/abc123       ->  Atlas Cloud
Client  <-  { data: { status: "completed", outputs: ["https://..."] } }  <-  Atlas Cloud

Per maggiori dettagli sul polling, consulta Predizioni.

Riepilogo degli endpoint API

Autenticazione

Tutte le richieste API richiedono una chiave API nell'header Authorization:

Authorization: Bearer your-api-key

Ottieni la tua chiave API dalla Console di Atlas Cloud. Consulta la guida Chiavi API per i dettagli.

Vantaggi principali

Un'API, oltre 300 modelli

Non e necessario gestire piu account provider, chiavi API o relazioni di fatturazione. Atlas Cloud gestisce tutte le integrazioni con i provider per te.

Compatibile con l'SDK OpenAI

L'API LLM e completamente compatibile con l'SDK OpenAI. Passa ad Atlas Cloud modificando solo due righe di codice — l'URL di base e la chiave API.

Infrastruttura ottimizzata

L'infrastruttura di inferenza di Atlas Cloud e ottimizzata per velocita e affidabilita:

• Generazione di immagini in meno di 5 secondi
• Generazione di video in meno di 2 minuti
• 99,9% di uptime dell'API

Fatturazione unificata

Un account, un saldo, una fattura — indipendentemente da quanti modelli o provider utilizzi. Monitora l'utilizzo e i costi in tempo reale dalla Console.

Prossimi passi

• Avvio rapido — Fai la tua prima chiamata API
• Predizioni — Comprendi il flusso delle attivita asincrone
• Carica file — Carica file multimediali per i flussi di lavoro di generazione
• API dei modelli — Esplora i modelli disponibili