Skip to main content
Für Entwickler:innen, die einen Coworker in ein internes Tool einbetten oder einen Workflow automatisieren wollen, gibt die Completions API dir programmatischen Zugriff — neben E-Mail, WhatsApp und Sokosumi.
Diese Seite richtet sich an ein technisches Publikum. Wenn du einfach mit einem Coworker sprechen willst, siehe stattdessen E-Mail.

Completions API

Die Completions API ist OpenAI-kompatibel — wenn deine Tools schon das Format /v1/chat/completions sprechen, ist die Umstellung auf einen Coworker eine Änderung in einer Zeile.
Welchen Coworker du erreichst, bestimmt die Subdomain — hannah.sumike.ai, alex.sumike.ai, elena.sumike.ai. Maya und Jamal haben diese Schnittstelle nicht — sie sind nur über Sokosumi erreichbar.

Authentifizierung

1

Einen API-Key erzeugen

Frag deinen Serviceplan-Agents-Kontakt nach Zugang, und erzeuge dann selbst einen Key — Keys sehen aus wie sk-sumike-.... Du kannst deine eigenen Keys auflisten, erzeugen oder widerrufen; bis zu 5 gleichzeitig.
2

Als Bearer-Token mitschicken

Authorization: Bearer sk-sumike-... bei jeder Anfrage, genau wie oben gezeigt.
3

Das Rate-Limit beachten

Standard sind 60 Anfragen pro Minute. Melde dich, wenn deine Integration mehr braucht.

Unterhaltungen bleiben automatisch erhalten

Aufrufe mit demselben API-Key behalten eine durchgängige Session — schickst du eine Folgenachricht, hat der Coworker die vorherigen Turns bereits im Kontext, genau wie ein menschlicher Kollege in einem laufenden Chat. Du musst auf deiner Seite keine Session-ID verwalten.
Ist dein API-Key mit einem Kontakt-Datensatz verknüpft, hat ein über die API angesprochener Coworker Zugriff auf dasselbe Memory und dieselben Delegationsfähigkeiten wie überall sonst — es ist keine abgespeckte Version des Coworkers.

Responses API

Es gibt eine zweite Oberfläche, die Responses API, die manche Teile der Plattform (wie Sokosumi) intern für länger laufende, asynchrone Arbeit nutzen. Sie ist kein eigenes Produkt, mit dem du dich direkt verbindest — baust du deine eigene Integration, ist die Completions API oben die richtige Wahl.

Wofür die API nicht gedacht ist

Die API gibt dir denselben Coworker, nicht eine schnellere oder abgespeckte Version — eine Recherche-Anfrage braucht über die API genauso lange wie über E-Mail. Das ist eine Entwickler-Oberfläche; willst du selbst einfach mit einem Coworker sprechen, nutze stattdessen E-Mail, WhatsApp oder Sokosumi.

So hängt das zusammen

Eine über die API ausgelöste Anfrage wird genau wie jede andere Aufgabe abgerechnet und nachverfolgt — siehe Guthaben & Abrechnung — und taucht in Files oder Builds genauso auf wie eine per E-Mail gestellte Anfrage. Brauchst du ein höheres Rate-Limit als 60 Anfragen/Min. oder mehr als 5 aktive Keys? Wende dich an deinen Serviceplan-Agents-Kontakt.
Alles, was ein Coworker per E-Mail oder Chat kann — Recherche, Dashboards, Koordination — steht genauso über die Completions API zur Verfügung.