API-Schlüssel

API-Schlüssel werden zur Authentifizierung Ihrer Anfragen an Atlas Cloud APIs verwendet. Jeder API-Aufruf erfordert einen gültigen API-Schlüssel.

API-Schlüssel erstellen

1. Melden Sie sich bei der Atlas Cloud-Konsole an
2. Gehen Sie zu Kontoeinstellungen
3. Erweitern Sie den Abschnitt API-Schlüssel-Verwaltung
4. Klicken Sie auf API-Schlüssel erstellen
5. Kopieren Sie Ihren neuen API-Schlüssel und speichern Sie ihn sicher

Ihr API-Schlüssel wird nur einmal bei der Erstellung angezeigt. Wenn Sie ihn verlieren, müssen Sie einen neuen erstellen.

Ihren API-Schlüssel verwenden

Fügen Sie Ihren API-Schlüssel in den Authorization-Header jeder API-Anfrage ein:

Authorization: Bearer your-api-key

LLM / Chat Completions (OpenAI-kompatibel)

Basis-URL: 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!"}]
)

Bild- / Videogenerierung

Basis-URL: 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"
    }
)

Medien hochladen

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")}
)

# Gibt eine temporäre URL zur Verwendung mit Generierungsaufgaben zurück
print(response.json())

Integration mit Drittanbieter-Tools

Sie können Ihren Atlas Cloud API-Schlüssel mit jedem OpenAI-kompatiblen Tool oder jeder Anwendung verwenden. Beliebte Optionen sind:

Bei der Konfiguration von Drittanbieter-Tools:

• API-Host / Basis-URL: https://api.atlascloud.ai/v1 (das Suffix /v1 ist erforderlich)
• API-Schlüssel: Ihr Atlas Cloud API-Schlüssel
• Modellname: Jedes Modell aus der Modellbibliothek

Sicherheits-Best-Practices

• Teilen Sie niemals Ihren API-Schlüssel und committen Sie ihn nicht in die Versionskontrolle
• Verwenden Sie Umgebungsvariablen zum Speichern Ihres API-Schlüssels:

  export ATLASCLOUD_API_KEY="your-api-key"

• Rotieren Sie Schlüssel regelmäßig — löschen Sie alte Schlüssel und erstellen Sie neue
• Verwenden Sie separate Schlüssel für Entwicklungs- und Produktionsumgebungen
• Überwachen Sie die Nutzung in der Konsole, um unbefugte Nutzung zu erkennen

Schlüsselverwaltung

Sie können Ihre API-Schlüssel in den Kontoeinstellungen verwalten:

• Erstellen — Generieren Sie neue API-Schlüssel nach Bedarf
• Löschen — Widerrufen Sie API-Schlüssel, die nicht mehr benötigt werden oder kompromittiert sein könnten
• Nutzung anzeigen — Überwachen Sie die API-Nutzung und die mit jedem Schlüssel verbundenen Kosten

Ratenbegrenzungen

API-Ratenbegrenzungen variieren je nach Kontostufe und Modelltyp. Wenn Sie auf Ratenbegrenzungsfehler (429 Too Many Requests) stoßen, erwägen Sie:

• Eine kleine Verzögerung zwischen Anfragen hinzuzufügen
• Exponentielles Backoff für Wiederholungsversuche zu verwenden
• [email protected] für höhere Limits zu kontaktieren