---
title: "Generate N ranked prompt variants ($0.10 USDC)"
method: POST
path: "/api/variants"
tags: ["variants", "paid", "evm"]
---

# Generate N ranked prompt variants ($0.10 USDC)

`POST /api/variants`

## Request

- Base URL: `https://promptqualityscore.com`
- URL: `https://promptqualityscore.com/api/variants`
- Auth: one of:
  - API key in header `X-PAYMENT`
  - API key in header `Authorization`

Generate N ranked prompt variants. Diverse rewrites scored on the 8-dimension PQS rubric, returned best-first.

## Request body

- object
  - `prompt` string, required: Prompt to generate variants for
  - `vertical` 'software' | 'content' | 'business' | 'education' | 'science' | 'crypto' | 'general' | 'research'
  - `count` integer: Number of variants to generate (1-5)

## Response `200`

Scoring result

- object
  - `pqs_version` '2.0', required
  - `original_prompt` string
  - `vertical` string
  - `baseline_score` object
    - `total` integer
    - `out_of` 80
    - `grade` 'A' | 'B' | 'C' | 'D' | 'F'
    - `percentile` integer
    - `dimensions` object
      - `clarity` integer
      - `specificity` integer
      - `context` integer
      - `constraints` integer
      - `output_format` integer
      - `role_definition` integer
      - `examples` integer
      - `cot_structure` integer
      - `total` integer
  - `variants` object[], required
    - `prompt` string
    - `style` string: Generation angle: detailed | concise | structured | role-framed | example-led
    - `score` object
      - `total` integer
      - `out_of` 80
      - `grade` 'A' | 'B' | 'C' | 'D' | 'F'
      - `percentile` integer
      - `dimensions` object
        - `clarity` integer
        - `specificity` integer
        - `context` integer
        - `constraints` integer
        - `output_format` integer
        - `role_definition` integer
        - `examples` integer
        - `cot_structure` integer
        - `total` integer
    - `delta_vs_baseline` integer: score.total - baseline_score.total
  - `best_variant_index` integer
  - `powered_by` string

## Other responses

- `400`: Invalid request body
- `401`: Invalid or missing bearer API key (when using bearer auth)
- `402`: Payment Required - x402 challenge when no bearer API key present. See x-payment-info.

---

[API](https://skmtc.dev/promptqualityscore/apis/pqs-prompt-quality-score.md) · [All operations](https://skmtc.dev/promptqualityscore/apis/pqs-prompt-quality-score/llms.txt) · [OpenAPI document](https://skmtc.dev/promptqualityscore/apis/pqs-prompt-quality-score/revisions/7f3f43a1c864?raw)