Hive Civilization · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Thehiveryiq Com Qvac API

12 actions 12 updates phrasing extends openapi/thehiveryiq-com-qvac-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Hive Civilization's API. It is a proposal applied on top of the contract, not a document Hive Civilization publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 12

$.info
$.paths['/v1/qvac/provider/register'].post
$.paths['/v1/qvac/provider/list'].get
$.paths['/v1/qvac/provider/{provider_id}'].get
$.paths['/v1/qvac/provider/{provider_id}/unregister'].post
$.paths['/v1/qvac/inference/request'].post
$.paths['/v1/qvac/inference/request/public'].post
$.paths['/v1/qvac/leaderboard'].get
$.paths['/v1/qvac/agent_c/spread'].get
$.paths['/v1/qvac/models'].get
$.paths['/v1/qvac/stats'].get
$.paths['/v1/qvac/economics'].get

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Qvac API
  version: 1.0.0
extends: openapi/thehiveryiq-com-qvac-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 11
- target: $.paths['/v1/qvac/provider/register'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a QVAC inference provider
      effect: write
      questions:
      - How do I register my agent as a QVAC inference provider?
      - Can I set a payout address when registering as a QVAC provider?
      instructions:
      - text: Register {agent_name} as a QVAC provider serving models {models} with capabilities {capabilities}.
        slots:
          agent_name: requestBody.agent_name
          models: requestBody.models
          capabilities: requestBody.capabilities
      - text: Register QVAC provider {agent_name} with models {models}, capabilities {capabilities}, paying out to {payout_address}.
        slots:
          agent_name: requestBody.agent_name
          models: requestBody.models
          capabilities: requestBody.capabilities
          payout_address: requestBody.payout_address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/qvac/provider/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List QVAC inference providers
      effect: read
      questions:
      - Which QVAC inference providers are registered?
      - Can I see only the providers that cleared the three-gate check?
      instructions:
      - text: List the QVAC providers.
      - text: List QVAC providers with listed_only set to {listed_only}.
        slots:
          listed_only: query.listed_only
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/qvac/provider/{provider_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a QVAC provider
      effect: read
      questions:
      - What models and capabilities does a specific QVAC provider offer?
      - How do I look up one QVAC provider by id?
      instructions:
      - text: Get QVAC provider {provider_id}.
        slots:
          provider_id: path.provider_id
      - text: Show the details of QVAC provider {provider_id}.
        slots:
          provider_id: path.provider_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/qvac/provider/{provider_id}/unregister'].post
  update:
    x-apievangelist-phrasing:
      intent: Unregister a QVAC provider
      effect: destructive
      questions:
      - How do I take my agent out of the QVAC provider pool?
      - Can I unregister a QVAC provider I no longer run?
      instructions:
      - text: Unregister QVAC provider {provider_id}.
        slots:
          provider_id: path.provider_id
      - text: Remove provider {provider_id} from QVAC.
        slots:
          provider_id: path.provider_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/qvac/inference/request'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a QVAC inference
      effect: write
      questions:
      - How do I run a prompt against a QVAC model?
      - Can I pick which provider serves my QVAC inference or let it auto-pick?
      - Which settlement assets can I pay for a QVAC inference in?
      instructions:
      - text: Run {prompt} on QVAC model {model}.
        slots:
          prompt: requestBody.prompt
          model: requestBody.model
      - text: Send {prompt} to model {model} on provider {provider_id}, settling in {asset}.
        slots:
          prompt: requestBody.prompt
          model: requestBody.model
          provider_id: requestBody.provider_id
          asset: requestBody.asset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/qvac/inference/request/public'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a QVAC inference paid by x402
      effect: write
      questions:
      - Can I pay for a QVAC inference with an x402 payment instead of an account?
      - What happens if I call the public QVAC inference endpoint without an X-Payment header?
      instructions:
      - text: Run {prompt} on QVAC model {model} through the public x402-paid endpoint.
        slots:
          prompt: requestBody.prompt
          model: requestBody.model
      - text: Pay per call with x402 and run {prompt} on {model}, settling in {asset}.
        slots:
          prompt: requestBody.prompt
          model: requestBody.model
          asset: requestBody.asset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/qvac/leaderboard'].get
  update:
    x-apievangelist-phrasing:
      intent: View the QVAC provider leaderboard
      effect: read
      questions:
      - Which QVAC inference providers rank highest?
      - Can I limit the QVAC provider leaderboard to the top few?
      instructions:
      - text: Show the QVAC provider leaderboard.
      - text: Show the top {top_n} QVAC inference providers.
        slots:
          top_n: query.top_n
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/qvac/agent_c/spread'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Agent C's QVAC spread quote
      effect: read
      questions:
      - What spread would Agent C capture on a QVAC inference at a given notional?
      - Can I compute the Agent C spread using only listed providers?
      instructions:
      - text: Show Agent C's spread on {notional_usd} USD notional.
        slots:
          notional_usd: query.notional_usd
      - text: Get the Agent C spread for {notional_usd} USD with listed_only {listed_only}.
        slots:
          notional_usd: query.notional_usd
          listed_only: query.listed_only
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/qvac/models'].get
  update:
    x-apievangelist-phrasing:
      intent: List QVAC models
      effect: read
      questions:
      - Which QVAC model IDs can I request inference from?
      - What models are in the QVAC catalog?
      instructions:
      - text: List the QVAC model catalog.
      - text: Show me every QVAC model ID available.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/qvac/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get QVAC marketplace stats
      effect: read
      questions:
      - How many providers and inferences does the QVAC marketplace have?
      - What are the current QVAC usage statistics?
      instructions:
      - text: Show QVAC marketplace stats.
      - text: Report QVAC inference volume statistics.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/qvac/economics'].get
  update:
    x-apievangelist-phrasing:
      intent: View QVAC spread economics and projections
      effect: read
      questions:
      - How much has the 3% HiveCompute spread earned on QVAC inference?
      - What would QVAC revenue look like at higher inference volumes?
      instructions:
      - text: Show QVAC economics.
      - text: Project QVAC spread revenue across inference volumes.
      method: generated
      generated: '2026-09-26'