{"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"","title":"Oxylabs Web Scraper — Push-Pull async (LLM sources)","version":"1","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","quote":{"header":"X-AISA-Cost-Mode","value":"quote"}},"x-aisa-catalogs":{"oxylabs-llm-async":{"description":"","title":"Oxylabs Web Scraper — Push-Pull async (LLM sources)","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","quote":{"header":"X-AISA-Cost-Mode","value":"quote"}},"x-aisa-document":{"facts_hash":"df77e123e16d48685eba9e2f027571414007ba33f75e01e9650d1abec4d11004","generator_version":"3","protocol_version":"1","schema_version":"1"},"x-aisa-plans":{"builder":1.0,"display_plan":"payg","payg":1.0,"similarweb_payg":1.0,"team":1.0,"version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"}}},"x-aisa-configured-paths":["/apis/v1/oxylabs/llm"],"x-aisa-document":{"composer_version":"26","document_hash":"sha256:0935770df6fb4b68427d9d29b6a83ffe5578dd3930998d5bceca015a8a3d99e1","facts_hash":"df77e123e16d48685eba9e2f027571414007ba33f75e01e9650d1abec4d11004","generator_version":"3","protocol_version":"1","response_pending":[],"schema_version":"1"},"x-aisa-plans":{"builder":1.0,"display_plan":"payg","payg":1.0,"similarweb_payg":1.0,"team":1.0,"version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"},"x-aisa-provider":"oxylabs-llm-async"},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","openapi":"3.1.0","paths":{"/apis/v1/oxylabs/llm":{"get":{"description":"Owner-scoped local asynchronous job lifecycle. Disabling new admission does not disable existing job reads or cancellation. Runtime availability and access policy also apply.\n\n<!-- aisa-pricing:start -->\nA request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"get_oxylabs_llm_async_apis_v1_oxylabs_llm","parameters":[{"in":"query","name":"limit","schema":{"default":50,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"status","schema":{"enum":["","queued","running","completed","failed","cancelled"],"type":"string"}},{"description":"Opaque nextCursor from a previous response.","in":"query","name":"cursor","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"items":{"properties":{"completedAt":{"format":"date-time","type":["string","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"endpoint":{"type":["string","null"]},"error":{"properties":{"code":{"type":["string","null"]},"message":{"type":["string","null"]}},"type":["object","null"]},"id":{"type":["string","null"]},"object":{"const":"integration_async_job","type":"string"},"output":{},"outputExpired":{"type":["boolean","null"]},"pricing":{"properties":{"authorizedMicrosUSD":{"type":["integer","null"]},"billingMode":{"type":["string","null"]},"currency":{"type":["string","null"]},"finalMicrosUSD":{"type":["integer","null"]}},"type":["object","null"]},"status":{"enum":["queued","running","completed","failed","cancelled"],"type":"string"}},"required":["completedAt","createdAt","endpoint","error","id","object","output","pricing","status"],"type":"object"},"type":"array"},"nextCursor":{"type":["string","null"]},"object":{"const":"list","type":"string"}},"required":["object","data","nextCursor"],"type":"object"}}},"description":"Success"}},"summary":"Oxylabs LLM (Push-Pull async) list","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"quote":{"reason":"cost_quote_unsupported","supported":false},"x402":false},"x-aisa-catalog-id":"oxylabs-llm-async","x-aisa-contract-source":"handler","x-aisa-docs-url":"https://aisa.one/docs/api-reference/oxylabs-llm-async/get_oxylabs_llm_async_apis_v1_oxylabs_llm","x-aisa-identity-source":"derived","x-aisa-lifecycle":{"action":"list","kind":"asynchronous"},"x-aisa-pricing":{"description":"No new customer charge is authorized by this lifecycle operation; cancellation may complete an existing job's settlement.","kind":"no_customer_charge"},"x-aisa-revision":{"handler_contract_hash":"6ffde72fef506d003879b80e211486cb5559b096da3d29bb90affccec4079192"},"x-aisa-runtime-operation":{"method":"GET","operation_id":"get_oxylabs_llm_async_apis_v1_oxylabs_llm","path":"/apis/v1/oxylabs/llm"},"x-aisa-status":"enabled","x-aisa-validation":"runtime"},"post":{"description":"Owner-scoped local asynchronous job lifecycle. Disabling new admission does not disable existing job reads or cancellation. Runtime availability and access policy also apply.\n\n<!-- aisa-pricing:start -->\nDefault request estimate: $0.00145 USD (not a fixed price). Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"post_oxylabs_llm","parameters":[{"description":"Trimmed UTF-8 length must be 1 through 191 bytes.","in":"header","name":"Idempotency-Key","required":true,"schema":{"pattern":"\\S","type":"string"}},{"description":"Optional maximum customer authorization in USD, validated by the runtime price parser.","in":"header","name":"X-AISA-Max-Price-USD","schema":{"type":"string"}},{"description":"Return a read-only cost quote instead of submitting a job.","in":"header","name":"X-AISA-Cost-Mode","schema":{"enum":["quote"],"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"prompt":"What is the capital of France?","source":"chatgpt"},"schema":{"additionalProperties":false,"properties":{"context":{},"geo_location":{"type":["string","null"]},"locale":{"type":["string","null"]},"parse":{"type":["boolean","null"]},"prompt":{"description":"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","type":"string","x-aisa-max-trimmed-utf8-bytes-by-source":{"chatgpt":4000,"gemini":8000,"perplexity":8000}},"render":{"type":["string","null"]},"source":{"description":"Supported LLM source; surrounding whitespace is accepted by the runtime validator.","pattern":"^\\s*(chatgpt|gemini|perplexity)\\s*$","type":"string"},"user_agent_type":{"type":["string","null"]}},"required":["source","prompt"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"currency":{"type":["string","null"]},"estimate_kind":{"type":["string","null"]},"estimated_at":{"format":"date-time","type":["string","null"]},"estimated_cost_micros_usd":{"type":["integer","null"]},"max_cost_micros_usd":{"type":["integer","null"]},"may_exceed_estimate":{"type":["boolean","null"]},"metadata":{"additionalProperties":{},"type":["object","null"]},"object":{"type":["string","null"]},"pricing_version":{"type":["string","null"]}},"required":["currency","estimate_kind","estimated_at","estimated_cost_micros_usd","may_exceed_estimate","object"],"type":"object"}}},"description":"Read-only cost quote when X-AISA-Cost-Mode is quote; no job is created."},"202":{"content":{"application/json":{"schema":{"properties":{"completedAt":{"format":"date-time","type":["string","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"endpoint":{"type":["string","null"]},"error":{"properties":{"code":{"type":["string","null"]},"message":{"type":["string","null"]}},"type":["object","null"]},"id":{"type":["string","null"]},"object":{"const":"integration_async_job","type":"string"},"output":{},"outputExpired":{"type":["boolean","null"]},"pricing":{"properties":{"authorizedMicrosUSD":{"type":["integer","null"]},"billingMode":{"type":["string","null"]},"currency":{"type":["string","null"]},"finalMicrosUSD":{"type":["integer","null"]}},"type":["object","null"]},"status":{"enum":["queued","running","completed","failed","cancelled"],"type":"string"}},"required":["completedAt","createdAt","endpoint","error","id","object","output","pricing","status"],"type":"object"}}},"description":"Success"}},"summary":"Oxylabs LLM (Push-Pull async) submit","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"quote":{"header":"X-AISA-Cost-Mode","supported":true,"value":"quote"},"x402":false},"x-aisa-catalog-id":"oxylabs-llm-async","x-aisa-contract-source":"handler","x-aisa-docs-url":"https://aisa.one/docs/api-reference/search/post_oxylabs-llm","x-aisa-lifecycle":{"action":"submit","kind":"asynchronous"},"x-aisa-pricing":{"default_request_estimate_usd":0.00145,"description":"Customer normal-tier reference, with the public PAYG multiplier. Authenticated plan and user tier may differ; a quote uses the actual caller and payload.","estimate_source":"configured_fixed_price","kind":"fixed_request"},"x-aisa-revision":{"handler_contract_hash":"4ed1338331be5b812f0eb0c7c3dc1606bf2a843f66184beae49ce7fbc82e6ace"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"post_oxylabs_llm","path":"/apis/v1/oxylabs/llm"},"x-aisa-status":"enabled","x-aisa-validation":"runtime"}},"/apis/v1/oxylabs/llm/{jobId}":{"get":{"description":"Owner-scoped local asynchronous job lifecycle. Disabling new admission does not disable existing job reads or cancellation. Runtime availability and access policy also apply.\n\n<!-- aisa-pricing:start -->\nA request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"get_oxylabs_llm_job","parameters":[{"in":"path","name":"jobId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"completedAt":{"format":"date-time","type":["string","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"endpoint":{"type":["string","null"]},"error":{"properties":{"code":{"type":["string","null"]},"message":{"type":["string","null"]}},"type":["object","null"]},"id":{"type":["string","null"]},"object":{"const":"integration_async_job","type":"string"},"output":{},"outputExpired":{"type":["boolean","null"]},"pricing":{"properties":{"authorizedMicrosUSD":{"type":["integer","null"]},"billingMode":{"type":["string","null"]},"currency":{"type":["string","null"]},"finalMicrosUSD":{"type":["integer","null"]}},"type":["object","null"]},"status":{"enum":["queued","running","completed","failed","cancelled"],"type":"string"}},"required":["completedAt","createdAt","endpoint","error","id","object","output","pricing","status"],"type":"object"}}},"description":"Success"}},"summary":"Oxylabs LLM (Push-Pull async) detail","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"quote":{"reason":"cost_quote_unsupported","supported":false},"x402":false},"x-aisa-catalog-id":"oxylabs-llm-async","x-aisa-contract-source":"handler","x-aisa-docs-url":"https://aisa.one/docs/api-reference/search/get_oxylabs-llm-job","x-aisa-identity-source":"derived","x-aisa-lifecycle":{"action":"detail","kind":"asynchronous"},"x-aisa-pricing":{"description":"No new customer charge is authorized by this lifecycle operation; cancellation may complete an existing job's settlement.","kind":"no_customer_charge"},"x-aisa-revision":{"handler_contract_hash":"db4f84b6391995a54ac20905a09e09ec588dd14d6a3c34124026fcb1f0f4fe01"},"x-aisa-runtime-operation":{"method":"GET","operation_id":"get_oxylabs_llm_async_apis_v1_oxylabs_llm_jobid","path":"/apis/v1/oxylabs/llm/{jobId}"},"x-aisa-status":"enabled","x-aisa-validation":"runtime"}},"/apis/v1/oxylabs/llm/{jobId}/cancel":{"post":{"description":"Owner-scoped local asynchronous job lifecycle. Disabling new admission does not disable existing job reads or cancellation. Runtime availability and access policy also apply.\n\n<!-- aisa-pricing:start -->\nA request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"post_oxylabs_llm_cancel","parameters":[{"in":"path","name":"jobId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"completedAt":{"format":"date-time","type":["string","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"endpoint":{"type":["string","null"]},"error":{"properties":{"code":{"type":["string","null"]},"message":{"type":["string","null"]}},"type":["object","null"]},"id":{"type":["string","null"]},"object":{"const":"integration_async_job","type":"string"},"output":{},"outputExpired":{"type":["boolean","null"]},"pricing":{"properties":{"authorizedMicrosUSD":{"type":["integer","null"]},"billingMode":{"type":["string","null"]},"currency":{"type":["string","null"]},"finalMicrosUSD":{"type":["integer","null"]}},"type":["object","null"]},"status":{"enum":["queued","running","completed","failed","cancelled"],"type":"string"}},"required":["completedAt","createdAt","endpoint","error","id","object","output","pricing","status"],"type":"object"}}},"description":"Success"},"202":{"content":{"application/json":{"schema":{"properties":{"completedAt":{"format":"date-time","type":["string","null"]},"createdAt":{"format":"date-time","type":["string","null"]},"endpoint":{"type":["string","null"]},"error":{"properties":{"code":{"type":["string","null"]},"message":{"type":["string","null"]}},"type":["object","null"]},"id":{"type":["string","null"]},"object":{"const":"integration_async_job","type":"string"},"output":{},"outputExpired":{"type":["boolean","null"]},"pricing":{"properties":{"authorizedMicrosUSD":{"type":["integer","null"]},"billingMode":{"type":["string","null"]},"currency":{"type":["string","null"]},"finalMicrosUSD":{"type":["integer","null"]}},"type":["object","null"]},"status":{"enum":["queued","running","completed","failed","cancelled"],"type":"string"}},"required":["completedAt","createdAt","endpoint","error","id","object","output","pricing","status"],"type":"object"}}},"description":"Success"}},"summary":"Oxylabs LLM (Push-Pull async) cancel","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"quote":{"reason":"cost_quote_unsupported","supported":false},"x402":false},"x-aisa-catalog-id":"oxylabs-llm-async","x-aisa-contract-source":"handler","x-aisa-docs-url":"https://aisa.one/docs/api-reference/oxylabs-llm-async/post_oxylabs_llm_cancel","x-aisa-identity-source":"derived","x-aisa-lifecycle":{"action":"cancel","kind":"asynchronous"},"x-aisa-pricing":{"description":"No new customer charge is authorized by this lifecycle operation; cancellation may complete an existing job's settlement.","kind":"no_customer_charge"},"x-aisa-revision":{"handler_contract_hash":"199d9352b19edb9f072a7a034af0325f6025b690188695e0fa1befb73df7bb5d"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"post_oxylabs_llm_async_apis_v1_oxylabs_llm_jobid_cancel","path":"/apis/v1/oxylabs/llm/{jobId}/cancel"},"x-aisa-status":"enabled","x-aisa-validation":"runtime"}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}]}