:: Getting Started with the Maenen API Suite

HOME MEANINGSYSTEM
KEYS 🤖


: Get Started with Maenen APIs

This guide walks you from purchasing an API key to making your first verified call and inspecting its receipt.


For when maintaining meaning must remain traceable from origin → outcome

: Introduction

01  Create Your Account & Obtain an API Key

➤ Prepare for API access:

  1. Review the [ published pricing ] appropriate for your workload.
  2. Production member access, payment enrolment and browser key issuance are not yet operational.
  3. Use an API key only when one has been separately authorised and issued.
  4. Store your key securely. One key can cover MeaningSystem routes and supported direct Maenen APIs through the meaning_system wallet, subject to scopes, rate limits, balance and revocation. CompareThisThat remains separate.
  5. Inform your Agent of: [ agents.md ]

02  Make Your First Call (minimal examples)

➤ Pick one endpoint as a starter.
➤ Always use the full endpoint addresses.
➤ Click the endpoints to copy to clipboard.


➤ Recommended simple first test → Inception API:


POST https://api.maenen.ai/v1/ingress

A basic ParsAIble API compression call:

POST https://api.maenen.ai/v1/compression

➤ Try the [ Inception API receipt web demo ] for operational verification.


➤ Example using CURL:

You will receive:

  • A processed output
  • A deterministic receipt
  • A receipt hash
curl -X POST https://api.maenen.ai/v1/ingress \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "text=Hello world"

03  Inspect the Receipt

Each API family follows its documented evidence contract. A response may return inline evidence, a signed receipt, or a reference; where a receipt is returned it can include:

  • Endpoint used
  • Status
  • Timestamp
  • Usage cost
  • Integrity hash

➤ Always store receipts if you require:

  • Audit trails
  • Later inspection
  • Verification

Evidence allows a step to be reviewed and compared. A caller may make a new source request, but a receipt or capsule does not itself replay or restore the prior execution.

04 Compose Endpoints (for more advanced workflows)

Maenen APIs are designed to interoperate. For example:

➤ Send input to:

POST https://api.maenen.ai/v1/ingress

➤ Transform across model types via:

POST https://api.maenen.ai/v1/waveform_2/transform

➤ Compare outputs using:

POST https://api.maenen.ai/v1/meaning/compare

05 Monitor Usage & Manage Tiers

All API calls draw from your unified wallet balance:

  • One key and the meaning_system wallet cover MeaningSystem routes and supported direct Maenen APIs, subject to scopes, rate limits, balance and revocation. CompareThisThat uses a separate product and wallet.
  • The endpoint costs vary and are [ listed here ].

06 For Agents

Agent calls produce contract-defined deterministic evidence.

Agents can read, retain, evaluate and verify that evidence. Evidence does not replay the original computation.

Maenen APIs are infrastructure tools. Start simple, inspect receipts, and expand into composable workflows as needs grow.

: Modular API Pipeline (examples)

There are multiple API-integration use cases and AI pipeline configuration options.
— see suggested [ business recipes ] for ideas.


This≠That API  (?)  Inception API → WaveInform → AI → WaveReturn  └──▶  Third Party Tools  → → →
MeaningSystem.io
parsAIble Compression API → hAIper Retrieval API → WaveInform → X  → → →

: Design Principle

Meaning should survive processing — not require rediscovery downstream


: Support

For technical issues or questions, [ contact support ] via the site. Full support and service-level agreements are not offered during the beta trial, though your query or comment will be carefully considered. Please include:

  • A short description of the issue.
  • The receipt from the relevant request.
Receipts significantly reduce back-and-forth and speed up diagnosis.


: Beta Notes

Maenen Labs APIs are currently in limited beta.

  • Supported modes and limits may evolve.
  • No uptime or performance guarantees are implied.
  • Breaking changes will be communicated ahead of time where possible.

FOR-THE-DREAM-IS-WITH-INTEGRITY-FOR-THE-FREEDOM-OF-INTELLIGENCE