Für Entwickler

Eine Anfrage.
Ein Plan mit seinen Gründen.

Ihr Backend sendet Daten und eine versionierte Modell-ID. kint liefert den Plan, die Grenze, die ihn bindet, den Wert einer weiteren Einheit einer Ressource sowie Schranke und Optimalitätslücke des Solvers. Jeder Lauf wird festgeschrieben, so lässt sich der Plan gegen das Protokoll nachprüfen.

Der Endpunkt

POST /v1/runs

  1. EingabeDaten und eine Modell-IDInline oder als Verweis auf einen versionierten Upload.
  2. AusgabePlan, Grenze, Preis, Schranke, LückeDazu eine Protokoll-ID, die den Lauf festschreibt, damit er sich nachprüfen lässt.
Zusagen

Worauf Sie sich verlassen können.

Wiederholbar

Datenversion, Modellversion und Einstellungen werden je Lauf festgeschrieben.

Wiederholung: rec_…

Versionierte Modelle

Veröffentlichte Modelle sind unveränderlich. Sie legen eine Version fest und aktualisieren, wenn Sie es entscheiden.

model@7 → model@8

Typisierte Antworten

Dokumentierte Felder und typisierte Antworten. Status, Optimalitätslücke und bindende Nebenbedingungen stehen an festen Stellen.

Status · Lücke · bindend

Asynchron bei langen Läufen

Große Läufe liefern eine Job-ID, die Sie abfragen können. Kurze Läufe antworten direkt.

202 → Job-ID
Beispiel

Anfrage rein. Plan raus.

Eine Schichtplanung für ein Containerterminal. Das Modell wurde einmal gebaut und geprüft. Jede Nacht ruft das Backend es mit frischen Daten auf.

  • ModellAuf eine Version festgelegt. Eine neue Version ändert nie alte Ergebnisse.
  • DatenInline oder als Verweis auf einen versionierten Upload.
  • bindendDie Grenzen, die das Ergebnis bestimmen, mit ihren Schattenpreisen.
  • Schranke · LückeDie Schranke des Solvers und der Abstand dazu. Bei 0,0 % gibt es für das Modell, wie es formuliert ist, im Rahmen der Solver-Toleranz keinen besseren Plan.
  • ProtokollEine ID, die Datenversion, Modellversion und Einstellungen des Laufs festschreibt.
POST https://api.kint.pro/v1/runsAnfrage
{  "model": "terminal-shifts@7",  "data": "upload:2027-03-02T18:00",  "scenario": { "cranes_out": ["QC-04"] },  "objective": "min_equipment",  "time_limit_s": 60}
200 application/jsonAntwort
{  "status": "optimal",  "gap": 0.0,  "plan": { "shifts": [ … ] },  "binding": [    { "limit": "berth_window.vessel_B", "shadow_price": … }  ],  "bound": …,  "record": "rec_…",  "pinned": ["data", "model", "solver", "settings"]}

Beispielhaft. Feldnamen und Pfade sind Beispiele, die vollständige Referenzdokumentation erhalten Sie mit dem Zugang.

Oberfläche

Klein, mit Absicht.

Wenige Ressourcen decken Daten, Modelle, Läufe, Szenarien und das Protokoll ab.

API-Endpunkte
MethodePfadZweck
POST/v1/uploadsDaten senden. Jeder Upload wird zu einer Version.
GET/v1/models/{id}Eine Modellversion und ihre Regeln lesen.
POST/v1/runsMit einer Modellversion und Daten lösen.
POST/v1/scenariosWas-wäre-wenn-Varianten zum Vergleich ausführen.
GET/v1/runs/{id}Plan, bindende Nebenbedingungen, Sensitivität, Schranke und Optimalitätslücke.
GET/v1/records/{id}Wer was mit welchen Versionen freigegeben hat.

Beispielhafte Pfade auf api.kint.pro.

Lebenszyklus

Vom Schlüssel bis zur Produktion.

Vier Schritte, und bei jedem sind die Forward Deployed Engineers von kint ansprechbar.

01

Zugang

Ein API-Schlüssel und die Referenzdokumentation.

02

Modell

Ihr Fachexperte und der Decision Agent von kint bauen das Modell. Die Forward Deployed Engineers (FDEs) von kint, die direkt mit den Teams der Kunden arbeiten, prüfen es mit dem Experten. Dann veröffentlichen sie es als Version.

03

Integration

Das Backend ruft Läufe auf und stellt die Pläne dar. Die FDEs von kint beantworten Fragen der Entwickler direkt.

04

Betrieb

Produktionsmandant, gehostet in Deutschland oder nach Absprache als Installation in Ihrer Infrastruktur. Freigaben und Protokolle inklusive.

Sicherheit
  • Transport
    Verschlüsselt bei der Übertragung (TLS 1.2 oder höher) und im Ruhezustand (AES-256). API-Schlüssel werden je Mandant ausgegeben.
  • Daten
    Ein Auftragsverarbeitungsvertrag nach Art. 28 DSGVO für jeden Auftrag, der personenbezogene Daten berührt. Die Daten werden nicht mit anderen Kunden geteilt, und kint trainiert damit keine Modelle für andere Organisationen.
  • Zugriff
    Rollen und Freigaben. Uploads, Modelländerungen, Läufe und Freigaben werden mit Akteur und Zeitpunkt festgehalten.
  • Dokumentation
    Entwürfe der Dokumentation nach EU AI Act, aktuell gehalten aus dem laufenden System, zur Prüfung durch Ihr Compliance-Team.

Ihr Backend. Unsere Mathematik.

Ein technischer Durchgang mit den FDEs von kint zu Ihrem Problemtyp. Bringen Sie die schwierigen Fragen mit.

Formate
REST, JSON, Job-IDs für lange Läufe
Einbettung in ein Produkt
OEM-Partnerschaft
Preise
wie Engagements aufgebaut sind
Kontakt
hello@kint.pro