Dokumentation

Einführung

MarsAI ist eine einheitliche, OpenAI-kompatible API für KI-Modell-Inferenz. Ein Endpunkt und ein Key geben Ihnen Zugriff auf Frontier- und Open-Source-Modelle, betrieben auf unserer eigenen GPU-Infrastruktur.

Wenn Sie die OpenAI-API schon genutzt haben, kennen Sie unsere bereits. Richten Sie Ihren bestehenden Client auf die base_url unten, setzen Sie Ihren MarsAI-Key ein — und jede Anfrage, Antwort und Streaming-Form verhält sich genau wie erwartet.

Base URL

https://api.marsai.com/v1

Das bekommen Sie

• Eine API für Frontier- und Open-Modelle, mit automatischem Failover
• Drop-in-OpenAI-Kompatibilität — kein Umschreiben nötig
• Nutzungsbasierte Preise ohne Aufschlag auf Premium-Modelle

Schnellstart

Senden Sie Ihre erste Anfrage in weniger als fünf Minuten.

1. 1

   API-Key holen

   Zugang anfragen — wir senden Ihnen per E-Mail einen auf Ihre Organisation beschränkten Key.

2. 2

   Client auf die Base URL richten

   Setzen Sie base_url auf https://api.marsai.com/v1 in einem beliebigen OpenAI-kompatiblen Client.

3. 3

   Anfrage senden

   Rufen Sie den Chat-Completions-Endpunkt auf und lesen Sie die Antwort — gestreamt oder am Stück.

Anfrage

curl https://api.marsai.com/v1/chat/completions \
  -H "Authorization: Bearer $MarsAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Antwort

{
  "id": "chatcmpl-9a1b...",
  "object": "chat.completion",
  "model": "claude-opus-4-8",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! How can I help?" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 9, "completion_tokens": 7, "total_tokens": 16 }
}

Authentifizierung

Alle Anfragen werden mit einem Bearer-Token im Authorization-Header authentifiziert.

Ihr Key trägt die vollen Berechtigungen Ihres Kontos — halten Sie ihn geheim. Speichern Sie ihn in einer Umgebungsvariablen statt fest im Code, und geben Sie ihn niemals in clientseitigem Code preis.

Beispiel-Header

Authorization: Bearer $MarsAI_API_KEY

SDKs

Da die API OpenAI-kompatibel ist, funktionieren die offiziellen OpenAI-SDKs schon heute — nur die base_url ändert sich.

Python

Installieren Sie das OpenAI-Python-Paket und setzen Sie base_url und api_key.

Installation

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://api.marsai.com/v1",
    api_key="$MarsAI_API_KEY",
)

resp = client.chat.completions.create(
    model="claude-opus-4-8",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

JavaScript / TypeScript Demnächst

Das OpenAI-JS-SDK funktioniert bereits mit unserer base_url. Ein natives MarsAI-SDK ist in Arbeit.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.marsai.com/v1",
  apiKey: process.env.MarsAI_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "claude-opus-4-8",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content);

Beispiele

Typische Anfragen für die Chat-, Bild- und Embedding-Endpunkte.

curl https://api.marsai.com/v1/chat/completions \
  -H "Authorization: Bearer $MarsAI_API_KEY" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [{"role": "user", "content": "Write a haiku about GPUs"}],
    "stream": true
  }'

Fehlercodes

Die API nutzt Standard-HTTP-Statuscodes. Diese begegnen Ihnen am häufigsten.