Skip to main content
POST
web.chat

Authorizations

Authorization
string
header
required

API key: sk_live_…

Headers

Idempotency-Key
string

Optional. A retry with the same key returns the stored result.

Maximum string length: 255
Pramaan-Max-Price-Micro
string

Optional. The most this request may be priced at, in micro-USD (a whole number above 0). It replaces the capability's own price ceiling for this request, lower or higher. Sources that could cost more are left out; when none is left the answer is 400 with the lowest limit that would work.

Pattern: ^[1-9]\d{0,14}$

Body

application/json
messages
object[]
required

The conversation so far, in order. The whole history is sent each time, so multi-turn chat works by including the earlier turns.

Required array length: 1 - 24 elements
quality
enum<string>
default:fast

"fast" is the low-latency assistant; "light", "standard" and "deep" are research-grounded tiers of rising depth and price. Default "fast".

Available options:
fast,
light,
standard,
deep
jsonFormat
object

Optional shape of the reply, as an example object ({"price": "number"}) or a JSON Schema object; the reply then comes back as JSON.

Response

The result

reply
required

The reply, in the shape of jsonFormat when one was given.

sources
object[]
required

The pages the reply drew on.