Skip to main content
POST
llm.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

Conversation oldest first, up to 500 messages and 1,000,000 serialized characters. Tool results immediately follow their outstanding calls, exactly once each; all calls must be answered before the next turn.

Required array length: 1 - 500 elements
tools
object[]

Up to 64 uniquely named tools. The application executes them; this call only requests them. Combined schemas are capped at 64 KiB.

Required array length: 1 - 64 elements
model
enum<string>
default:balanced

Quality tier. Default balanced.

Available options:
fast,
balanced,
best
maxTokens
integer
default:4096

Maximum generated tokens; 1 to 1048576, default 4096; each source enforces its model maximum. The cap can include internal reasoning; very small values may produce no text.

Required range: 1 <= x <= 1048576
temperature
number

Randomness, 0 to 2. Sources that cannot apply it decline.

Required range: 0 <= x <= 2
jsonSchema
object

JSON Schema subset: type (including nullable arrays), properties, required, additionalProperties, items, enum, const, anyOf, acyclic local $defs/$ref, minimum/maximum/exclusiveMinimum/exclusiveMaximum, minLength/maxLength, minItems/maxItems, title/description/default/examples. $schema, $id and $comment are accepted and ignored. format is accepted and ignored; the model is not told about it and results are not checked against it. Any other keyword is refused, and the error names it and where it is. Maximum 64 KiB, 256 nodes, depth 16; no external or recursive references. JSON text is preserved exactly; invalid or oversized output fails.

Response

The result

toolCalls
object[]
required

Calls for the application to consider executing. No tool has been executed.

Maximum array length: 64
finishReason
enum<string>
required

Why the turn ended: stop, tool_calls, length (hit maxTokens) or other. Partial plain text is returned with length; incomplete tools or structured replies fail.

Available options:
stop,
tool_calls,
length,
other
usage
object
required

Token usage for the turn.

text
string

Generated assistant text. JSON text is returned exactly when a schema was supplied.