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.
Entwicklerdienste
Baue auf dem 1StopTek-Ökosystem.
Integriere Kommunikation, KI und Dateninfrastruktur über 1StopTek-Entwicklerdienste in deine Anwendungen.
1st AI Platform API
In ErprobungEine versionierte HTTPS-API für Chat Completions, Streaming, strukturierte Ausgabe und Embeddings, betrieben auf der Plattform von 1StopTek.
Eingeschränkter Test
| Funktion | Status | Details |
|---|---|---|
| Chat Completions | In Erprobung | POST /api/v1/chat/completions mit System-, User- und Assistant-Nachrichten; temperature, top_p, max_tokens und stop. |
| Streaming | In Erprobung | Server-Sent Events (stream: true): chat.completion.chunk-Events, danach data: [DONE]. |
| Strukturierte Ausgabe | In Erprobung | response_format json_object oder json_schema; das Ergebnis wird gegen dein Schema validiert. Nicht mit Streaming kombinierbar. |
| Embeddings | In Erprobung | POST /api/v1/embeddings, bis zu 64 Eingaben mit jeweils bis zu 8.000 Zeichen. |
| Modellabfrage | In Erprobung | GET /api/v1/models listet jedes Modell mit seinen Fähigkeiten, seinem Kontextfenster und seinem Ausgabelimit. |
| Nutzungs-API | In Erprobung | GET /api/v1/usage liefert die täglichen Token-Anzahlen eines Projekts und die Summen seit Monatsbeginn. |
| Dokumentenabruf (RAG) | Geplant | In Eurylie mit Quellenangaben implementiert; in der Entwickler-API noch nicht verfügbar. |
| Tool- und Function-Calling | Geplant | Anfragen, die Tools verwenden, werden mit einem expliziten Fehler abgelehnt und niemals stillschweigend ignoriert. |
| Bild- und Audioeingabe | Nicht unterstützt | Nur Text. Nicht-textuelle Inhalte werden mit unsupported_content_type abgelehnt. |
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.
Durchsatz und Latenz wurden auf der produktiven Inferenz-Hardware noch nicht gemessen. Wir werden gemessene Werte veröffentlichen, keine Zielwerte.
Safety Layer
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.
| URL | ||
|---|---|---|
| Staging (Erprobung) | https://platform-api-staging.1stoptek.com | Geplanter Host, noch nicht online. Nur für eingeladene Tester; noch kein Modell angebunden |
| Produktion | https://api.1stoptek.com | Noch nicht geöffnet · nur Live-Schlüssel (1stai_live_…) |
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.
Eingeschränkter Test
export FIRSTAI_BASE_URL=https://platform-api-staging.1stoptek.com
export FIRSTAI_API_KEY=1stai_test_... # from the developer consolecurl -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
}'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]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"]}'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"]
}
}
}
}'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"])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.
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.
| Tier | Anfragen pro Minute (pro Projekt) | Tokens pro Monat (pro Organisation) | Max. Ausgabe-Tokens | Gleichzeitige Streams |
|---|---|---|---|---|
| sandbox | 20 | 500.000 | 1.024 | 2 |
| developer | 120 | 10.000.000 | 4.096 | 10 |
| scale | 600 | 100.000.000 | 4.096 | 50 |
| enterprise | 3.000 | 1.000.000.000 | 4.096 | 200 |
Neue Organisationen starten im Sandbox-Tier. Tiers sind Limits, keine Preise; höhere Tiers werden nach Prüfung vergeben.
Jeder Fehler hat dieselbe JSON-Struktur. Verzweige anhand von type; protokolliere request_id, wenn du den Support kontaktierst. Fehlermeldungen enthalten niemals deinen Prompt.
{"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}}| HTTP | type | Typische Codes |
|---|---|---|
| 400 | invalid_request_error | invalid_messages, unsupported_parameter, context_length_exceeded |
| 401 | authentication_error | invalid_api_key |
| 402 | quota_exceeded_error | monthly_quota_exceeded, spending_limit_reached |
| 403 | permission_error | forbidden, organization_suspended |
| 404 | not_found_error | model_not_found |
| 409 | conflict_error | key_limit_reached, project_archived |
| 422 | safety_error | safety_refused |
| 429 | rate_limit_error | rate_limited, too_many_streams |
| 502 / 504 | model_error | model_error, model_timeout, invalid_structured_output |
| 503 | service_unavailable_error | model_unavailable, billing_unavailable |
Wiederholungen
Versionierung
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.
01
Konto erstellen
Getestet wird auf Einladung: Fordere Testzugang an und registriere dich dann mit E-Mail und Passwort.
02
E-Mail bestätigen
Folge dem Link, den wir dir senden. Unbestätigte Konten haben keinen Zugriff auf die Konsole.
03
Organisation anlegen
Du wirst deren Inhaber. Zusammen mit ihr wird ein Default-Projekt angelegt.
04
API-Schlüssel erzeugen
Wähle Name, Scopes und optional ein Ablaufdatum. Der vollständige Schlüssel wird einmal angezeigt.
05
Erste Anfrage senden
Nutze den Schnellstart mit deinem Schlüssel.
06
Nutzung und Kosten einsehen
Tokens, Anfragen und geschätzte Kosten pro Projekt und Schlüssel.
Website-Assistenten
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 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.
<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.
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.
<script src="https://{widget-host}/widget/v1/{version}/agent.js"
integrity="sha384-…" crossorigin="anonymous"
data-agent="agt_…" async></script>Optionen
Server zu Server (erweiterte Einstellungen)
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.
Warnschwelle
Hartes Ausgabenlimit
Laufende Anfragen
Wenn die Nutzung nicht geprüft werden kann
API v1 · contract 0b847d90d1
PulseChat Business API
Implementiert, nicht freigeschaltetVerifizierte 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.
Ein Kunde beginnt in PulseChat eine Unterhaltung mit deinem Unternehmen. Dein System kann sie lesen und antworten. Dein Unternehmen kann solche Unterhaltungen nicht beginnen.
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.
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.
Geführte Einrichtung und Entwicklerdokumentation erscheinen, sobald PulseChat die API öffnet. Wenn du für den Pilotbetrieb in Frage kommen möchtest, melde dich.
Konto- und Serviceupdates sowie Antworten auf Support-Unterhaltungen, die deine Kunden beginnen.
Bestätigungen, Erinnerungen, Änderungen und Stornierungen.
Bestell- und Supportnachrichten zwischen einem Marktplatz und seinen eigenen Kunden, ohne Telefonnummern der Kunden weiterzugeben.
1Stop DataHub
GeplantEin 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.
Entwicklerdienste
Für Organisationen, die Werbung und kommerzielle 1StopTek-Dienste verwalten.
Zu 1StopTek Business →Für Entwickler, die 1StopTek-Technologie in Anwendungen und Dienste integrieren.
Die geplante technische Verwaltungsebene, die Anwendungen, Zugangsdaten, Berechtigungen, Nutzung und unterstützte Ökosystem-Dienste verbindet.
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.