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.
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
# 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'