Chiavi API

Le chiavi API vengono utilizzate per autenticare le tue richieste alle API di Atlas Cloud. Ogni chiamata API richiede una chiave API valida.

Creare una chiave API

Vai a API Keys
Fai clic su Crea chiave API
Copia la tua nuova chiave API e conservala in modo sicuro

Crea chiave API

La tua chiave API verra mostrata solo una volta al momento della creazione. Se la perdi, dovrai crearne una nuova.

Utilizzo della chiave API

Includi la tua chiave API nell'header Authorization di ogni richiesta API:

Authorization: Bearer your-api-key

LLM / Completamento chat (compatibile con OpenAI)

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

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.atlascloud.ai/v1"
)

response = client.chat.completions.create(
    model="deepseek-v3",
    messages=[{"role": "user", "content": "Hello!"}]
)

Generazione di immagini / video

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

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/generateImage",
    headers={"Authorization": "Bearer your-api-key"},
    json={
        "model": "seedream-3.0",
        "prompt": "A cat sitting on a rainbow"
    }
)

Caricamento multimediale

import requests

response = requests.post(
    "https://api.atlascloud.ai/api/v1/model/uploadMedia",
    headers={"Authorization": "Bearer your-api-key"},
    files={"file": open("photo.jpg", "rb")}
)

# Restituisce un URL temporaneo da usare con le attivita di generazione
print(response.json())

Integrazione con strumenti di terze parti

Puoi usare la tua chiave API di Atlas Cloud con qualsiasi strumento o applicazione compatibile con OpenAI. Le opzioni piu popolari includono:

Strumento	Tipo	Configurazione
Chatbox	App desktop	Imposta l'host API su `https://api.atlascloud.ai/v1`
Cherry Studio	App desktop	Aggiungi come provider OpenAI personalizzato
OpenWebUI	Interfaccia web	Configura endpoint compatibile con OpenAI
Cursor	IDE	Usa tramite Server MCP
Claude Code	CLI	Usa tramite Server MCP o Skills

Quando configuri strumenti di terze parti:

Host API / URL di base: https://api.atlascloud.ai/v1 (il suffisso /v1 e obbligatorio)
Chiave API: La tua chiave API di Atlas Cloud
Nome del modello: Qualsiasi modello dalla Libreria modelli

Migliori pratiche di sicurezza

Non condividere mai la tua chiave API e non includerla nel controllo versione
Usa variabili d'ambiente per memorizzare la tua chiave API:
```
export ATLASCLOUD_API_KEY="your-api-key"
```
Ruota le chiavi regolarmente — elimina le chiavi vecchie e creane di nuove
Usa chiavi separate per ambienti di sviluppo e produzione
Monitora l'utilizzo nella Console per rilevare utilizzi non autorizzati

Gestione delle chiavi

Puoi gestire le tue chiavi API nelle Impostazioni account:

Crea — Genera nuove chiavi API secondo necessita
Elimina — Revoca chiavi API non piu necessarie o potenzialmente compromesse
Visualizza utilizzo — Monitora l'utilizzo e i costi dell'API associati a ogni chiave

Limiti di frequenza

I limiti di frequenza dell'API variano in base al livello dell'account e al tipo di modello. Se riscontri errori di limite di frequenza (429 Too Many Requests), considera:

Aggiungere un piccolo ritardo tra le richieste
Utilizzare il backoff esponenziale per i tentativi
Contattare [email protected] per limiti piu elevati

In questa pagina