Nyckel Classification API

Name: Nyckel Classification API
Brand: Nyckel Classification API
Availability: InStock

✓ Official Vendor SpecAI/MLMl Inferencebearer25 EndpointsREST

For Agents

Create classification functions, manage labels and training samples, and invoke trained models for text, image, and tabular classification with bearer authentication.

Install Jentic One Beta

Connect the Nyckel Classification API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Nyckel Classification API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Nyckel Classification API.

List and inspect existing classification functions in your Nyckel workspace

Define classification labels and structured fields for a function

Upload labelled training samples to teach a classification function

GET STARTED

Start building with Nyckel Classification API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Nyckel Classification API for, with concrete tasks.

★ Content Moderation Pipeline

Build an image or text moderation step into a user-generated-content pipeline by training a Nyckel function on labelled examples and invoking it on every upload. The training-and-inference loop runs entirely through the API, so a developer can iterate on the labelset without leaving the codebase. Time to a live classifier is typically under a day from a labelled dataset of a few hundred examples.

POST a labelled training sample to /v1/functions/{functionId}/samples for each image, then call POST /v1/functions/{functionId}/invoke with new uploads to score them.

Support Ticket Triage

Auto-route inbound support tickets by training a text classifier on past tickets labelled with their handling team. Once trained, the function is invoked on each new ticket to predict the routing label, which can be written back to a CRM or helpdesk. Nyckel's managed model selection means there is no separate training infrastructure to operate.

Invoke /v1/functions/{functionId}/invoke with the ticket subject and body, then patch the ticket in the helpdesk with the predicted routing label.

Tabular Lead Scoring

Score inbound leads by training a tabular classification function with fields such as company size, industry, and channel, mapped to historic outcomes. The fields endpoints let you define the input schema, and the invoke endpoint returns the predicted label with a confidence score. This works well as an alternative to bespoke ML services for teams without a data-science function.

POST /v1/functions/{functionId}/fields to define the lead schema, then POST /v1/functions/{functionId}/invoke with a new lead's fields and read the predicted label.

Agent-Driven Classification

Let an AI agent decide which Nyckel function to invoke for an incoming item — for example sending images to a moderation function and text to a sentiment function — by listing the available functions and routing accordingly. Through Jentic, the agent searches by intent and gets only the operations it needs, with credentials handled by the platform.

Search Jentic for 'invoke a Nyckel classification function', load the operation, and call the correct function id for the incoming item.

Key Endpoints

25 endpoints — the nyckel api powers a no-code machine-learning classification platform that supports text, image, and tabular inputs.

METHOD

PATH

DESCRIPTION

POST

/connect/token

Exchange client credentials for an access token

GET

/v1/functions

List classification functions

GET

/v1/functions/{functionId}

Get a function by ID

POST

/v1/functions/{functionId}/invoke

Invoke a classification function

POST

/v1/functions/{functionId}/fields

Create a field for a function

POST

/connect/token

Exchange client credentials for an access token

GET

/v1/functions

List classification functions

GET

/v1/functions/{functionId}

Get a function by ID

POST

/v1/functions/{functionId}/invoke

Invoke a classification function

POST

/v1/functions/{functionId}/fields

Create a field for a function

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Nyckel client ids and secrets are stored encrypted in the Jentic vault. Agents receive scoped access tokens — the raw secret never enters the agent's context, and Jentic handles the /connect/token exchange.

Intent-based discovery

Agents search Jentic with phrases like 'invoke a Nyckel classifier' or 'create a Nyckel training sample'. Jentic returns the matching operation and its input schema so the agent can call the correct endpoint without browsing the OpenAPI spec.

Time to first call

Direct integration: 1-2 days for token exchange, function setup, and inference plumbing. Through Jentic: under an hour — search, load, execute.

FAQs

Specific to using Nyckel Classification API through Jentic.

What authentication does the Nyckel API use?

The API uses bearer tokens issued via the OAuth2 client-credentials flow at POST /connect/token. You exchange a client id and client secret for a short-lived access token, then send it in the Authorization header. Through Jentic, the client id and secret are stored encrypted in the vault and the token exchange is handled automatically.

Can I train a classifier through the API?

Yes — create a function, define its labels (and fields for tabular use cases), then post labelled training samples to /v1/functions/{functionId}/samples. Nyckel manages model selection and retraining once samples are uploaded.

What are the rate limits for the Nyckel API?

The OpenAPI spec does not embed explicit limits. Nyckel's published policy throttles per-account based on plan; back off on HTTP 429 and consider batching invocations where the integration permits.

How do I invoke a classifier through Jentic?

Run pip install jentic, then search for 'invoke a Nyckel classification function'. Jentic returns POST /v1/functions/{functionId}/invoke with its input schema; supply the function id and input data and execute. Sign up at https://app.jentic.com/sign-up to get an agent key.

Does Nyckel support image inputs?

Yes — classification functions support text, image, and tabular inputs depending on how the function is configured. The same /v1/functions/{functionId}/invoke endpoint handles all three modalities, with the request body adapted to the input type.

Nyckel Classification API

Connect the Nyckel Classification API to your agent

Capabilities

Start building with Nyckel Classification API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs