Hive Civilization Model Receipts API

The model-receipts API from Hive Civilization — 7 operation(s) for model-receipts.

Documentation GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/model-receipts/adapters List registered model adapters · Adapters #

Ask an LLM

“Which model providers and models can I get signed receipts for?”

“What environment variable does each model adapter expect?”

Tell an agent

List every registered model-receipt adapter.

Show the provider/model adapters and their env var names.

GET /v1/model-receipts/openrouter/models Search OpenRouter models available for receipts · Openrouter Models #

Ask an LLM

“Which OpenRouter models can I run through the receipt runner?”

“Can I search the OpenRouter model list by name and see which are prewired?”

Tell an agent

Search OpenRouter models matching {q}.

List the first {limit} OpenRouter models I can receipt.

GET /v1/model-receipts/leanstral-demo Run the Leanstral receipt demo · Leanstral Demo #

Ask an LLM

“Can I see a signed receipt for a Mistral Leanstral call on a Lean 4 prompt?”

“What does the Leanstral demo return when no Mistral key is configured?”

Tell an agent

Run the Leanstral 1.5 receipt demo.

Show me the default Lean 4 demo receipt.

POST /v1/model-receipts/run Run a model call and get a signed receipt · Run #

Ask an LLM

“How do I get a signed receipt for a call to a specific model?”

“What prompt is used if I do not send one to the receipt runner?”

Tell an agent

Run {model} on {provider} with prompt "{prompt}" and receipt it.

Receipt a call to {model} capped at {max_tokens} tokens, temperature {temperature}.

GET /v1/model-receipts/adapter-health Check live health of every model adapter · Adapter Health #

Ask an LLM

“Which model adapters are healthy and configured right now?”

“Is there a live health check across all receipt adapters?”

Tell an agent

Show live adapter health for model receipts.

Check which receipt adapters are currently working.

GET /v1/model-receipts/demo-matrix Get the per-model demo matrix · Demo Matrix #

Ask an LLM

“Where is the per-model demo matrix for model receipts?”

“Can I see a model-by-model demo grid of receipt support?”

Tell an agent

Get the model receipts demo matrix.

Show the per-model demo matrix view.

GET /v1/model-receipts/smartmorph-route-demo View the SmartMorph routing proof with built-in prompt · Smartmorph Route Demo Get #

Ask an LLM

“Can I quickly see a SmartMorph route decision using the built-in prompt?”

“Is there a simple GET to trigger the SmartMorphAgent route demo?”

Tell an agent

Run the SmartMorph route demo with the built-in prompt via GET.

Show a quick SmartMorph routing proof.

POST /v1/model-receipts/smartmorph-route-demo Run the SmartMorph live route comparison · Smartmorph Route Demo Post #

Ask an LLM

“How does SmartMorph compare live latency and token cost across models to pick a route?”

“Does the SmartMorph route proof sign a separate decision receipt?”

Tell an agent

Run the live SmartMorph route comparison and sign the decision receipt.

Compare Mistral and DeepInfra live and pick a route by the SmartMorph rules.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/thehiveryiq-com:thehiveryiq-com-model-receipts-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: HiveMorph v0.1 Model Receipts API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: model-receipts
paths:
  /v1/model-receipts/adapters:
    get:
      tags:
      - model-receipts
      summary: Adapters
      description: List every registered provider/model adapter (env var names only, no keys).
      operationId: adapters_v1_model_receipts_adapters_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Adapters V1 Model Receipts Adapters Get
  /v1/model-receipts/openrouter/models:
    get:
      tags:
      - model-receipts
      summary: Openrouter Models
      description: 'Every OpenRouter model that can be signed through /run.


        The six hand-wired rows carry a tuned display name and demo prompt. Every

        other slug in OpenRouter''s public catalogue resolves dynamically on first

        use, because OpenRouter serves its whole catalogue over one uniform

        OpenAI-compatible surface. ``prewired`` distinguishes the two. Nothing here

        asserts that a receipt has already been produced for a given slug.'
      operationId: openrouter_models_v1_model_receipts_openrouter_models_get
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
          description: Case-insensitive substring filter on slug or name.
          default: ''
          title: Q
        description: Case-insensitive substring filter on slug or name.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 2000
          minimum: 0
          description: 0 returns the whole catalogue.
          default: 0
          title: Limit
        description: 0 returns the whole catalogue.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/model-receipts/leanstral-demo:
    get:
      tags:
      - model-receipts
      summary: Leanstral Demo
      description: 'Default demo: receipt a Mistral Leanstral 1.5 call on a safe Lean 4 prompt.


        Returns setup_required=true (HTTP 200) with a signed preflight receipt if

        MISTRAL_API_KEY is not configured; otherwise runs the real call and receipts it.'
      operationId: leanstral_demo_v1_model_receipts_leanstral_demo_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/model-receipts/run:
    post:
      tags:
      - model-receipts
      summary: Run
      description: 'Universal runner: receipt a call to any registered provider/model.


        Omit ``prompt`` to use the built-in safe demo prompt.'
      operationId: run_v1_model_receipts_run_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RunRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/model-receipts/adapter-health:
    get:
      tags:
      - model-receipts
      summary: Adapter Health
      description: Live health/demo matrix across every registered adapter.
      operationId: adapter_health_v1_model_receipts_adapter_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/model-receipts/demo-matrix:
    get:
      tags:
      - model-receipts
      summary: Demo Matrix
      description: Alias of /adapter-health (richer per-model matrix name).
      operationId: demo_matrix_v1_model_receipts_demo_matrix_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/model-receipts/smartmorph-route-demo:
    get:
      tags:
      - model-receipts
      summary: Smartmorph Route Demo Get
      description: SmartMorphAgent route proof (GET convenience; uses the built-in prompt).
      operationId: smartmorph_route_demo_get_v1_model_receipts_smartmorph_route_demo_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    post:
      tags:
      - model-receipts
      summary: Smartmorph Route Demo Post
      description: 'SmartMorphAgent route proof.


        Runs live model calls for the registered+configured candidates (Mistral +

        DeepInfra), compares the ACTUAL observed signals (latency, visible-output

        availability, and provider-reported token cost when present — else labeled

        ''unknown''), selects a route by explicit rules, and signs a distinct morph

        decision receipt in addition to the per-stop model-call receipts.'
      operationId: smartmorph_route_demo_post_v1_model_receipts_smartmorph_route_demo_post
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - $ref: '#/components/schemas/RunRequest'
              - type: 'null'
              title: Req
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    RunRequest:
      properties:
        provider:
          type: string
          maxLength: 64
          title: Provider
          description: Adapter provider, e.g. 'mistral'.
          default: mistral
        model:
          type: string
          maxLength: 128
          title: Model
          description: Adapter model id, e.g. 'leanstral-1-5'.
          default: leanstral-1-5
        prompt:
          anyOf:
          - type: string
            maxLength: 8192
          - type: 'null'
          title: Prompt
          description: Prompt to send. Omit to use the built-in safe demo prompt.
        max_tokens:
          type: integer
          maximum: 4096.0
          minimum: 1.0
          title: Max Tokens
          default: 512
        temperature:
          type: number
          maximum: 2.0
          minimum: 0.0
          title: Temperature
          default: 0.2
      type: object
      title: RunRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
x-provenance:
  method: harvested
  publisher: Hive Civilization
  source: https://receipts.thehiveryiq.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)

Hive Civilization Model Receipts API

Operations 8

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification