Create x402 research

Start a new research job using x402 payment. This endpoint mints a temporary API key that is returned in the response and is billed via the x402 settlement flow instead of your Caesar API credits.

Request

This endpoint expects an object.

querystringRequired

Primary research question or instruction.

compute_unitsintegerOptional1-10Defaults to 1

Optional compute budget for the job. Defaults to 1.

system_promptstringOptional

Optional system prompt to steer the assistant.

Response

Research job accepted and x402 payment settled.

idstringformat: "uuid"

Research job identifier.

statusenum

Current status of the research job.

api_key_secretstring or null

Temporary API key secret created for this x402 request.

1	import requests
2
3	url = "https://api.caesar.xyz/x402/research"
4
5	payload = {
6	"query": "Summarise latest developments in perovskite solar cells.",
7	"compute_units": 3,
8	"system_prompt": "Be concise and cite sources."
9	}
10	headers = {
11	"X-PAYMENT": "X-PAYMENT",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.post(url, json=payload, headers=headers)
16
17	print(response.json())

Headers

Request

Response

Errors

1	{
2	"id": "f2f6e5db-2c7d-4f56-bb0c-5a6b6a7a9b10",
3	"status": "queued",
4	"api_key_secret": "sk-demo.x402secret"
5	}