Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Kaneme — 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fkaneme.com%2Fkaneme" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fkaneme.com%2Fkaneme" | sh
jentic register # connects your agent to your Jentic One instanceJentic 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.
What an agent can do with Kaneme — API.
Create a writing voice from at least 100 words of text with provenance set to human, then refine it through the voice interview
Generate a draft, outline, section, challenge, bar-test, or workflow in the user's voice for formats such as newsletter, linkedin_post, or blog
Improve an existing text so it reads in the user's voice
Measure authorship as a calibrated probability with question q1 (voice against AI) or q2 (voice against another human), abstaining on unsupported languages
GET STARTED
Score a text for style automatisms at no credit cost, in any language the engine supports
Teach the voice with accept, reject, or reject_reason signals such as trop_generique or trop_long
Issue and publish a public certificate for a document, and verify any certificate by its token without an account
Patterns agents use Kaneme — API for, with concrete tasks.
★ Drafting in Your Voice Through Jentic
A writer's AI agent drafts posts and newsletters that sound like the writer rather than a generic model. Through Jentic the agent finds Kaneme's generate operation by intent, passes the prompt, format, and the writer's profileId, and saves the result as a document, while the developer decides which Kaneme operations the agent may call and the API key stays on their own machine.
List voices to find the active profileId, estimate the cost of operation 'generate', then call POST /api/v1/generate with type 'draft', format 'linkedin_post', and save true
Authorship Checks on a Draft
Before publishing, an author wants to know whether a text still reads as theirs after heavy editing. Kaneme's verify operation returns a calibrated probability for the author's voice against AI with question q1, or against another human with q2, and returns probability null with a reason such as unsupported_language instead of guessing. An abstention is never charged.
Call POST /api/v1/verify with the draft text, question 'q1', and format 'blog', and report the probability or the unavailable reason
Account-Free Trial Measurement
A visitor without a Kaneme account wants a quick authorship reading. The verdict operation takes exactly three samples of the person's writing of at least 100 words each plus the text to attribute, and the observatory operation flags passages worth rereading, both without an account or credits.
Call POST /api/v1/verdict with three samples of at least 100 words, the text, and question 'human', then call POST /api/v1/observatory/signals on the same text
Certified Publication
A consultant wants readers to be able to check that an article carries their voice. The agent prepares a certificate for the document, the owner approves it, and the publish operation returns a page, JSON, and SVG badge. Anyone can later verify the certificate by token at no credit cost.
Call POST /api/v1/certificates/prepare with a documentId and displayName, and after owner approval call POST /api/v1/certificates/publish with the approvalId
48 endpoints — the kaneme api writes text in a person's own voice, learned from their real writing, and measures how faithfully a text matches that voice.
METHOD
PATH
DESCRIPTION
/api/v1/voices
Create a voice from real texts
/api/v1/generate
Write in the user's voice
/api/v1/improve
Improve an existing text in voice
/api/v1/verify
Measure calibrated authorship probability
/api/v1/score
Score style automatisms
/api/v1/estimate
Estimate an action's credit cost
/api/v1/documents
Create a document
/api/v1/certificate/{token}
Verify a public certificate
/api/v1/voices
Create a voice from real texts
/api/v1/generate
Write in the user's voice
/api/v1/improve
Improve an existing text in voice
/api/v1/verify
Measure calibrated authorship probability
/api/v1/score
Score style automatisms
/api/v1/estimate
Estimate an action's credit cost
/api/v1/documents
Create a document
/api/v1/certificate/{token}
Verify a public certificate
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Kaneme by hand means handling its kaneme_ bearer key and scopes, reading French-language operation docs, tracking credit costs and HTTP 402 stops, and passing Idempotency-Key headers on writes. Through Jentic you install once, import the Kaneme API from the API Directory, store the key once, and your agent calls it.
Permission scoping
Kaneme puts the document id in the URL path for reads, updates, and trash (/api/v1/documents/{id}), so a rule can pin your agent to one document, while voice operations carry profileId in the body or query, so for those rules bound which operations it may call. You choose those operations, so sensitive ones like publishing certificates or applying voice revisions are not included unless you add them.
Credential isolation
Your Kaneme API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'write a newsletter in my voice' or 'check if this text is mine', and Jentic returns the matching Kaneme operation with its input schema so the agent calls the right endpoint without reading the French reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Kaneme — API through Jentic.
What authentication does the Kaneme API use?
Per its OpenAPI spec, the Kaneme API uses bearer authentication with an account API key created on the Connexions page, sent as Authorization: Bearer kaneme_ followed by the key, and older frq_ keys are still accepted. Key scopes are chosen when the key is created. Three operations need no credential: certificate verification by token, the account-free verdict, and the observatory signals read. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time.
Is there a Kaneme MCP server?
Yes - Kaneme offers an official MCP server at /api/mcp. You can also connect Kaneme directly through Jentic: your agent gets the full 48-endpoint surface from the spec without loading another server's tool definitions into its context, your key is injected at call time by your self-hosted instance instead of living in an MCP config, and your rules decide which operations the agent may call.
Can I limit what my agent is allowed to do with the Kaneme API?
Yes. Write a rule that allows only the estimate, generate, and document create operations, so a drafting agent writes and saves posts but cannot publish certificates, decide voice revisions, or move documents to the trash. Every call it makes is logged, so you can review what it spent credits on.
Which languages does Kaneme's authorship verification support?
Per the spec, the authorship verdict is calibrated on French and English, each with its own engine, and the English q2 comparison against another human is a strict beta. On other languages verification abstains and returns probability null with unavailable set to unsupported_language, while the style score still runs in every supported language and reports markerLanguage.
How much does a Kaneme API call cost?
Each paid operation spends the same credits as the Kaneme app, and the API returns HTTP 402 when available credits run out. The style score costs nothing, abstentions are never charged, and GET /api/v1/estimate tells your agent what an action will cost before it runs.
What are the rate limits for the Kaneme API?
The OpenAPI spec does not state numeric rate limits. Responses carry X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Window headers so your agent can pace itself, and the spec documents a 429 response when calls exceed the limit. See https://kaneme.com for plan details.
How do I write a post in my voice with the Kaneme API through Jentic?
Search Jentic for an intent like 'write a post in my voice', import the Kaneme API from the API Directory, and store your API key. Your agent calls GET /api/v1/voices to pick the profileId, then POST /api/v1/generate with the prompt and a format such as newsletter, and can send POST /api/v1/signal with accept or reject so the voice learns. To run it on your own infrastructure, install Jentic One from its GitHub repo.
For Agents
Generate and improve text in a user's learned writing voice, score style automatisms, measure calibrated authorship probability in French or English, and organise the results as projects and documents with optional public certificates.
Use for: Write a LinkedIn post in my voice about our product launch, Improve this newsletter draft so it sounds like me, Check whether this text was written by me or by an AI, Estimate how many credits a generation will cost before I run it
Not supported: Does not publish to social networks, check grammar, or detect AI text without a reference voice or samples. Use for writing in a learned personal voice and measuring authorship against it only.
The Kaneme API writes text in a person's own voice, learned from their real writing, and measures how faithfully a text matches that voice. It builds a voice from at least 100 words of human-written text, refines it through an interview, accepted or rejected signals, and added references, then generates or improves drafts in that voice for formats such as newsletter, linkedin_post, blog, or email. A verify operation returns a calibrated authorship probability for French and English, comparing the voice against AI or against another human, and abstains with a coded reason rather than guessing on unsupported or mixed languages. Projects, documents, public certificates, and a restorable trash round out the surface, and every paid call spends the same credits as the Kaneme app.
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
Base layer of spec validity and structural soundness.
Aggregated quality score from linter diagnostics, weighted by severity.
Percentage of `$ref` references that resolve successfully.
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
Structural correctness score based on schema issues using logarithmic dampening.
Clarity, completeness, and ingestion readiness for developers and tooling.
How richly the API is illustrated with examples.
Percentage of examples that conform to their schemas.
Percentage of operations with complete response definitions (success, client error, server error).
Health of API ingestion, bundling, and resolution within Jentic pipelines.
Semantic breadth, depth, and agent comprehension for AI systems.
Coverage of descriptions across API elements.
Coverage of RFC 9457 Problem Details for error responses.
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
Coverage of summaries across operations/tags/info.
Functional utility, complexity comfort, and AI orchestration readiness.
Agent comfort level based on API operational and structural complexity.
Trust, risk posture, and security compliance.
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
Findability, semantic richness, and reasoning readiness.
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>