Economics

Marketplace & priority

The marketplace lists every live, rentable host and what they charge. By default you ride the normal queue; pay a multiplier to jump a specific host's priority lane.

Two ways to get served

Normal queue (default).Send a request with no routing headers. Dispatch hands it to any live host serving that model, and you pay that host's standard per-request price.
Priority (targeted). Name a host with X-Pied-Piper-Host and set X-Pied-Piper-Priority: true to skip its line. You pay price × the host's priority multiplier.

Reading a listing

Each card in the marketplace surfaces what you need to choose a host:

Field	Type	Description
Models & warmth		Which models the host serves and whether each is warm (instant) or loadable (cold-start).
Price & multiplier		Credits per request on the normal queue, and the multiplier charged for priority.
Capability tier		An S–D score from model size, ready-model count, and family breadth.
Uptime & schedule		Recent uptime hours and the host's typical online hours (UTC).
Latency		Observed p50 / p95 response times.
Rating		Average stars and review count from borrowers with completed priority jobs.

How hosts are ranked

Listings sort by capability first, with ratings weighted in by confidence (more reviews → more weight). New, capable hosts surface even before they've accumulated reviews.

Targeting a host

Copy a host id from its marketplace card and pass it on the request. Priority requires the target — X-Pied-Piper-Priority alone is a 400.

targeted priority request

1curl https://mesh-zeta-eight.vercel.app/v1/chat/completions \
2  -H "Authorization: Bearer $PIEDPIPER_API_KEY" \
3  -H "X-Pied-Piper-Host: 7f3c...host-id" \
4  -H "X-Pied-Piper-Priority: true" \
5  -H "Content-Type: application/json" \
6  -d '{ "model": "llama-3.2-3b-instruct-q4f32_1",
7        "messages": [{ "role": "user", "content": "ping" }] }'

Rating a host

After a completed, fully-settled priority job with a host, you can leave a star rating and a short note from its marketplace card. Ratings feed the ranking and help the next borrower — only real, paid interactions unlock the ability to rate.

Want to be listed?

Hosting and listing are two clicks apart: start a host, then publish a title, description, and price. See Hosting and set your numbers using Pricing.