{"openapi":"3.1.0","info":{"title":"PQS: Prompt Quality Score","version":"2.0.0","description":"Pre-flight prompt quality gate. Score any prompt 0–80 across 8 dimensions before inference. x402-native on Base.","contact":{"name":"PQS","email":"ken@promptqualityscore.com","url":"https://promptqualityscore.com"},"x-guidance":"POST a prompt to /api/score/free for a free basic score, /api/score for a paid detailed score ($0.025 USDC), /api/score/full for optimized prompt + before/after outputs ($0.125 USDC). Anonymous x402 payment on Base mainnet is the default; bearer PQS_... API keys accepted for subscribed customers."},"servers":[{"url":"https://promptqualityscore.com"}],"x-discovery":{"ownershipProofs":[]},"tags":[{"name":"free","description":"Free, rate-limited endpoints"},{"name":"paid","description":"x402-paid endpoints (dual-mode: bearer API key also accepted)"},{"name":"evm","description":"Base mainnet (USDC)"},{"name":"solana","description":"Solana mainnet (USDC)"},{"name":"score","description":"Basic prompt score tier"},{"name":"full","description":"Full analysis tier with optimized prompt + outputs"},{"name":"batch","description":"Batch up to 10 prompts per call"},{"name":"compare","description":"Cross-model judgment tier"},{"name":"preflight","description":"Combined prompt + endpoint trust check"},{"name":"variants","description":"Ranked prompt rewrites scored on the 8-dimension rubric"},{"name":"fix_injection","description":"Prompt-injection detection + sanitization"},{"name":"grade","description":"Quick pre-flight grade: composite + framework sub-scores + verdict ($0.001 USDC)"},{"name":"venice_proxy","description":"PQS preflight score bundled with a Venice.ai chat completion ($0.05 USDC)"}],"components":{"securitySchemes":{"bearerAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Bearer API key - header value is `Bearer PQS_xxx`. Obtain at https://promptqualityscore.com/api-key"},"x402":{"type":"apiKey","in":"header","name":"X-PAYMENT","description":"x402 payment header. Clients receive a 402 challenge; pay via a wallet or x402-client and retry with X-PAYMENT."}}},"paths":{"/api/score/free":{"post":{"operationId":"scoreFree","summary":"Free basic PQS score","description":"Rate-limited free teaser. Flat score total + grade. No 8-dimension breakdown. That's the paid /api/score endpoint. No auth required.","tags":["free"],"security":[],"x-payment-info":{"authMode":"none","price":{"mode":"fixed","currency":"USD","amount":"0"},"rateLimit":"per-ip"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to score"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"}}},"example":{"prompt":"Explain PQS scoring in one sentence to an AI agent operator.","vertical":"general"}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","score"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"prompt":{"type":"string"},"vertical":{"type":"string"},"score":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"upgrade":{"type":"string"},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/score":{"post":{"operationId":"score","summary":"Score a prompt ($0.025 USDC)","description":"Basic PQS prompt score (8 dimensions, grade, top fixes)","tags":["score","paid","evm"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to score"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","score"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"prompt":{"type":"string"},"vertical":{"type":"string"},"score":{"type":"object","properties":{"total":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"percentile":{"type":"integer"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}}}},"top_fixes":{"type":"array","items":{"type":"string"},"minItems":3,"maxItems":3},"upgrade":{"type":"string"},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.025","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.025"},"protocols":[{"x402":{"chain":"base","chainId":8453,"asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xB40a687ca5483Ebc02F870348f6e08971Cae1308"}}]}}},"/api/score/full":{"post":{"operationId":"scoreFull","summary":"Full PQS analysis ($0.125 USDC)","description":"Full PQS analysis: optimized prompt + before/after scoring + both outputs","tags":["full","paid","evm"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to score"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","original","optimized"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"original":{"type":"object","properties":{"prompt":{"type":"string"},"score":{"type":"object","properties":{"total":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"percentile":{"type":"integer"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}}}},"output":{"type":"string"}}},"optimized":{"type":"object","properties":{"prompt":{"type":"string"},"score":{"type":"object","properties":{"total":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"percentile":{"type":"integer"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}}}},"output":{"type":"string"}}},"improvement_pct":{"type":"integer"},"explanation":{"type":"string"},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.125","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.125"},"protocols":[{"x402":{"chain":"base","chainId":8453,"asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xB40a687ca5483Ebc02F870348f6e08971Cae1308"}}]}}},"/api/score/batch":{"post":{"operationId":"scoreBatch","summary":"Batch PQS scoring, up to 10 prompts ($0.25 USDC)","description":"Batch PQS scoring. Score up to 10 prompts in a single call.","tags":["batch","paid","evm"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompts"],"properties":{"prompts":{"type":"array","minItems":1,"maxItems":10,"items":{"oneOf":[{"type":"string","minLength":1,"maxLength":10000},{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"]}}}]}}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","results","summary"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"batch_size":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"prompt":{"type":"string"},"vertical":{"type":"string"},"score":{"type":"integer"},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}},"top_fixes":{"type":"array","items":{"type":"string"}},"error":{"type":"string","description":"present instead of score fields if this row failed"}}}},"summary":{"type":"object","properties":{"total_scored":{"type":"integer"},"avg_score":{"type":"number"},"avg_out_of":{"type":"integer","enum":[80]},"lowest_grade":{"type":"string"},"highest_score":{"type":"integer"},"lowest_score":{"type":"integer"}}},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.25","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{"chain":"base","chainId":8453,"asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xB40a687ca5483Ebc02F870348f6e08971Cae1308"}}]}}},"/api/score/compare":{"post":{"operationId":"scoreCompare","summary":"Cross-model PQS comparison, Claude vs GPT-4o ($1.25 USDC)","description":"Cross-model scoring: Claude Sonnet 4 vs GPT-4o, judged by a third model","tags":["compare","paid","evm"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to score"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","results","winner","verdict"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"original_prompt":{"type":"string"},"optimized_prompt":{"type":"string"},"vertical":{"type":"string"},"results":{"type":"object","properties":{"claude":{"type":"object","properties":{"model":{"type":"string"},"output":{"type":"string"},"scores":{"type":"object","properties":{"completeness":{"type":"integer","minimum":1,"maximum":10},"relevancy":{"type":"integer","minimum":1,"maximum":10},"reasoning_depth":{"type":"integer","minimum":1,"maximum":10},"faithfulness":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer"}}}}},"gpt4o":{"type":"object","properties":{"model":{"type":"string"},"output":{"type":"string"},"scores":{"type":"object","properties":{"completeness":{"type":"integer","minimum":1,"maximum":10},"relevancy":{"type":"integer","minimum":1,"maximum":10},"reasoning_depth":{"type":"integer","minimum":1,"maximum":10},"faithfulness":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer"}}}}}}},"winner":{"type":"string","enum":["claude","gpt4o"]},"verdict":{"type":"string"},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"1.25","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"1.25"},"protocols":[{"x402":{"chain":"base","chainId":8453,"asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xB40a687ca5483Ebc02F870348f6e08971Cae1308"}}]}}},"/api/preflight":{"post":{"operationId":"preflight","summary":"Preflight - prompt quality + endpoint trust check ($0.05 USDC)","description":"Combined PQS prompt quality + x402 endpoint trust check before inference","tags":["preflight","paid","evm"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to preflight"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general","description":"Domain: software/content/business/education/science/crypto/general/research"},"endpoint_url":{"type":"string","description":"Optional endpoint URL for trust scoring"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","clearance","prompt"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"chain":{"type":"string","enum":["base","solana"]},"clearance":{"type":"string","enum":["CLEAR","CAUTION","BLOCK"]},"confidence":{"type":"number"},"prompt":{"type":"object","properties":{"score":{"type":"integer"},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string"},"threshold_met":{"type":"boolean"},"top_issue":{"type":["string","null"]},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}},"feedback":{"type":"array","items":{"type":"string"}}}},"endpoint":{"type":"object","description":"Present only when endpoint_url was supplied","properties":{"wallet":{"type":"string"},"trust_score":{"type":"number"},"trust_label":{"type":"string"},"resolution_source":{"type":"string"}}}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.05","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{"chain":"base","chainId":8453,"asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xB40a687ca5483Ebc02F870348f6e08971Cae1308"}}]}}},"/api/pqs-grade":{"post":{"operationId":"pqsGrade","summary":"Quick pre-flight grade ($0.001 USDC). Composite + PEEM/RAGAS/G-Eval + verdict.","description":"Quick pre-flight quality score: composite + three framework sub-scores (PEEM, RAGAS, G-Eval) + verdict. Designed to run upstream of any other paid call to filter weak prompts before inference.","tags":["grade","paid","evm"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to grade"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["score","grade","verdict","frameworks"],"properties":{"score":{"type":"integer","minimum":0,"maximum":100,"description":"Composite 0-100 score (percentile-normalized total)"},"grade":{"type":"string","enum":["A","B","C","D","F"]},"verdict":{"type":"string","description":"Single sentence diagnosing the weakest dimension, with a framework citation"},"frameworks":{"type":"object","required":["peem","ragas","geval"],"properties":{"peem":{"type":"number","minimum":0,"maximum":10,"description":"PEEM framework score: weights structure (clarity, output format, role, constraints)"},"ragas":{"type":"number","minimum":0,"maximum":10,"description":"RAGAS framework score: weights grounding (context, specificity, examples)"},"geval":{"type":"number","minimum":0,"maximum":10,"description":"G-Eval framework score: weights LLM-judged faithfulness (clarity, specificity, CoT, constraints)"}}},"methodology_url":{"type":"string","description":"Link to the methodology blog post explaining the five-framework synthesis"},"upgrade_url":{"type":"string","description":"Link to PQS Pro for the full 8-dimension SaaS"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.001","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{"chain":"base","chainId":8453,"asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xB40a687ca5483Ebc02F870348f6e08971Cae1308"}}]}}},"/api/score/sol":{"post":{"operationId":"scoreSol","summary":"Score a prompt - Solana x402 ($0.025 USDC)","description":"Basic PQS prompt score (Solana x402)","tags":["score","paid","solana"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to score"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","score"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"prompt":{"type":"string"},"vertical":{"type":"string"},"score":{"type":"object","properties":{"total":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"percentile":{"type":"integer"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}}}},"top_fixes":{"type":"array","items":{"type":"string"},"minItems":3,"maxItems":3},"upgrade":{"type":"string"},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.025","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.025"},"protocols":[{"x402":{"chain":"solana","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","recipient":"GSC1Jqqt374y276tydXn5Bsb6AvSF9LHqeacYJciAZDc"}}]}}},"/api/score/full/sol":{"post":{"operationId":"scoreFullSol","summary":"Full PQS analysis - Solana x402 ($0.125 USDC)","description":"Full PQS analysis (Solana x402)","tags":["full","paid","solana"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to score"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","original","optimized"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"original":{"type":"object","properties":{"prompt":{"type":"string"},"score":{"type":"object","properties":{"total":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"percentile":{"type":"integer"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}}}},"output":{"type":"string"}}},"optimized":{"type":"object","properties":{"prompt":{"type":"string"},"score":{"type":"object","properties":{"total":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"percentile":{"type":"integer"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}}}},"output":{"type":"string"}}},"improvement_pct":{"type":"integer"},"explanation":{"type":"string"},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.125","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.125"},"protocols":[{"x402":{"chain":"solana","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","recipient":"GSC1Jqqt374y276tydXn5Bsb6AvSF9LHqeacYJciAZDc"}}]}}},"/api/score/batch/sol":{"post":{"operationId":"scoreBatchSol","summary":"Batch PQS scoring - Solana x402 ($0.25 USDC)","description":"Batch PQS scoring (Solana x402)","tags":["batch","paid","solana"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompts"],"properties":{"prompts":{"type":"array","minItems":1,"maxItems":10,"items":{"oneOf":[{"type":"string","minLength":1,"maxLength":10000},{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"]}}}]}}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","results","summary"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"batch_size":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"prompt":{"type":"string"},"vertical":{"type":"string"},"score":{"type":"integer"},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}},"top_fixes":{"type":"array","items":{"type":"string"}},"error":{"type":"string","description":"present instead of score fields if this row failed"}}}},"summary":{"type":"object","properties":{"total_scored":{"type":"integer"},"avg_score":{"type":"number"},"avg_out_of":{"type":"integer","enum":[80]},"lowest_grade":{"type":"string"},"highest_score":{"type":"integer"},"lowest_score":{"type":"integer"}}},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.25","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.25"},"protocols":[{"x402":{"chain":"solana","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","recipient":"GSC1Jqqt374y276tydXn5Bsb6AvSF9LHqeacYJciAZDc"}}]}}},"/api/score/compare/sol":{"post":{"operationId":"scoreCompareSol","summary":"Cross-model comparison - Solana x402 ($1.25 USDC)","description":"Cross-model scoring (Solana x402)","tags":["compare","paid","solana"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to score"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","results","winner","verdict"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"original_prompt":{"type":"string"},"optimized_prompt":{"type":"string"},"vertical":{"type":"string"},"results":{"type":"object","properties":{"claude":{"type":"object","properties":{"model":{"type":"string"},"output":{"type":"string"},"scores":{"type":"object","properties":{"completeness":{"type":"integer","minimum":1,"maximum":10},"relevancy":{"type":"integer","minimum":1,"maximum":10},"reasoning_depth":{"type":"integer","minimum":1,"maximum":10},"faithfulness":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer"}}}}},"gpt4o":{"type":"object","properties":{"model":{"type":"string"},"output":{"type":"string"},"scores":{"type":"object","properties":{"completeness":{"type":"integer","minimum":1,"maximum":10},"relevancy":{"type":"integer","minimum":1,"maximum":10},"reasoning_depth":{"type":"integer","minimum":1,"maximum":10},"faithfulness":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer"}}}}}}},"winner":{"type":"string","enum":["claude","gpt4o"]},"verdict":{"type":"string"},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"1.25","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"1.25"},"protocols":[{"x402":{"chain":"solana","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","recipient":"GSC1Jqqt374y276tydXn5Bsb6AvSF9LHqeacYJciAZDc"}}]}}},"/api/preflight/sol":{"post":{"operationId":"preflightSol","summary":"Preflight - Solana x402 ($0.05 USDC)","description":"Preflight prompt + endpoint trust (Solana x402)","tags":["preflight","paid","solana"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to preflight"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general","description":"Domain: software/content/business/education/science/crypto/general/research"},"endpoint_url":{"type":"string","description":"Optional endpoint URL for trust scoring"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","clearance","prompt"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"chain":{"type":"string","enum":["base","solana"]},"clearance":{"type":"string","enum":["CLEAR","CAUTION","BLOCK"]},"confidence":{"type":"number"},"prompt":{"type":"object","properties":{"score":{"type":"integer"},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string"},"threshold_met":{"type":"boolean"},"top_issue":{"type":["string","null"]},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}},"feedback":{"type":"array","items":{"type":"string"}}}},"endpoint":{"type":"object","description":"Present only when endpoint_url was supplied","properties":{"wallet":{"type":"string"},"trust_score":{"type":"number"},"trust_label":{"type":"string"},"resolution_source":{"type":"string"}}}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.05","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{"chain":"solana","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"USDC","recipient":"GSC1Jqqt374y276tydXn5Bsb6AvSF9LHqeacYJciAZDc"}}]}}},"/api/variants":{"post":{"operationId":"variants","summary":"Generate N ranked prompt variants ($0.10 USDC)","description":"Generate N ranked prompt variants. Diverse rewrites scored on the 8-dimension PQS rubric, returned best-first.","tags":["variants","paid","evm"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to generate variants for"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"},"count":{"type":"integer","minimum":1,"maximum":5,"default":3,"description":"Number of variants to generate (1-5)"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","variants"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"original_prompt":{"type":"string"},"vertical":{"type":"string"},"baseline_score":{"type":"object","properties":{"total":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"percentile":{"type":"integer"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}}}},"variants":{"type":"array","minItems":1,"maxItems":5,"items":{"type":"object","properties":{"prompt":{"type":"string"},"style":{"type":"string","description":"Generation angle: detailed | concise | structured | role-framed | example-led"},"score":{"type":"object","properties":{"total":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"percentile":{"type":"integer"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}}}},"delta_vs_baseline":{"type":"integer","description":"score.total - baseline_score.total"}}}},"best_variant_index":{"type":"integer","minimum":0},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.10","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.10"},"protocols":[{"x402":{"chain":"base","chainId":8453,"asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xB40a687ca5483Ebc02F870348f6e08971Cae1308"}}]}}},"/api/fix-injection":{"post":{"operationId":"fixInjection","summary":"Detect prompt injection + return sanitized prompt ($0.025 USDC)","description":"Detect prompt injection (instruction override, role hijack, data exfiltration, delimiter attacks) and return a sanitized prompt","tags":["fix_injection","paid","evm"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to scan for injection attempts"}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","injection_detected","injection_confidence","sanitized_prompt"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"injection_detected":{"type":"boolean"},"injection_confidence":{"type":"number","minimum":0,"maximum":1},"injection_pattern":{"type":["string","null"],"enum":["instruction_override","role_hijack","data_exfiltration","delimiter_attack","encoding_evasion","jailbreak",null]},"matched_signals":{"type":"array","items":{"type":"string"},"description":"Short labels for the heuristics or LLM signals that fired"},"sanitized_prompt":{"type":"string","description":"Prompt with injection-like fragments removed; equals original when nothing was detected"},"detector":{"type":"string","enum":["heuristic","llm","heuristic+llm"],"description":"Which detection path produced the verdict"},"powered_by":{"type":"string"}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.025","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.025"},"protocols":[{"x402":{"chain":"base","chainId":8453,"asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xB40a687ca5483Ebc02F870348f6e08971Cae1308"}}]}}},"/api/proxy/venice":{"post":{"operationId":"veniceProxy","summary":"PQS preflight + Venice.ai chat completion ($0.05 USDC)","description":"Venice.ai chat completion with PQS preflight scoring. Returns LLM response plus 8-dimension quality score in one paid call. No signup, no API key.","tags":["venice_proxy","paid","evm"],"security":[{"x402":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to score and send to Venice.ai"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"},"model":{"type":"string","description":"Optional Venice.ai model override. Defaults to venice-uncensored-1-2. Call GET /api/proxy/venice/models (free, no payment) for the live list of supported model IDs and aliases. Unknown IDs return 400 before settlement."}}}}}},"responses":{"200":{"description":"Scoring result","content":{"application/json":{"schema":{"type":"object","required":["pqs","venice","meta"],"properties":{"pqs":{"type":"object","required":["total","grade","dimensions","framework_breakdown"],"properties":{"total":{"type":"integer","minimum":8,"maximum":80},"grade":{"type":"string","enum":["A","B","C","D","F"]},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}},"framework_breakdown":{"type":"object","required":["peem","ragas","geval"],"properties":{"peem":{"type":"number","minimum":0,"maximum":10,"description":"PEEM framework score: weights structure"},"ragas":{"type":"number","minimum":0,"maximum":10,"description":"RAGAS framework score: weights grounding"},"geval":{"type":"number","minimum":0,"maximum":10,"description":"G-Eval framework score: weights faithfulness"}}}}},"preflight_warning":{"type":["string","null"],"description":"Populated when the prompt scores below 30; null otherwise."},"improvement_suggestion":{"type":["string","null"],"description":"One-line rewrite hint, populated when the prompt scores below 50; null otherwise."},"venice":{"type":"object","description":"Venice.ai chat completion, or an error object when the Venice call failed.","properties":{"model":{"type":"string"},"content":{"type":"string"},"usage":{"type":["object","null"]},"citations":{"type":"array","description":"Web search citations grounding the Venice response. Populated when web_search_enabled is true.","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"content":{"type":"string"},"date":{"type":"string"}}}},"web_search_enabled":{"type":"boolean","description":"True when Venice call was made with web search grounding enabled."},"error":{"type":"string","description":"Present instead of model/content/usage when the Venice call failed."}}},"meta":{"type":"object","required":["endpoint","price_paid_usdc","request_id"],"properties":{"endpoint":{"type":"string","enum":["/api/proxy/venice"]},"price_paid_usdc":{"type":"number","enum":[0.05]},"request_id":{"type":"string","description":"uuid correlating the response to its pqs_api_calls audit row"}}}}}}}},"400":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid or missing bearer API key (when using bearer auth)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment Required - x402 challenge when no bearer API key present. See x-payment-info."}},"x-payment-info":{"authMode":"x402","price":"0.05","currency":"USD","priceDetails":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{"chain":"base","chainId":8453,"asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xB40a687ca5483Ebc02F870348f6e08971Cae1308"}}]}}},"/api/v1/optimize":{"post":{"operationId":"v1Optimize","summary":"Full prompt optimization (Stripe-subscription tier)","description":"Paid-tier Stripe-gated endpoint. Requires a bearer PQS_... API key attached to a solo/team/business/enterprise subscription. Returns optimized prompt + before/after scoring + both outputs.","tags":["paid","stripe","full"],"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","minLength":1,"maxLength":10000,"description":"Prompt to score"},"vertical":{"type":"string","enum":["software","content","business","education","science","crypto","general","research"],"default":"general"}}}}}},"responses":{"200":{"description":"Full optimization result","content":{"application/json":{"schema":{"type":"object","required":["pqs_version","original","optimized"],"properties":{"pqs_version":{"type":"string","enum":["2.0"]},"original":{"type":"object","properties":{"prompt":{"type":"string"},"score":{"type":"object","properties":{"total":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"percentile":{"type":"integer"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}}}},"output":{"type":"string"}}},"optimized":{"type":"object","properties":{"prompt":{"type":"string"},"score":{"type":"object","properties":{"total":{"type":"integer","minimum":8,"maximum":80},"out_of":{"type":"integer","enum":[80]},"grade":{"type":"string","enum":["A","B","C","D","F"]},"percentile":{"type":"integer"},"dimensions":{"type":"object","properties":{"clarity":{"type":"integer","minimum":1,"maximum":10},"specificity":{"type":"integer","minimum":1,"maximum":10},"context":{"type":"integer","minimum":1,"maximum":10},"constraints":{"type":"integer","minimum":1,"maximum":10},"output_format":{"type":"integer","minimum":1,"maximum":10},"role_definition":{"type":"integer","minimum":1,"maximum":10},"examples":{"type":"integer","minimum":1,"maximum":10},"cot_structure":{"type":"integer","minimum":1,"maximum":10},"total":{"type":"integer","minimum":8,"maximum":80}}}}},"output":{"type":"string"}}},"improvement_pct":{"type":"integer"},"explanation":{"type":"string"},"powered_by":{"type":"string"}}}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Free tier cannot use this endpoint - subscribe at promptqualityscore.com/pricing","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Rate limited (per-tier)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}}}}