# PQS - Prompt Quality Score via Venice.ai

> PQS - Prompt Quality Score via Venice.ai is a paid API for AI agents from promptqualityscore.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Scores an AI prompt across 8 quality dimensions, returns a grade and fixed version by proxying through Venice.ai inference

## Facts

- Endpoint: GET https://promptqualityscore.com/api/proxy/venice
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pqs-prompt-quality-score-via-venice-ai-394aa43f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DiySWmcepELiB5sZvYJAk

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pqs-prompt-quality-score-via-venice-ai-394aa43f
```

Example prompt: Score this prompt for me against the 8 PQS dimensions and tell me what's weak and how to fix it — 'You are a helpful assistant. Summarize this article.' — use the software vertical.

## When to prefer this

Use this endpoint when you need to evaluate and optionally improve a single prompt before spending on a full LLM inference call, especially when prompt quality is uncertain or when you want structured multi-dimensional scoring with a fixed suggestion. Prefer this over batch endpoints when evaluating one prompt at a time.

## Known failure modes

- prompt is empty or exceeds 10,000 characters — returns 400 validation error
- unknown model ID passed — returns 400 before payment is settled
- payment not provided or insufficient — returns 402 Payment Required
- Venice.ai upstream unavailable — returns 5xx error
- invalid vertical enum value — returns 400 schema validation error

## How this service works

A Quality Gate For Prompts. Before they break production. Score any AI prompt against 8 dimensions, see what's weak, and get the fixed version in seconds.

## Output

Returns a JSON object with: a letter grade (e.g. D), total score out of 100, per-dimension scores (clarity, context, examples, constraints, specificity, cot_structure, output_format, role_definition), framework breakdown (peem, geval, ragas), an improvement suggestion, the Venice.ai model's actual response content, token usage, and a preflight warning if applicable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "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."
  },
  "prompt": {
   "type": "string",
   "maxLength": 10000,
   "minLength": 1,
   "description": "Prompt to score and send to Venice.ai"
  },
  "vertical": {
   "enum": [
    "software",
    "content",
    "business",
    "education",
    "science",
    "crypto",
    "general",
    "research"
   ],
   "type": "string",
   "default": "general"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pqs": {
   "grade": "D",
   "total": 46,
   "dimensions": {
    "clarity": 7,
    "context": 6,
    "examples": 4,
    "constraints": 5,
    "specificity": 6,
    "cot_structure": 6,
    "output_format": 7,
    "role_definition": 5
   },
   "framework_breakdown": {
    "peem": 6,
    "geval": 6,
    "ragas": 5.3
   }
  },
  "meta": {
   "endpoint": "/api/proxy/venice",
   "request_id": "00000000-0000-4000-8000-000000000000",
   "price_paid_usdc": 0.05
  },
  "venice": {
   "model": "venice-uncensored-1-2",
   "usage": {
    "total_tokens": 57,
    "prompt_tokens": 24,
    "completion_tokens": 33
   },
   "content": "PQS scores any LLM prompt on 8 dimensions before inference so an agent operator can reject low-quality inputs before paying for a run.",
   "citations": [
    {
     "url": "https://promptqualityscore.com/",
     "date": "",
     "title": "PQS - promptqualityscore.com",
     "content": "PQS scores any LLM prompt on 8 dimensions pre-inference."
    }
   ],
   "web_search_enabled": true
  },
  "preflight_warning": null,
  "improvement_suggestion": "Include at least one worked example or input-output pair of the result you want."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pqs-prompt-quality-score-via-venice-ai-394aa43f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from promptqualityscore.com](https://www.zero.xyz/host/promptqualityscore.com/llms.txt)