PayPerQ

Private models run inside Trusted Execution Environments — hardware-attested secure enclaves on NVIDIA confidential-computing GPUs, powered by Tinfoil. Your request body is encrypted in your process with HPKE before it leaves your machine, decrypted only inside the attested enclave, and re-encrypted on the way back. PPQ can only see ciphertext and routing metadata — never your prompts or completions.

Available TEE models

Weights are identical to the standard counterparts — the only difference is the enclave + end-to-end encryption. Fetch the current list with GET /v1/models?type=all and filter for IDs beginning with private/.

Learn more

• github.com/PayPerQ/ppq-private-mode-proxy — proxy source, install and configuration instructions
• Introducing Private AI Models — how TEE enclaves and attestation work
• Using Private (TEE) Models with OpenClaw — walkthrough for OpenClaw and standalone clients

Convert audio to text using our OpenAI-compatible transcription API. Powered by Deepgram Nova-3 for high-quality, accurate transcriptions.

Endpoint

Supported Audio Formats

mp3, mp4, mpeg, mpga, m4a, wav, webm (max 25MB)

Parameters

curl https://api.ppq.ai/v1/audio/models

from openai import OpenAI

# Initialize client with PayPerQ API
client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.ppq.ai/v1"
)

# Transcribe audio file
with open("audio.mp3", "rb") as audio_file:
    transcription = client.audio.transcriptions.create(
        model="nova-3",  # Deepgram Nova-3
        file=audio_file,
        response_format="json"  # Options: json, text, srt, vtt, verbose_json
    )

print(transcription.text)

Convert text to natural-sounding speech using our OpenAI-compatible TTS API. Powered by DeepGram Aura and ElevenLabs for high-quality voice synthesis.

Endpoint

Parameters

Available Voices

curl https://api.ppq.ai/v1/audio/voices

from openai import OpenAI

# Initialize client with PayPerQ API
client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.ppq.ai/v1"
)

# Generate speech from text
response = client.audio.speech.create(
    model="deepgram_aura_2",
    voice="aura-2-arcas-en",
    input="Hello, welcome to PayPerQ!"
)

# Save to file
response.stream_to_file("output.mp3")

Generate images from text prompts or transform existing images using state-of-the-art AI models. Requests are synchronous — the API returns the generated images directly in the response.

Endpoint

Parameters

Parameter support varies by model. The image models reference lists which parameters each model accepts (required vs. optional).

Available Image Models

The example below uses nano-banana-2. Browse all image models with capabilities and code examples →

import requests

api_key = "YOUR_API_KEY"
url = "https://api.ppq.ai/v1/images/generations"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {api_key}"
}

data = {
    "model": "nano-banana-2",
    "prompt": "A futuristic cityscape at sunset",
    "resolution": "1K",
    "n": 1
}

response = requests.post(url, json=data, headers=headers)
result = response.json()

for image in result["data"]:
    print(image["url"])  # signed URL served by PPQ (valid 24h)

Response

{
  "created": 1709234567,
  "model": "nano-banana-2",
  "cost": 0.0805,
  "data": [
    {
      "url": "https://api.ppq.ai/v1/media/gen_abc123/0?sig=...&exp=...",
      "content_type": "image/png"
    }
  ]
}

url is a signed URL served by PPQ (valid 24h). Download the bytes before it expires if you need long-term storage.

Generate videos from text prompts or input images. Video generation is asynchronous — submit a request, then poll for the result. Supports text-to-video and image-to-video models.

Step 1: Submit a Generation

Parameters

Submit Response (202)

{
  "id": "gen_abc123",
  "model": "kling-2.1-pro",
  "status": "pending",
  "created": 1709234567,
  "estimated_cost": 0.2875
}

Step 2: Poll for Status

Poll this endpoint every 5–10 seconds until status changes to "completed" or "failed". Returns 202 while processing, 200 when done.

Completed Response (200)

{
  "id": "gen_abc123",
  "model": "kling-2.1-pro",
  "status": "completed",
  "created": 1709234567,
  "data": {
    "url": "https://api.ppq.ai/v1/media/gen_abc123/0?sig=...&exp=...",
    "content_type": "video/mp4"
  },
  "cost": 0.2875
}

Available Video Models

import requests
import time

api_key = "YOUR_API_KEY"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {api_key}"
}

# Step 1: Submit video generation request
data = {
    "model": "kling-2.1-pro",
    "prompt": "A golden retriever running through a meadow",
    "aspect_ratio": "16:9",
    "duration": "5"
}

response = requests.post(
    "https://api.ppq.ai/v1/videos",
    json=data,
    headers=headers
)
job = response.json()
generation_id = job["id"]
print(f"Job submitted: {generation_id}")

# Step 2: Poll for completion
while True:
    status_res = requests.get(
        f"https://api.ppq.ai/v1/videos/{generation_id}",
        headers=headers
    )
    status = status_res.json()

    if status["status"] == "completed":
        print(f"Video ready: {status['data']['url']}")
        break
    elif status["status"] == "failed":
        print(f"Error: {status.get('error')}")
        break

    print("Processing...")
    time.sleep(5)

import requests

api_key = "YOUR_API_KEY"
generation_id = "gen_abc123"

response = requests.get(
    f"https://api.ppq.ai/v1/videos/{generation_id}",
    headers={"Authorization": f"Bearer {api_key}"}
)

result = response.json()
print(result)
# {"id": "gen_abc123", "model": "kling-2.1-pro", "status": "completed",
#  "data": {"url": "https://api.ppq.ai/v1/media/gen_abc123/0?sig=...&exp=..."},
#  "cost": 0.2875}

Access 27 data enrichment endpoints covering people search, company lookup, web scraping, Google Maps, Reddit, email verification, and social media enrichment. Authenticate with a PPQ API key (deducts from your credit balance) or pay per-request via 402 payment protocols — see the 402 Payments section below.

Base URL: https://api.ppq.ai/v1/data

Browse full endpoint reference with descriptions and parameters →

curl https://api.ppq.ai/v1/data/endpoints

curl -X POST https://api.ppq.ai/v1/data/api/apollo/people-search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "q_keywords": "software engineer",
    "person_locations": ["San Francisco"],
    "per_page": 5
  }'

Generate vector embeddings for text input using models from OpenAI, Qwen, NVIDIA, and more. Embeddings are useful for semantic search, clustering, classification, and RAG (Retrieval-Augmented Generation) pipelines.

Endpoint: POST https://api.ppq.ai/v1/embeddings

OpenAI SDK compatible — use client.embeddings.create() with your PPQ API key.

curl https://api.ppq.ai/v1/models?type=embedding

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.ppq.ai/v1"
)

response = client.embeddings.create(
    model="openai/text-embedding-3-small",
    input="The quick brown fox jumps over the lazy dog"
)

print(response.data[0].embedding[:5])  # First 5 dimensions
print(f"Total tokens: {response.usage.total_tokens}")

curl -X POST https://api.ppq.ai/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": [
      "First document to embed",
      "Second document to embed",
      "Third document to embed"
    ]
  }'

The PayPerQ API allows users to programmatically create deposit invoices and top up their account balances using various payment methods including Bitcoin (Lightning), Bitcoin (on-chain), Monero, Litecoin, and Liquid Bitcoin.

curl -X POST https://api.ppq.ai/topup/create/btc-lightning \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 1000, "currency": "SATS"}'  # Also supports "BTC" and "USD" as currency

curl -X GET https://api.ppq.ai/topup/status/BTCPayInvoiceId123 \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET https://api.ppq.ai/topup/payment-methods

curl -X POST https://api.ppq.ai/accounts/create

curl -X POST "https://api.ppq.ai/credits/balance" \
  -H "Content-Type: application/json" \
  -d '{"credit_id":"4af59b9d-f6ec-4531-82f7-ce776d49e207"}'

More Usage Examples

curl -X POST https://api.ppq.ai/topup/create/btc \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 0.001, "currency": "BTC"}'

curl -X POST https://api.ppq.ai/topup/create/xmr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 50.00, "currency": "USD"}'

Limits

NWC Auto-Topup (Nostr Wallet Connect)

Connect a Nostr Wallet Connect (NWC) compatible Lightning wallet to automatically top up your balance when it falls below a threshold. Your wallet needs to support the pay_invoice capability. Compatible wallets include Alby Hub, LNBits, Primal, and others.

curl -X POST "https://api.ppq.ai/nwc-auto-topup/connect" \
  -H "Content-Type: application/json" \
  -H "x-credit-id: YOUR_CREDIT_ID" \
  -d '{
    "nwc_url": "nostr+walletconnect://your-wallet-pubkey?relay=wss://relay.example.com&secret=your-secret",
    "threshold_usd": 5,
    "topup_amount_usd": 10
  }'

curl -X GET "https://api.ppq.ai/nwc-auto-topup" \
  -H "x-credit-id: YOUR_CREDIT_ID"

curl -X DELETE "https://api.ppq.ai/nwc-auto-topup/connection" \
  -H "x-credit-id: YOUR_CREDIT_ID"

curl -X GET "https://api.ppq.ai/queries/history?page=1&page_count=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Manage your API keys programmatically. Create keys with optional spending limits, reset periods, and expiration dates. All endpoints require the x-credit-id header for authentication.

Base URL: https://api.ppq.ai

curl -X GET "https://api.ppq.ai/keys" \
  -H "x-credit-id: YOUR_CREDIT_ID"

curl -X POST "https://api.ppq.ai/keys" \
  -H "Content-Type: application/json" \
  -H "x-credit-id: YOUR_CREDIT_ID" \
  -d '{
    "name": "my-app-key",
    "usage_limit_usd": 10.00,
    "reset_period": "monthly",
    "expire_at": "2027-01-01T00:00:00Z"
  }'

curl -X GET "https://api.ppq.ai/keys/KEY_ID" \
  -H "x-credit-id: YOUR_CREDIT_ID"

curl -X PATCH "https://api.ppq.ai/keys/KEY_ID" \
  -H "Content-Type: application/json" \
  -H "x-credit-id: YOUR_CREDIT_ID" \
  -d '{
    "name": "updated-key-name",
    "usage_limit_usd": 25.00,
    "reset_period": "weekly"
  }'

curl -X DELETE "https://api.ppq.ai/keys/KEY_ID" \
  -H "x-credit-id: YOUR_CREDIT_ID"