> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Oxylabs LLM (Push-Pull async) submit

> Owner-scoped local asynchronous job lifecycle. Disabling new admission does not disable existing job reads or cancellation. Runtime availability and access policy also apply.



## OpenAPI

````yaml openapi/zh/oxylabs-llm-async.json POST /apis/v1/oxylabs/llm
openapi: 3.1.0
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-configured-paths:
    - /apis/v1/oxylabs/llm
  x-aisa-document:
    facts_hash: e7bf366c17cd89d03de75ef40e0ae33f5f216b66f670361f8f3b51574108fc58
    generator_version: '2'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '13'
    response_pending: []
    document_hash: sha256:e5e5f0ddc1f408f4efc5b1b1ef0d44cb4128275a724dbe57f5e8a09dda942bf4
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: oxylabs-llm-async
  x-aisa-catalogs:
    oxylabs-llm-async:
      title: Oxylabs Web Scraper — Push-Pull async (LLM sources)
      description: ''
      x-aisa-document:
        facts_hash: e7bf366c17cd89d03de75ef40e0ae33f5f216b66f670361f8f3b51574108fc58
        generator_version: '2'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/oxylabs/llm:
    post:
      summary: Oxylabs LLM (Push-Pull async) submit
      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.
      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:
              source: chatgpt
              prompt: What is the capital of France?
            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
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.