Zum Inhalt springen
Entwickler

Developer Hub

Offene API-Spezifikationen, MCP-Manifeste, OAuth-Endpunkte und LLM-Sitemaps für die Integration mit SIMOSphere AI.

API-Dokumentation

OpenAPI-3.1-Spezifikation mit allen Endpunkten, Authentifizierung und Fehler-Codes.

/openapi.json

SDKs & Libraries

Offizielle Client-Libraries für Python, Node.js und Go — typsicher und versioniert.

In Vorbereitung

MCP-Spezifikation

MCP-Manifest, Server-Card und Surface-Endpunkte. WebMCP via Streamable HTTP (JSON-RPC 2.0).

/.well-known/mcp/manifest.json

MCP-Server

WebMCP-Endpoint mit JSON-RPC 2.0 über Streamable HTTP. Browser-Agents können Tools direkt aufrufen.

/mcp

Agent Skills

Skills-Index für KI-Agenten: Tools, Prompts und Ressourcen als maschinenlesbare Manifeste.

/.well-known/agent-skills/index.json

Changelog

Alle Plattform-Änderungen dokumentiert — Breaking Changes, neue Features und Bugfixes.

Authentifizierung

Alle API-Endpunkte unter /v1/* erfordern ein Bearer-Token im Authorization-Header. Tokens sind API-Keys, die im SIMOSphere AI Dashboard erstellt werden und einem Tenant zugeordnet sind. Die Plattform unterstützt heute API-Key-Authentifizierung, OAuth 2.0 (Authorization Code + PKCE) ist für Q4 2026 geplant.

1. Konto erstellen

Registrieren Sie sich unter app.simosphereai.com/register. Alle Pläne umfassen eine 14-tägige kostenlose Testphase ohne Kreditkarte. Nach der E-Mail-Verifizierung erhalten Sie Zugang zum Dashboard.

2. API-Key generieren

Navigieren Sie im Dashboard zu Einstellungen > API-Keys und klicken Sie auf Neuen Key erstellen. Wählen Sie die benötigten Scopes (chat, embeddings, files, models). Kopieren Sie den Key sofort — er wird nur einmal angezeigt.

3. Anfragen authentifizieren

Übergeben Sie den Key als Bearer-Token: Authorization: Bearer sk_live_IHR_KEY. Das Gateway validiert den Key, prüft Rate-Limits, verifiziert Plan-Berechtigungen und routet die Anfrage zum passenden Modell-Backend.

Code-Beispiele

SIMOSphere AI stellt eine OpenAI-kompatible REST-API bereit. Sie können jedes OpenAI-SDK oder einen Standard-HTTP-Client verwenden, um mit der Plattform zu interagieren. Nachfolgend finden Sie Beispiele für den Chat-Completions-Endpunkt, der Nachrichten entgegennimmt und modellgenerierte Antworten zurückliefert.

curl — Chat Completions

Senden Sie eine Chat-Completion-Anfrage über die Kommandozeile. Ersetzen Sie sk_live_YOUR_API_KEY durch Ihren tatsächlichen API-Key. Die Antwort folgt dem OpenAI Chat-Completions-Format.

curl -X POST https://api.simosphereai.com/v1/chat/completions \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-small-latest",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is the EU AI Act?"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

TypeScript — OpenAI SDK

Verwenden Sie das offizielle OpenAI Node.js SDK mit der SIMOSphere AI Base-URL. Dieser Ansatz bietet vollständige Typsicherheit, automatische Wiederholungsversuche und Streaming-Unterstützung.

import OpenAI from "openai";

// SIMOSphere AI is OpenAI-compatible — use any OpenAI SDK
const client = new OpenAI({
  apiKey: process.env.SIMOSPHERE_API_KEY,
  baseURL: "https://api.simosphereai.com/v1",
});

const response = await client.chat.completions.create({
  model: "mistral-small-latest",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "Summarise the GDPR in 3 sentences." },
  ],
  temperature: 0.7,
  max_tokens: 512,
});

console.log(response.choices[0].message.content);
// Token usage: response.usage.total_tokens

Python — OpenAI SDK

Das Python OpenAI SDK funktioniert identisch. Setzen Sie die base_url auf SIMOSphere AI und verwenden Sie Ihren API-Key. Alle OpenAI-kompatiblen Features einschließlich Streaming, Function Calling und JSON-Modus werden unterstützt.

from openai import OpenAI

client = OpenAI(
    api_key="sk_live_YOUR_API_KEY",
    base_url="https://api.simosphereai.com/v1",
)

response = client.chat.completions.create(
    model="mistral-small-latest",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain data sovereignty in the EU."},
    ],
    max_tokens=512,
)

print(response.choices[0].message.content)

Rate-Limits

Rate-Limits werden pro API-Key angewendet und hängen von Ihrem Plan ab. Limits gelten für Anfragen pro Minute (RPM) und Token pro Monat (TPM). Bei Überschreitung liefert die API HTTP 429 mit einem Retry-After-Header, der angibt, wann die nächste Anfrage gesendet werden kann.

PlanAnfragen / Min.Token / Monat
Personal605M
Freelancer12020M
Professional300100M
Business600500M
Enterprise1,2002B

Jede Antwort enthält die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset für proaktives Monitoring.

Fehler-Codes

Alle Fehlerantworten verwenden ein einheitliches JSON-Format mit den Feldern type, message und code. Implementieren Sie Retry-Logik für transiente Fehler (429, 500, 503) und Credential-Refresh-Logik für persistente 401-Fehler.

401

Ungültiger API-Key

Prüfen Sie, ob der Authorization: Bearer Header einen gültigen, nicht widerrufenen Key enthält.

401

Abgelaufenes Token

Authentifizieren Sie sich erneut über den Login-Endpunkt, um ein frisches JWT-Token zu erhalten.

403

Unzureichender Scope

Dem API-Key fehlt der benötigte Scope. Ergänzen Sie ihn unter Dashboard > API-Keys.

403

Plan-Limit überschritten

Ihr aktueller Plan enthält dieses Feature nicht. Upgrade unter app.simosphereai.com/billing.

429

Rate-Limit überschritten

Zu viele Anfragen. Warten Sie die im Retry-After-Header angegebene Sekundenanzahl ab.

500

Interner Serverfehler

Ein unerwarteter Fehler ist aufgetreten. Wiederholen Sie mit exponentiellem Backoff. Bei Fortbestehen: Support kontaktieren.

Roadmap

  • NPM-Paket @simosphere/sdk-js (auto-generiert aus OpenAPI)
  • PyPI-Paket simosphere-sdk
  • CLI simosphere via Homebrew
  • MCP-Registry-Listings auf mcp.run / mcphub.io / Smithery
Zur Startseite
Entwickler — SIMOSphere AI