{"openapi":"3.1.0","info":{"title":"Xyntherium API","version":"1.0.0","description":"Verify any question across six leading AI models and receive a single synthesized, attributed answer with confidence scoring and divergence detection."},"servers":[{"url":"https://xyntherium.com"}],"security":[{"bearerAuth":[]}],"paths":{"/v1/verify":{"post":{"summary":"Run a multi-AI verification","operationId":"verify","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequest"},"example":{"prompt":"What is the speed of light in a vacuum?"}}}},"responses":{"200":{"description":"Deliberation receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResponse"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/v1/verify/image":{"post":{"summary":"Verify a prompt about an image across the vision panel","description":"Runs Claude, GPT-4.1, Grok, and Gemini against the image (non-vision providers are rejected). Provide image_url or image_base64.","operationId":"verifyImage","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyImageRequest"},"examples":{"url":{"summary":"Public image URL","value":{"prompt":"What is shown in this chart?","image_url":"https://example.com/chart.png"}},"base64":{"summary":"Inline base64","value":{"prompt":"What is wrong with this food label?","image_base64":{"mime_type":"image/jpeg","data":"<base64 string>"}}}}}}},"responses":{"200":{"description":"Deliberation receipt (3-of-4 or 4-of-4 vision providers)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResponse"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"502":{"$ref":"#/components/responses/Error"}}}},"/v1/usage":{"get":{"summary":"Usage for the calling key in the current billing period","operationId":"getUsage","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Usage summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Usage"}}}},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"}}}},"/v1/health":{"get":{"summary":"Provider availability snapshot (no auth)","operationId":"getHealth","security":[],"responses":{"200":{"description":"All providers available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}},"503":{"description":"One or more providers degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your API key: `Authorization: Bearer xyn_live_…`"}},"responses":{"Error":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"VerifyRequest":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":4000},"providers":{"type":"array","items":{"type":"string","enum":["anthropic","openai","xai","perplexity","google","deepseek"]},"description":"Optional subset of providers (min 3). Defaults to the full active panel."}}},"VerifyImageRequest":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":4000},"image_url":{"type":"string","format":"uri","description":"Publicly reachable image (jpeg/png/webp/gif, ≤20MB)."},"image_base64":{"type":"object","required":["mime_type","data"],"properties":{"mime_type":{"type":"string","enum":["image/jpeg","image/png","image/webp","image/gif"]},"data":{"type":"string","description":"base64-encoded image bytes"}}},"providers":{"type":"array","items":{"type":"string","enum":["anthropic","openai","xai","google"]},"description":"Optional subset of vision providers. Non-vision ids are rejected."}},"description":"Exactly one of image_url or image_base64 is required."},"VerifyResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"receipt":{"type":["object","null"],"properties":{"slug":{"type":"string"},"url":{"type":"string","format":"uri"}}},"prompt":{"type":"string"},"tier":{"type":"string","enum":["free","connect","master"]},"synthesized_answer":{"type":"string"},"confidence_band":{"type":"string","enum":["low","medium","high"]},"consensus_score":{"type":"number"},"attribution":{"$ref":"#/components/schemas/Attribution"},"divergence":{"type":"object"},"consensus_claims":{"type":"array","items":{"type":"object"}},"per_model_stats":{"type":"array","items":{"type":"object"}},"providers":{"type":"array","items":{"$ref":"#/components/schemas/ProviderSummary"}},"meta":{"type":"object"}}},"Attribution":{"type":"object","properties":{"spans":{"type":"array","items":{"type":"object","properties":{"start":{"type":"integer"},"end":{"type":"integer"},"text":{"type":"string"},"attribution_type":{"type":"string","enum":["provider_consensus","provider_specific","synthesizer_inference"]},"supporting_providers":{"type":"array","items":{"type":"string"}}}}}}},"ProviderSummary":{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"latency_ms":{"type":["integer","null"]},"cost_cents":{"type":["number","null"]},"responded":{"type":"boolean"},"contributed":{"type":"boolean"},"exclusion_reason":{"type":["string","null"],"enum":["truncated","no_claims","error","timeout",null]},"error":{"type":["string","null"]},"response_text":{"type":["string","null"]}}},"Usage":{"type":"object","properties":{"key_id":{"type":"string","format":"uuid"},"tier":{"type":"string"},"period":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"}}},"queries_completed":{"type":"integer"},"queries_failed":{"type":"integer"},"cost_cents":{"type":"number"},"rate_limit_per_minute":{"type":"integer"}}},"Health":{"type":"object","properties":{"status":{"type":"string","enum":["ok","degraded"]},"providers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"available":{"type":"boolean"}}}},"timestamp":{"type":"string","format":"date-time"}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}