MayoFlux Preflight API

x402-paid 3D asset preflight analysis for animation, rendering, and agentic production pipelines. Submit a remote GLB, glTF, or OBJ URL and receive geometry, material, texture, file-size, and pipeline-risk diagnostics before the asset enters production.

Price
$0.05 per paid call

Paid endpoint
POST /v1/assets/preflight

Network
eip155:84532

Formats
GLB, glTF, OBJ. FBX is not parsed in MVP.

Example Request

curl -i -X POST https://preflight.mayoflux.tv/v1/assets/preflight \
  -H "Content-Type: application/json" \
  -d '{"assetUrl":"https://example.com/model.glb","format":"auto","options":{"strict":true,"includeTextureProbe":true}}'

Unpaid requests return 402 Payment Required. The server does not download or analyze the asset until x402 verification succeeds.

Public Endpoints

Endpoint	Purpose
`GET /health`	Status, version, uptime, and environment without secrets.
`GET /openapi.json`	OpenAPI 3.1 schema.
`GET /.well-known/x402`	x402 discovery manifest for agent and x402scan-style discovery.
`GET /llms.txt`	AI-readable endpoint summary.
`POST /v1/assets/preflight/quote`	Free URL and format validation with bounded optional HEAD validation.

Example Response Shape

{
  "requestId": "uuid",
  "input": {"assetHost": "example.com", "assetUrlSha256": "hash", "formatDetected": "glb"},
  "geometry": {"meshCount": 4, "vertexCount": 12000, "triangleCount": 24000},
  "materials": {"materialCount": 5, "textureCount": 8, "usesTransparency": true},
  "pipeline": {"estimatedComplexity": "medium", "readinessScore": 82},
  "warnings": []
}

Security and Privacy Notes

Asset URLs must be HTTPS by default. Loopback, private, link-local, metadata, multicast, reserved, and unsafe DNS resolutions are blocked. Redirects are revalidated. Full submitted asset URLs are not logged or stored by default; responses include only host and SHA-256 URL hash.

Contact: hello@mayoflux.tv