API ReferencePayments

Create a Research Object via x402

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.

Headers

X-PAYMENTstringRequired

Base64-encoded x402 payment payload.

Request

This endpoint expects an object.
querystringRequired
Primary research question or instruction.
reasoning_loopsintegerOptional1-10Defaults to 1
Maximum number of iterative reasoning cycles the research process can perform.
source_timeoutintegerOptional3-180Defaults to 60
Maximum time in seconds to wait when fetching content from each source URL.
reasoning_modebooleanOptionalDefaults to false
When enabled, uses an advanced reasoning model for deeper analysis.
allow_early_exitbooleanOptionalDefaults to false
When enabled, the research process may complete before exhausting all reasoning loops.
exclude_socialbooleanOptionalDefaults to false
When enabled, excludes results from social media platforms.
excluded_domainslist of stringsOptional

List of domains to exclude from search results (e.g., “example.com”). Subdomains are also excluded.

autobooleanOptionalDefaults to false
When enabled, activates auto mode which analyzes the query to determine optimal configuration.
system_promptstringOptional
Custom system prompt to guide the research synthesis.
modelstringOptional

Preferred AI model to use for research synthesis. Valid values are “gpt-5.2”, “gemini-3-pro”, “gemini-3.1-pro”, “gemini-3-flash”, or “claude-opus-4.5”. When not specified, the system automatically selects an appropriate model.

Response

Research job accepted and x402 payment settled.
idstringformat: "uuid"
Research job identifier.
statusenum

Current status of the research job:

  • queued: Job accepted, waiting to start
  • searching: Gathering sources from the web
  • researching: Processing and analyzing sources
  • analyzing: Deep analysis of gathered information
  • summarizing: Generating final synthesis
  • completed: Research finished successfully
  • failed: Research encountered an error
api_key_secretstring
Temporary API key secret created for this x402 request.

Errors

400
Bad Request Error
402
Payment Required Error
500
Internal Server Error