1StopTek

Entwicklerdienste

Entwickler

Baue auf dem 1StopTek-Ökosystem.

Integriere Kommunikation, KI und Dateninfrastruktur über 1StopTek-Entwicklerdienste in deine Anwendungen.

1st AI Platform API

In Erprobung

Mit der 1st AI Platform API bauen.

Eine versionierte HTTPS-API für Chat Completions, Streaming, strukturierte Ausgabe und Embeddings, betrieben auf der Plattform von 1StopTek.

Eingeschränkter Test

Zugang nur für eingeladene Tester. Der geplante Staging-Host ist noch nicht online, und es ist kein Modell angebunden: Inferenz-Anfragen beantworten 503 inference_unavailable. Nichts wird berechnet.

Funktionen

Funktionen
FunktionStatusDetails
Chat CompletionsIn ErprobungPOST /api/v1/chat/completions mit System-, User- und Assistant-Nachrichten; temperature, top_p, max_tokens und stop.
StreamingIn ErprobungServer-Sent Events (stream: true): chat.completion.chunk-Events, danach data: [DONE].
Strukturierte AusgabeIn Erprobungresponse_format json_object oder json_schema; das Ergebnis wird gegen dein Schema validiert. Nicht mit Streaming kombinierbar.
EmbeddingsIn ErprobungPOST /api/v1/embeddings, bis zu 64 Eingaben mit jeweils bis zu 8.000 Zeichen.
ModellabfrageIn ErprobungGET /api/v1/models listet jedes Modell mit seinen Fähigkeiten, seinem Kontextfenster und seinem Ausgabelimit.
Nutzungs-APIIn ErprobungGET /api/v1/usage liefert die täglichen Token-Anzahlen eines Projekts und die Summen seit Monatsbeginn.
Dokumentenabruf (RAG)GeplantIn Eurylie mit Quellenangaben implementiert; in der Entwickler-API noch nicht verfügbar.
Tool- und Function-CallingGeplantAnfragen, die Tools verwenden, werden mit einem expliziten Fehler abgelehnt und niemals stillschweigend ignoriert.
Bild- und AudioeingabeNicht unterstütztNur Text. Nicht-textuelle Inhalte werden mit unsupported_content_type abgelehnt.

Modelle und ihre Limits

Die Plattform stellt Open-Weight-Modelle auf eigener Inferenz-Hardware bereit. GET /api/v1/models ist die maßgebliche Liste für jede Umgebung: Jeder Eintrag nennt Fähigkeiten, Kontextfenster und maximale Ausgabe-Tokens.

Kontextfenster
Pro Modell, gemeldet von GET /api/v1/models. Geplante Staging-Konfiguration: 4.096 Tokens, Prompt und Ausgabe zusammen.
Maximale Ausgabe pro Anfrage
Der niedrigere Wert aus dem Limit deines Tiers (1.024 in Sandbox, 4.096 in höheren Tiers) und dem eigenen Limit des Modells (1.024 in der geplanten Staging-Konfiguration).
Nachrichten pro Anfrage
bis zu 256
Embeddings pro Anfrage
64 Eingaben mit jeweils 8.000 Zeichen

Durchsatz und Latenz wurden auf der produktiven Inferenz-Hardware noch nicht gemessen. Wir werden gemessene Werte veröffentlichen, keine Zielwerte.

Safety Layer

Ein- und Ausgaben durchlaufen den Safety Layer der Plattform. Eine abgelehnte Anfrage liefert safety_error; eine abgelehnte Ausgabe endet mit finish_reason content_filter.

APIs und Dokumentation

APIs und Dokumentation

Die Entwickler-API nutzt HTTPS und JSON, mit einer OpenAPI-3.1-Beschreibung, die aus demselben Vertrag generiert wird, gegen den der Server getestet wird.

Basis-URLs

URL
Staging (Erprobung)https://platform-api-staging.1stoptek.comGeplanter Host, noch nicht online. Nur für eingeladene Tester; noch kein Modell angebunden
Produktionhttps://api.1stoptek.comNoch nicht geöffnet · nur Live-Schlüssel (1stai_live_…)

Authentifizierung

Sende den API-Schlüssel deines Projekts als Bearer-Token: Authorization: Bearer 1stai_test_…. Rufe die API nur von deinem Server aus auf; gib einen Schlüssel niemals an einen Browser oder eine mobile App weiter.

Schnellstart

Eingeschränkter Test

Getestet wird auf Einladung. Freigegebene Tester melden sich in der Konsole an, geben einmal ihr Alter an (auf Staging erforderlich) und können Organisationen, Projekte und Testschlüssel anlegen. Bis ein sicherheitsgeprüftes Modell angebunden ist, beantworten Chat-, Streaming- und Embedding-Anfragen 503 inference_unavailable, und nichts wird berechnet.
  1. Fordere Testzugang an (developers@1stoptek.com), erstelle dann ein 1StopTek-Konto und bestätige deine E-Mail-Adresse.
  2. Öffne die Entwicklerkonsole und lege eine Organisation an; sie beginnt mit einem Default-Projekt.
  3. Erstelle einen API-Schlüssel für das Projekt. Kopiere ihn sofort: Er wird nur einmal angezeigt.
  4. Exportiere ihn als FIRSTAI_API_KEY und sende deine erste Anfrage.
Shell
export FIRSTAI_BASE_URL=https://platform-api-staging.1stoptek.com
export FIRSTAI_API_KEY=1stai_test_...   # from the developer console
Chat Completion · curl
curl -sS "$FIRSTAI_BASE_URL/api/v1/chat/completions" \
  -H "Authorization: Bearer $FIRSTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "system", "content": "You answer in one sentence."},
      {"role": "user", "content": "What is an API key?"}
    ],
    "max_tokens": 120
  }'
Streaming · curl
curl -sS -N "$FIRSTAI_BASE_URL/api/v1/chat/completions" \
  -H "Authorization: Bearer $FIRSTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Count from one to five."}],
    "max_tokens": 60,
    "stream": true
  }'
# data: {"object":"chat.completion.chunk","choices":[{"delta":{"content":"One"},...}]}
# ...
# data: [DONE]
Embeddings · curl
curl -sS "$FIRSTAI_BASE_URL/api/v1/embeddings" \
  -H "Authorization: Bearer $FIRSTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": ["first document", "second document"]}'
Strukturierte Ausgabe · curl
curl -sS "$FIRSTAI_BASE_URL/api/v1/chat/completions" \
  -H "Authorization: Bearer $FIRSTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Extract: Berlin is the capital of Germany."}],
    "max_tokens": 120,
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "fact",
        "schema": {
          "type": "object",
          "properties": {"city": {"type": "string"}, "country": {"type": "string"}},
          "required": ["city", "country"]
        }
      }
    }
  }'
Python (Standardbibliothek)
import json, os, urllib.request

req = urllib.request.Request(
    os.environ["FIRSTAI_BASE_URL"] + "/api/v1/chat/completions",
    method="POST",
    headers={
        "Authorization": "Bearer " + os.environ["FIRSTAI_API_KEY"],
        "Content-Type": "application/json",
    },
    data=json.dumps({
        "messages": [{"role": "user", "content": "Say hello."}],
        "max_tokens": 60,
    }).encode(),
)
try:
    with urllib.request.urlopen(req, timeout=120) as resp:
        body = json.load(resp)
        print(body["choices"][0]["message"]["content"])
        print(body["usage"])
except urllib.error.HTTPError as err:
    error = json.load(err)["error"]
    print(err.code, error["type"], error["code"], error["request_id"])
JavaScript (Node.js 18+, ohne Abhängigkeiten)
const res = await fetch(`${process.env.FIRSTAI_BASE_URL}/api/v1/chat/completions`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FIRSTAI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    messages: [{ role: "user", content: "Say hello." }],
    max_tokens: 60,
  }),
});
const body = await res.json();
if (!res.ok) {
  const { type, code, request_id } = body.error;
  throw new Error(`${res.status} ${type}/${code} (request ${request_id})`);
}
console.log(body.choices[0].message.content, body.usage);

Ein eigenes SDK-Paket gibt es noch nicht. Die Beispiele verwenden reines HTTP; da die Anfrage- und Antwortstrukturen dem verbreiteten Chat-Completions-Format folgen, funktionieren viele bestehende Client-Bibliotheken, wenn man die Basis-URL ändert. Wir dokumentieren nur Clients, die wir getestet haben.

Anfragelimits

Jedes Projekt hat ein Kontingent an Anfragen pro Minute und jede Organisation ein monatliches Token-Kontingent, beide durch ihr Tier festgelegt. Jede Antwort meldet die verbleibenden Anfragen in X-RateLimit-Limit-Requests und X-RateLimit-Remaining-Requests; eine 429-Antwort enthält Retry-After.

TierAnfragen pro Minute (pro Projekt)Tokens pro Monat (pro Organisation)Max. Ausgabe-TokensGleichzeitige Streams
sandbox20500.0001.0242
developer12010.000.0004.09610
scale600100.000.0004.09650
enterprise3.0001.000.000.0004.096200

Neue Organisationen starten im Sandbox-Tier. Tiers sind Limits, keine Preise; höhere Tiers werden nach Prüfung vergeben.

Fehler

Jeder Fehler hat dieselbe JSON-Struktur. Verzweige anhand von type; protokolliere request_id, wenn du den Support kontaktierst. Fehlermeldungen enthalten niemals deinen Prompt.

JSON
{"error": {"type": "rate_limit_error", "code": "rate_limited",
  "message": "project limit of 20 requests per minute reached",
  "param": null, "request_id": "req_…", "retry_after_seconds": 3}}
HTTPtypeTypische Codes
400invalid_request_errorinvalid_messages, unsupported_parameter, context_length_exceeded
401authentication_errorinvalid_api_key
402quota_exceeded_errormonthly_quota_exceeded, spending_limit_reached
403permission_errorforbidden, organization_suspended
404not_found_errormodel_not_found
409conflict_errorkey_limit_reached, project_archived
422safety_errorsafety_refused
429rate_limit_errorrate_limited, too_many_streams
502 / 504model_errormodel_error, model_timeout, invalid_structured_output
503service_unavailable_errormodel_unavailable, billing_unavailable

Wiederholungen

Wiederhole 429 nach Ablauf von Retry-After und 502/503/504 mit exponentiellem Backoff. Wiederhole 4xx-Validierungsfehler nicht unverändert. Jeder Versuch ist eine eigene Anfrage und wird separat gemessen.

Versionierung

Die Hauptversion steht im Pfad (/api/v1) und im Header X-API-Version. Innerhalb von v1 fügen wir nur hinzu: neue Endpunkte, neue optionale Felder und neue Enum-Werte. Clients müssen unbekannte Felder ignorieren. Eine inkompatible Änderung erscheint als /api/v2, vorab angekündigt und mit einer Übergangsfrist für v1.

Entwicklerkonto und API-Schlüssel

Entwicklerkonto und API-Schlüssel

Ein 1StopTek-Konto genügt für die Anmeldung. Organisationen, Projekte und Schlüssel gehören zur Plattform; die Konsole verwaltet sie für dich.

Von der Registrierung zur ersten Anfrage

  1. 01

    Konto erstellen

    Getestet wird auf Einladung: Fordere Testzugang an und registriere dich dann mit E-Mail und Passwort.

  2. 02

    E-Mail bestätigen

    Folge dem Link, den wir dir senden. Unbestätigte Konten haben keinen Zugriff auf die Konsole.

  3. 03

    Organisation anlegen

    Du wirst deren Inhaber. Zusammen mit ihr wird ein Default-Projekt angelegt.

  4. 04

    API-Schlüssel erzeugen

    Wähle Name, Scopes und optional ein Ablaufdatum. Der vollständige Schlüssel wird einmal angezeigt.

  5. 05

    Erste Anfrage senden

    Nutze den Schnellstart mit deinem Schlüssel.

  6. 06

    Nutzung und Kosten einsehen

    Tokens, Anfragen und geschätzte Kosten pro Projekt und Schlüssel.

Wie API-Schlüssel geschützt sind

  • Schlüssel haben die Form 1stai_test_<id>_<secret>. Staging gibt nur Testschlüssel aus, Produktion nur Live-Schlüssel, und keiner funktioniert in der jeweils anderen Umgebung.
  • Der vollständige Schlüssel wird genau einmal angezeigt, beim Erstellen oder Rotieren. Danach zeigt die Konsole nur noch einen kurzen Hinweis.
  • Die Plattform speichert einen geschlüsselten Hash (HMAC-SHA-256 mit einem serverseitigen Secret), niemals den Schlüssel selbst. Eine Datenbankkopie allein reicht nicht zur Authentifizierung.
  • Schlüssel sind auf ein Projekt beschränkt und tragen nur die Scopes, die du wählst: models:read, chat:write, embeddings:write, usage:read.
  • Ein Widerruf wirkt ab der nächsten Anfrage. Eine Rotation stellt einen Ersatzschlüssel aus und lässt den alten Schlüssel während einer von dir gewählten Übergangsfrist weiter funktionieren (bis zu 7 Tage, oder 0 für sofortigen Widerruf).
  • Organisationen sind voneinander isoliert: Jeder Konsolen- und API-Aufruf wird gegen die Organisation geprüft, zu der der Schlüssel oder das Konto gehört.

Website-Assistenten

Website-Assistenten für Entwickler

Die technischen Details hinter der geführten Einrichtung in der Konsole.

Nur ein Beispiel: Website-Assistenten sind für Kunden noch nicht verfügbar.

Der Installationscode

Der Code bezeichnet den Assistenten mit seiner öffentlichen Assistenten-ID. Er enthält keinen Schlüssel. Der Assistent nimmt Browser-Anfragen nur von den exakten https-Origins von Websites an, deren Inhaberschaft bestätigt wurde. Ein Programm außerhalb eines Browsers kann einen Origin vortäuschen, deshalb gelten zusätzlich Limits pro Besucher, pro Assistent und dein Ausgabenlimit.

HTML
<script src="https://{widget-host}/widget/v1/agent.js" data-agent="agt_…" async></script>

Der Widget-Host steht noch nicht fest; der Code zeigt einen Platzhalter.

Feste Version mit Subresource Integrity

Der stabile Pfad folgt kompatiblen Widget-Updates. Um eine Version festzulegen, nutze den versionierten Pfad und den Integritäts-Hash aus der manifest.json des Widgets.

HTML
<script src="https://{widget-host}/widget/v1/{version}/agent.js"
        integrity="sha384-…" crossorigin="anonymous"
        data-agent="agt_…" async></script>

Optionen

  • data-locale="de" legt die Sprache fest.
  • Ein Element mit id="1stai-agent" zeigt den Assistenten eingebettet statt schwebend.
  • Mit einer Content Security Policy erlaube den Plattform-Origin in script-src und connect-src sowie Inline-Styles für das eigene Style-Element des Widgets.

Server zu Server (erweiterte Einstellungen)

Ein agents:invoke-Schlüssel ist an die Assistenten gebunden, die du auswählst, und hat keine weitere Berechtigung. Bewahre ihn auf deinem Server auf; nie in einer Webseite.

Nutzung und Abrechnung

Nutzung und Abrechnung

Die Messung erfolgt auf dem Server, pro Anfrage, in dem Moment, in dem eine Anfrage abgeschlossen ist. Die Konsole zeigt genau das, was die Plattform erfasst hat.

Was gemessen wird

  • Ein Datensatz pro Anfrage: Organisation, Projekt, Schlüssel-ID, Endpunkt, Modell, Status, Eingabe- und Ausgabe-Tokens, Latenz. Keine Prompt- oder Ausgabeinhalte.
  • Token-Anzahlen stammen vom Modellserver, sofern er sie meldet; andernfalls werden sie geschätzt und als geschätzt gekennzeichnet.
  • Eine Wiederholung mit einer neuen Anfrage erzeugt einen neuen Datensatz. Dieselbe Request-ID wird niemals doppelt gezählt.

Was du in der Konsole siehst

  • Tokens und Anfragen seit Monatsbeginn im Verhältnis zu deinem Kontingent, pro Projekt und pro Schlüssel.
  • Geschätzte aktuelle Kosten, sobald eine Preisliste gilt, mit Netto, Umsatzsteuer und Brutto getrennt ausgewiesen.
  • Monatsaufstellungen für abgeschlossene Monate. Rechnungen werden noch nicht ausgestellt; das geschieht, sobald der kostenpflichtige Zugang geöffnet ist.

Warnungen und Ausgabenlimits

Warnschwelle

Erfasst eine Warnung, wenn die Nutzungskosten seit Monatsbeginn (vor dem enthaltenen Freikontingent) den Betrag überschreiten. Anfragen funktionieren weiter.

Hartes Ausgabenlimit

Anfragen, die die Nutzungskosten seit Monatsbeginn (vor dem enthaltenen Freikontingent) über das Limit bringen könnten, werden mit 402 spending_limit_reached abgelehnt, bevor das Modell aufgerufen wird.

Laufende Anfragen

Vor dem Modellaufruf reserviert die Plattform die maximal möglichen Kosten der Anfrage (Eingabe plus dein max_tokens). Bereits zugelassene Anfragen werden normal abgeschlossen, und ihre tatsächlichen Kosten übersteigen nie die Reservierung, sodass gleichzeitige Anfragen ein hartes Limit nicht gemeinsam überschreiten können. Eine Anfrage, die das verbleibende Budget überschreiten könnte, wird abgelehnt, auch wenn ihre tatsächlichen Kosten niedriger gewesen wären.

Wenn die Nutzung nicht geprüft werden kann

Kann die Plattform Nutzung, Reservierungen oder Limits nicht lesen, lehnt sie die Anfrage mit 503 billing_unavailable ab. Eine fehlgeschlagene Abfrage gewährt niemals unbegrenzten Zugriff.

API v1 · contract 0b847d90d1

PulseChat Business API

Implementiert, nicht freigeschaltet

Business-Messaging für die Systeme, die du schon nutzt.

Verifizierte Unternehmen werden ihren Shop, ihr Ticketsystem oder ihre Buchungssoftware mit PulseChat verbinden: um Support-Unterhaltungen zu beantworten, die Kunden beginnen, und um Transaktionsnachrichten an Kunden zu senden, die eingewilligt haben.

Die Business-API ist implementiert und getestet, aber noch nicht freigeschaltet und hat keine externen Entwickler. Einrichtung, Sandbox und Live-Zugang sind nicht geöffnet; diese Seite sagt, wenn sich das ändert.

Zwei unterstützte Wege

Antworten auf Support-Unterhaltungen

Ein Kunde beginnt in PulseChat eine Unterhaltung mit deinem Unternehmen. Dein System kann sie lesen und antworten. Dein Unternehmen kann solche Unterhaltungen nicht beginnen.

Transaktionsnachrichten

Bestell-, Service-, Termin- und Kontoupdates mit von PulseChat freigegebenen Vorlagen, nur an Kunden, die Updates deines Unternehmens zugestimmt haben. Kunden können jederzeit widerrufen. Das endgültige Einwilligungsmodell wird rechtlich geprüft.

Was es gibt und welchen Status es hat

  • Antworten auf von Kunden begonnene UnterhaltungenImplementiert, nicht freigeschaltet
  • Transaktionsnachrichten an eingewilligte KundenImplementiert, nicht freigeschaltet
  • Vorlagen mit Prüfung durch PulseChatImplementiert, nicht freigeschaltet
  • Sandbox mit synthetischen KundenImplementiert, nicht freigeschaltet
  • Eng begrenzte API-Schlüssel mit Rotation und WiderrufImplementiert, nicht freigeschaltet
  • Signierte WebhooksImplementiert, nicht freigeschaltet
  • Ereignisabruf (Polling)Implementiert, nicht freigeschaltet
  • NutzungslimitsImplementiert, nicht freigeschaltet
  • Live-Zugang nach Freigabe durch PulseChatImplementiert, nicht freigeschaltet
  • Website-ChatGeplant

Was die API nicht tut

  • Eine Unterhaltung beginnen oder Kunden schreiben, die weder zuerst geschrieben noch eingewilligt haben
  • Kunden schreiben, die das Unternehmen blockiert oder ihre Einwilligung widerrufen haben
  • Werbe- oder Massennachrichten senden
  • Anmelde- oder Bestätigungscodes senden

Wie Kunden referenziert werden

Dein System sieht einen Kunden nur über eine Referenz, die für dein Unternehmen gilt, nicht über Telefonnummer, PulseChat-ID oder Namen. Das ist keine Anonymität: Kunden können in ihren eigenen Nachrichten weiterhin persönliche Angaben machen.

Die Einrichtung ist noch nicht geöffnet

Geführte Einrichtung und Entwicklerdokumentation erscheinen, sobald PulseChat die API öffnet. Wenn du für den Pilotbetrieb in Frage kommen möchtest, melde dich.

Für echte Abläufe gebaut

E-Commerce

  1. Bestellbestätigung
  2. Versandupdate
  3. Zustellupdate
  4. Antwort auf die Frage des Kunden

SaaS

Konto- und Serviceupdates sowie Antworten auf Support-Unterhaltungen, die deine Kunden beginnen.

Buchungen

Bestätigungen, Erinnerungen, Änderungen und Stornierungen.

Marktplätze

Bestell- und Supportnachrichten zwischen einem Marktplatz und seinen eigenen Kunden, ohne Telefonnummern der Kunden weiterzugeben.

Wie eine Nachricht reist
  1. Dein Server
  2. PulseChat Business API
  3. PulseChat
  4. Dein Kunde

1Stop DataHub

Geplant

Die Steuerungsebene für Entwickler und Unternehmen im 1StopTek-Ökosystem.

Ein Ort, an dem deine Organisation ihre 1StopTek-Integrationen verwaltet — Anwendungen, Zugangsdaten, Teams und Nutzung.

Ein Konto. Mehrere Produkte. Eine Plattform.

Entwickler und Organisationen werden unterstützte 1StopTek-Integrationen aus einer Umgebung heraus verwalten. Die Fundamente darunter — Identität, Rollen und Berechtigungen, Berechtigungsverwaltung, Auditierung — sind in aktiver Entwicklung; DataHub ist das darauf geplante Produkt.

Was es verwalten wird

  • Anwendungen
  • API-Zugangsdaten
  • Webhooks
  • Teams
  • Rollen und Berechtigungen
  • API-Nutzung
  • Analysen
  • Abonnements und Abrechnung
  • Integrationen
  • Unterstützte 1StopTek-Dienste
Eine Steuerungsebene
Deine Anwendung1Stop DataHubPulseChat · 1st AI Platform · künftige 1StopTek-APIs

Entwicklerdienste

Business oder Entwickler?

1StopTek Developers

Für Entwickler, die 1StopTek-Technologie in Anwendungen und Dienste integrieren.

1Stop DataHub

Die geplante technische Verwaltungsebene, die Anwendungen, Zugangsdaten, Berechtigungen, Nutzung und unterstützte Ökosystem-Dienste verbindet.

Bau mit 1StopTek

Der Entwicklerzugang zur PulseChat Business API, zur 1st AI Platform API und zu 1Stop DataHub wird vorbereitet. Ob Entwickler, Unternehmen oder Integrationspartner — sprich mit uns über Early Access, API-Integrationen, Enterprise-Integrationen und Partnerschaften.

developers@1stoptek.com