Skip to main content
POST
Oxylabs LLM (Push-Pull async) submit
Submit an asynchronous query to a major LLM answer engine — ChatGPT, Gemini, or Perplexity — via Oxylabs Push-Pull. Pick the engine with source, send the prompt (required), and a unique Idempotency-Key header (required). These sources take ~40–90s, so they run as background jobs. Submitting returns HTTP 202 and a job envelope — id, object, endpoint, status, createdAt, completedAt, pricing, output, error — with output still null. Poll get_oxylabs_llm_job until terminal; output then carries results[] with the parsed answer text and cited sources. Billed at a flat rate per successful job — pricing.billingMode is fixed_request. A still-queued job can be cancelled with POST /oxylabs/llm/{jobId}/cancel, which releases the hold; failed and cancelled jobs are never billed. Send a fresh Idempotency-Key per distinct query.
For the Google sources — Google AI Overviews (google_search) and Google AI Mode (google_ai_mode) — use the synchronous post_oxylabs_ai_search endpoint instead; they return in ~4–8s in the same response.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: POST /apis/v1/oxylabs/llm
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/oxylabs/llm
  • Idempotency-Key: header; required
  • X-AISA-Max-Price-USD: header; optional
  • X-AISA-Cost-Mode: header; optional
  • Runtime facts: df77e123e16d48685eba9e2f027571414007ba33f75e01e9650d1abec4d11004
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Default request estimate: $0.00145 USD (not a fixed price). Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.00145

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string
required

Trimmed UTF-8 length must be 1 through 191 bytes.

Pattern: \S
X-AISA-Max-Price-USD
string

Optional maximum customer authorization in USD, validated by the runtime price parser.

X-AISA-Cost-Mode
enum<string>

Return a read-only cost quote instead of submitting a job.

Available options:
quote

Body

application/json
prompt
string
required

Non-empty after trimming. The trimmed UTF-8 byte limit is selected by source; this is a byte limit, not a JSON Schema character limit.

Pattern: \S
source
string
required

Supported LLM source; surrounding whitespace is accepted by the runtime validator.

Pattern: ^\s*(chatgpt|gemini|perplexity)\s*$
context
any
geo_location
string | null
locale
string | null
parse
boolean | null
render
string | null
user_agent_type
string | null

Response

Read-only cost quote when X-AISA-Cost-Mode is quote; no job is created.

currency
string | null
required
estimate_kind
string | null
required
estimated_at
string<date-time> | null
required
estimated_cost_micros_usd
integer | null
required
may_exceed_estimate
boolean | null
required
object
string | null
required
max_cost_micros_usd
integer | null
metadata
object | null
pricing_version
string | null