cheapestinference-com guides API

openapi: 3.1.0
info:
  title: cheapestinference-com guides API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 6 operation(s) read from 4 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; cheapestinference-com has published no machine-readable contract
    that the pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 14
    documentation: 29
    pages-with-code: 23
    pages-read: 28
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://cheapestinference.com/docs/guides/add-llm-to-saas
  - https://cheapestinference.com/docs/guides/agent-subscriptions
  - https://cheapestinference.com/docs/guides/management-api
  - https://cheapestinference.com/docs/guides/x402
  x-docs-section: guides
servers:
- url: https://api.cheapestinference.com
paths:
  /.well-known/agent.json:
    get:
      operationId: get_well_known_agent_json
      tags:
      - API
      summary: Serves an agent card that advertises available skills, supported auth methods, streaming capability, and API endpoint URL following
        the Google A2A protocol.
      x-source: https://cheapestinference.com/docs/guides/x402
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWellKnownAgentJsonResponse'
      x-evidence:
        kind: documentation
  /api/agent/plans:
    get:
      operationId: get_api_agent_plans
      tags:
      - Api
      summary: Get the live catalog with pricing information for agent subscription blocks.
      x-source: https://cheapestinference.com/docs/guides/agent-subscriptions
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgentPlansResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_agent_plans
      tags:
      - Api
      summary: POST /api/agent/plans
      x-source: https://cheapestinference.com/docs/guides/agent-subscriptions
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiAgentPlansResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.cheapestinference.com/api/agent/plans \n 2. Pay USDC on Base Section titled “2. Pay USDC on Base” \n Send the\
          \ summed amount of your chosen blocks, in USDC, to the payTo address from the catalog, on Base. Keep the transaction hash. Wait for\
          \ the transaction to reach a few confirmations before claiming — a just-mined transaction is not yet final and the claim will ask you\
          \ to retry. \n 3"
  /api/agent/subscribe-pool:
    post:
      operationId: post_api_agent_subscribe_pool
      tags:
      - Api
      summary: Claim an API key by providing transaction hash, pool slug, blocks, and wallet signature.
      x-source: https://cheapestinference.com/docs/guides/agent-subscriptions
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiAgentSubscribePoolRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiAgentSubscribePoolResponse'
      x-evidence:
        kind: documentation
  /api/pools/frontier/my-keys:
    post:
      operationId: post_api_pools_frontier_my_keys
      tags:
      - Api
      summary: POST /api/pools/frontier/my-keys
      x-source: https://cheapestinference.com/docs/guides/add-llm-to-saas
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.cheapestinference.com/api/pools/frontier/my-keys \\ -H \" Authorization: Bearer mk_your_management_key \" \n\
          \ To add a user to another time block: \n Terminal window # Subscribe to europe block for a new user SUB = $( curl -s -X POST https://api.cheapestinference.com/api/pools/frontier/subscribe\
          \ \\ -H \" Authorization: Bearer mk_your_management_key \" \\ -H \" Content-Type: application/json "
  /api/pools/{poolslug}/my-subscriptions:
    delete:
      operationId: delete_api_pools_poolslug_my_subscriptions
      tags:
      - Api
      summary: DELETE /api/pools/{poolSlug}/my-subscriptions
      x-source: https://cheapestinference.com/docs/guides/management-api
      parameters:
      - name: poolslug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.cheapestinference.com/api/pools/POOL_SLUG/my-subscriptions \\ -H \" Authorization: Bearer mk_your_management_key\
          \ \" \n 6. Cancel a subscription Section titled “6. Cancel a subscription” \n Terminal window # Cancel a pool subscription curl -X DELETE\
          \ https://api.cheapestinference.com/api/pools/POOL_ID/pledge \\ -H \" Authorization: Bearer mk_your_management_key \" \n This flips\
          \ cancelAtPerio"
security:
- bearer: []
components:
  schemas:
    GetWellKnownAgentJsonResponse:
      type: object
      properties:
        skills:
          type: array
          description: Available skills (inference, model listing)
        auth_methods:
          type: array
          description: Supported auth methods (bearer key, x402)
        streaming_capability:
          type: boolean
          description: Streaming capability
        api_endpoint_url:
          type: string
          description: API endpoint URL
    GetApiAgentPlansResponse:
      type: object
      properties:
        blocks:
          type: array
          description: Array of subscription blocks with pricing information
        blocks[].priceUsdc:
          type: string
          description: Price in USDC for each block
        payTo:
          type: string
          description: Wallet address to send USDC payment to on Base
    PostApiAgentPlansResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
          properties:
            apiKey:
              type: string
            pool:
              type: string
            blocks:
              type: array
              items:
                type: string
            amountUsdc:
              type: string
            expiresAt:
              type: string
            walletAddress:
              type: string
            status:
              type: string
    PostApiAgentSubscribePoolRequest:
      type: object
      properties:
        txHash:
          type: string
          description: USDC transaction hash on Base
        poolSlug:
          type: string
          description: Pool identifier (e.g., 'frontier')
        blocks:
          type: array
          description: Array of block names (e.g., ['asia'])
        signature:
          type: string
          description: Signed message proving wallet ownership
      required:
      - txHash
      - poolSlug
      - blocks
      - signature
    PostApiAgentSubscribePoolResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Whether the claim was successful
        data:
          type: object
          description: Subscription details
        data.apiKey:
          type: string
          description: The issued API key for using the service
        data.pool:
          type: string
          description: Pool identifier
        data.blocks:
          type: array
          description: Blocks included in the subscription
        data.amountUsdc:
          type: string
          description: Amount paid in USDC
        data.expiresAt:
          type: string
          description: Subscription expiration timestamp
        data.walletAddress:
          type: string
          description: Wallet address that paid
        data.status:
          type: string
          description: Subscription status (e.g., 'active')
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
tags:
- name: API
- name: Api