# QuantumToken (Pianam) — llms.txt (English)

> Site description for AI tools and crawlers.

## What it is
Pianam (Chinese brand: 奇物匣) is a developer-first AI capability and open API platform.
Any registered account can create one or more apps in the console, receive a long-lived `X-API-Key` per app, and call the platform's AI endpoints with a unified credit wallet.

Main landing (EN): https://trade.pianam.cn/landing/en/
Chinese version: https://trade.pianam.cn/landing/

## Machine-readable paths (AI-friendly)
- https://trade.pianam.cn/openapi.json — Full OpenAPI 3.1 schema. **Most important; parse this first.**
- https://trade.pianam.cn/docs — Swagger UI (human-readable).
- https://trade.pianam.cn/redoc — ReDoc rendering (human-readable).
- https://trade.pianam.cn/landing/en/llms.txt — This file (English).
- https://trade.pianam.cn/llms.txt — Chinese version.
- https://trade.pianam.cn/sitemap.xml — Sitemap.

## Pricing
- 1 CNY = 100 credits; 1 credit = 1 API call (per-call, idempotent deduction).
- Credits are non-refundable and non-withdrawable; they can only be used to call platform APIs.
- No monthly fee, no minimum spend; pay-as-you-go.
- Credit packs: 100 / 1000 / 5000 / 10000 (CNY 1 / 10 / 50 / 100).

## Open endpoints (core)
Base URL: https://trade.pianam.cn

### 1. Query balance
- Method: GET
- Path: /api/v1/open/quota
- Auth: Header `X-API-Key: <your_key>`
- Response: `{ "user_id": ..., "balance": <credits_left>, "frozen": <frozen_credits> }`

### 2. Deduct once
- Method: POST
- Path: /api/v1/open/quota/consume
- Auth: Header `X-API-Key: <your_key>`
- Body: `{ "amount": 1, "idempotency_key": "<unique string, <=32 chars>" }`
- Response: `{ "ok": true, "balance": <after>, "frozen": 0 }`
- Default `amount` is 1; the system converts based on the current model tier (free Flash = 1 credit, Air/FlashX = 2-3, flagship tiers not yet available).

## Three steps to start
1. Sign up and log in at https://trade.pianam.cn.
2. Create an app under "Apps" — you'll get an `X-API-Key` (shown only once, please save it).
3. Buy a credit pack under "Credits"; after manual confirmation of payment, credits land in your wallet.

## Usage example
```bash
# Query balance
curl -H "X-API-Key: YOUR_KEY" https://trade.pianam.cn/api/v1/open/quota

# Deduct once
curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"amount":1,"idempotency_key":"demo-001"}' \
  https://trade.pianam.cn/api/v1/open/quota/consume
```

## Business contact
Email: biz@pianam.cn