Skip to main content
POST
/
run_prompt
Run Prompt
curl --request POST \
  --url https://api.promptstream.ai/run_prompt \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "prompt_id": "<string>",
  "inputs": {},
  "external_user_id": "<string>"
}
'
{
  "run_id": "<string>",
  "output": "<string>",
  "model_used": "<string>",
  "latency_ms": 123,
  "prompt_tokens": 123,
  "completion_tokens": 123,
  "total_tokens": 123,
  "token_cost_usd": 123,
  "variant_assigned": "<string>",
  "experiment_id": "<string>"
}

Headers

X-API-Key
string
required

Body

application/json
prompt_id
string
required
inputs
Inputs · object
required
external_user_id
string | null

User ID for A/B bucketing; required if an experiment is running

Response

Successful Response

run_id
string
required
output
string
required
model_used
string
required
latency_ms
integer
required
prompt_tokens
integer
required
completion_tokens
integer
required
total_tokens
integer
required
token_cost_usd
number
required
variant_assigned
string | null
experiment_id
string | null