Skip to main content
POST
Answer questions

Authorizations

Authorization
string
header
required

Your Perplexity API key, sent as Authorization: Bearer <key>. The x-api-key header is not read.

Body

application/json

The content to evaluate and the named questions to ask about it. Unknown fields return 400. Input must stay under 262,144 tokens and the body under 32 MiB.

model
string
required

The model to use: decider-27b, or decider-27b-v0 to pin the current version. A missing or unknown model returns 400.

Example:

"decider-27b"

state
required

The content every question in the request refers to: a string, an object, or an array. Images go in an array as OpenAI-style image_url parts with base64 PNG, JPEG, or WebP data URLs.

Example:

"The headphones sound great, but the battery stopped charging after two weeks."

questions
Questions · object
required

Questions keyed by a non-empty name you choose. The response uses the same names. 1 to 128 questions.

Example:

Response

One answer per question, under the question's name.

Answers keyed by question name, plus the model that answered and token usage.

model
string
required

The model name you sent, echoed back.

Example:

"decider-27b"

answers
Answers · object
required

One answer per question, under the question's name.

Example:
usage
Usage · object
required

Token counts for this request.

Example: