Skip to main content

POST /api/zeq/acoustic

Helmholtz acoustics — -p'' = k^2 p, open/closed ends (finite-volume + half-cell mass, Sturm bisection).

MethodPOST
Path/api/zeq/acoustic
Feature areaZeq core & solvers
TagSolvers
Authmachine key — Authorization: Bearer $ZEQ_KEY
Tierauthenticated (machine-control)

Solver

SummaryHelmholtz acoustics — -p'' = k^2 p, open/closed ends (finite-volume + half-cell mass, Sturm bisection).
DomainAcoustics
Numerical MethodFV Helmholtz eigensolver
Operator ChainKO42, WM1
UnitHz

See all sealed solvers.

Parameters

This operation publishes no path, query or header parameters.

Request body

Required. Content type: application/json.

FieldTypeRequiredDescription
operatorsarray<string>noOperator IDs to run. KO42 sets the metric frame, e.g. ["KO42","GR37","NM19"].
inputsobject<string, number>noNamed numeric inputs the operators consume (mass, r, v, ...).
constsobject<string, number>noOptional constant overrides (t, alpha, f_H, ...).
domainstringnoOptional domain hint (used by /compute and /auto).
querystringnoNatural-language problem statement (used by /auto).

Responses

StatusMeaning
200Sealed result envelope — value, unit, operatorChain, masterEquation, HMAC zeqProof.
401Missing or invalid credentials
402Insufficient compute credit

401 body

FieldTypeRequiredDescription
okboolean — one of falseyes
errorstringnoHuman-readable message.
codestringnoStable machine-readable code, e.g. ADMIN_REQUIRED, INVALID_ZID, ZID_NOT_LINKED.

Call it

curl -sS -X POST https://zeq.me/api/zeq/acoustic \
-H "Authorization: Bearer $ZEQ_KEY" \
-H "Content-Type: application/json" \
-d '{
"operators": [
"KO42"
],
"inputs": {
"mass": 70,
"r": 1
},
"consts": {
"t": 1
},
"domain": "Acoustics",
"query": "speed of sound in air at 20 C"
}'

Needs a machine key. Mint one: curl -sS -X POST https://zeq.me/api/demo-key/mint, then spin up your machine.


Generated from the live OpenAPI description (https://zeq.me/openapi.json, spec version 1.287.0) by scripts/generate-reference.mjs. Do not edit — this file is rewritten on every run.