cheapestinference-com api API

openapi: 3.1.0
info:
  title: cheapestinference-com api API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 36 operation(s) read from 8 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/api/anthropic-messages
  - https://cheapestinference.com/docs/api/billing
  - https://cheapestinference.com/docs/api/chat-completions
  - https://cheapestinference.com/docs/api/keys
  - https://cheapestinference.com/docs/api/reasoning
  - https://cheapestinference.com/docs/api/streaming
  - https://cheapestinference.com/docs/api/unlimited-subscriptions
  - https://cheapestinference.com/docs/api/usage
  x-docs-section: api
servers:
- url: https://api.cheapestinference.com
paths:
  /anthropic:
    get:
      operationId: get_anthropic
      tags:
      - Anthropic
      summary: GET /anthropic
      x-source: https://cheapestinference.com/docs/api/anthropic-messages
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAnthropicResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Python Node.js Response All models supported On this page Overview Endpoint SDK base URL Request body Example cURL Python\
          \ Node.js Response All models supported Anthropic Messages Endpoint Section titled “Endpoint” \n POST /anthropic/v1/messages \n Fully\
          \ compatible with the Anthropic Messages API. \n SDK base URL Section titled “SDK base URL” \n When using the Anthropic SDK, set the\
          \ base URL to: \n"
  /anthropic/v1/messages:
    get:
      operationId: get_anthropic_v1_messages
      tags:
      - Anthropic
      summary: GET /anthropic/v1/messages
      x-source: https://cheapestinference.com/docs/api/anthropic-messages
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAnthropicV1MessagesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Section titled “cURL” \n Terminal window curl https://api.cheapestinference.com/anthropic/v1/messages \\ -H \" x-api-key:\
          \ YOUR_API_KEY \" \\ -H \" Content-Type: application/json \" \\ -H \" anthropic-version: 2023-06-01 \" \\ -d ' { \"model\": \"glm-5.3\"\
          , \"max_tokens\": 1024, \"messages\": [ {\"role\": \"user\", \"content\": \"Hello!\"} ] } ' \n Python Section titled “Python” \n from\
          \ anthropic import Anthropic \n client"
    post:
      operationId: post_anthropic_v1_messages
      tags:
      - Anthropic
      summary: Models can produce internal reasoning (step-by-step thinking) before their final answer.
      x-source: https://cheapestinference.com/docs/api/reasoning
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAnthropicV1MessagesRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostAnthropicV1MessagesResponse'
      x-evidence:
        kind: documentation
  /api/billing/cancel-pool/{pledgeid}:
    post:
      operationId: post_api_billing_cancel_pool_pledgeid
      tags:
      - Api
      summary: Cancels a pool subscription.
      x-source: https://cheapestinference.com/docs/api/billing
      parameters:
      - name: pledgeid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiBillingCancelPoolPledgeidResponse'
      x-evidence:
        kind: documentation
  /api/billing/payment-address:
    get:
      operationId: get_api_billing_payment_address
      tags:
      - Api
      summary: Returns the USDC payment address and chain for direct payments.
      x-source: https://cheapestinference.com/docs/api/billing
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBillingPaymentAddressResponse'
      x-evidence:
        kind: documentation
  /api/billing/payment-methods:
    get:
      operationId: get_api_billing_payment_methods
      tags:
      - Api
      summary: List saved payment methods.
      x-source: https://cheapestinference.com/docs/api/billing
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiBillingPaymentMethodsResponse'
      x-evidence:
        kind: documentation
  /api/billing/payment-methods/{id}:
    delete:
      operationId: delete_api_billing_payment_methods_id
      tags:
      - Api
      summary: Remove a payment method.
      x-source: https://cheapestinference.com/docs/api/billing
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteApiBillingPaymentMethodsIdResponse'
      x-evidence:
        kind: documentation
  /api/billing/portal:
    post:
      operationId: post_api_billing_portal
      tags:
      - Api
      summary: Opens the Stripe Customer Portal for managing invoices and payment methods.
      x-source: https://cheapestinference.com/docs/api/billing
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiBillingPortalResponse'
      x-evidence:
        kind: documentation
  /api/billing/setup-checkout:
    post:
      operationId: post_api_billing_setup_checkout
      tags:
      - Api
      summary: Returns a Stripe-hosted URL to add a card and billing address.
      x-source: https://cheapestinference.com/docs/api/billing
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiBillingSetupCheckoutResponse'
      x-evidence:
        kind: documentation
  /api/billing/setup-intent:
    post:
      operationId: post_api_billing_setup_intent
      tags:
      - Api
      summary: Returns a Stripe clientSecret to collect card details client-side via Stripe.js.
      x-source: https://cheapestinference.com/docs/api/billing
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiBillingSetupIntentResponse'
      x-evidence:
        kind: documentation
  /api/billing/status:
    get:
      operationId: get_api_billing_status
      tags:
      - Api
      summary: GET /api/billing/status
      x-source: https://cheapestinference.com/docs/api/keys
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://api.cheapestinference.com/api/billing/status \ -H " Authorization: Bearer mk_a1b2c3d4e5f6g7h8i9j0... " '
  /api/billing/transactions:
    get:
      operationId: get_api_billing_transactions
      tags:
      - Api
      summary: Returns payment history.
      x-source: https://cheapestinference.com/docs/api/billing
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/keys:
    get:
      operationId: get_api_keys
      tags:
      - Api
      summary: Returns all consumption keys for the authenticated user.
      x-source: https://cheapestinference.com/docs/api/keys
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiKeysResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_keys
      tags:
      - Api
      summary: POST /api/keys
      x-source: https://cheapestinference.com/docs/api/keys
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiKeysResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.cheapestinference.com/api/keys \\ -H \" Authorization: Bearer YOUR_AUTH_TOKEN \" \n Response Section titled\
          \ “Response” \n { \"success\" : true , \"data\" : [ { \"id\" : \" clx1abc... \" , \"name\" : \" prod-key \" , \"keyPlan\" : \" pool\
          \ \" , \"keyType\" : \" subscription \" , \"apiKey\" : \" sk-... \" , \"isActive\" : true , \"subscriptionId\" : \" sub-uuid \" , \"\
          subscriptionStatus\" : \" active \" , \"subscriptionExp"
  /api/keys/{id}:
    put:
      operationId: put_api_keys_id
      tags:
      - Api
      summary: Update a key's name or active status.
      x-source: https://cheapestinference.com/docs/api/keys
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutApiKeysIdRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/keys/management:
    get:
      operationId: get_api_keys_management
      tags:
      - Api
      summary: List management keys.
      x-source: https://cheapestinference.com/docs/api/keys
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiKeysManagementResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_keys_management
      tags:
      - Api
      summary: Create a management key.
      x-source: https://cheapestinference.com/docs/api/keys
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiKeysManagementRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiKeysManagementResponse'
      x-evidence:
        kind: documentation
  /api/keys/management/{id}:
    delete:
      operationId: delete_api_keys_management_id
      tags:
      - Api
      summary: Delete management key.
      x-source: https://cheapestinference.com/docs/api/keys
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/keys/subscription:
    post:
      operationId: post_api_keys_subscription
      tags:
      - Api
      summary: POST /api/keys/subscription
      x-source: https://cheapestinference.com/docs/api/keys
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.cheapestinference.com/api/keys/subscription \\ -H \" Authorization: Bearer mk_a1b2c3d4e5f6g7h8i9j0...\
          \ \" \\ -H \" Content-Type: application/json \" \\ -d ' {\"name\": \"auto-created\"} ' \n Management keys cannot be used for inference.\
          \ Use consumption keys ( sk-... ) for that. \n Key lifecycle Section titled “Key lifecycle” \n Subscription keys Section titled “Subscription\
          \ keys” \n Subsc"
  /api/meta-keys:
    post:
      operationId: post_api_meta_keys
      tags:
      - Api
      summary: Create a combined key spanning two or more subscriptions under one credential.
      x-source: https://cheapestinference.com/docs/api/keys
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiMetaKeysRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiMetaKeysResponse'
      x-evidence:
        kind: documentation
  /api/meta-keys/mk_uuid:
    delete:
      operationId: delete_api_meta_keys_mk_uuid
      tags:
      - Api
      summary: Delete a combined key.
      x-source: https://cheapestinference.com/docs/api/keys
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteApiMetaKeysMkUuidResponse'
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_api_meta_keys_mk_uuid
      tags:
      - Api
      summary: Rename a combined key.
      x-source: https://cheapestinference.com/docs/api/keys
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchApiMetaKeysMkUuidRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchApiMetaKeysMkUuidResponse'
      x-evidence:
        kind: documentation
  /api/meta-keys/mk_uuid/member-roles:
    patch:
      operationId: patch_api_meta_keys_mk_uuid_member_roles
      tags:
      - Api
      summary: Change member roles for a combined key.
      x-source: https://cheapestinference.com/docs/api/keys
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchApiMetaKeysMkUuidMemberRolesRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchApiMetaKeysMkUuidMemberRolesResponse'
      x-evidence:
        kind: documentation
  /api/meta-keys/mk_uuid/members:
    put:
      operationId: put_api_meta_keys_mk_uuid_members
      tags:
      - Api
      summary: Update members of a combined key.
      x-source: https://cheapestinference.com/docs/api/keys
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutApiMetaKeysMkUuidMembersRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PutApiMetaKeysMkUuidMembersResponse'
      x-evidence:
        kind: documentation
  /api/pools:
    get:
      operationId: get_api_pools
      tags:
      - Api
      summary: GET /api/pools
      x-source: https://cheapestinference.com/docs/api/billing
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiPoolsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://api.cheapestinference.com/api/pools \ -H " Authorization: Bearer mk_your_key " '
    post:
      operationId: post_api_pools
      tags:
      - Api
      summary: POST /api/pools
      x-source: https://cheapestinference.com/docs/api/unlimited-subscriptions
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.cheapestinference.com/api/pools \\ -H \" Authorization: Bearer mk_your_key \" \n { \"success\" : true , \"\
          data\" : [ { \"id\" : \" pool_uuid \" , \"slug\" : \" minimax-m3 \" , \"modelId\" : \" minimax-m3 \" , \"modelName\" : \" MiniMax M3\
          \ \" , \"description\" : \" Dedicated MiniMax M3 with unlimited usage. \" , \"status\" : \" active \" , \"totalSlots\" : 10 , \"minPricePerDay\"\
          \ : \" 39.00 \" , \"manualProvisioning\" : "
  /api/pools/{id}/my-keys:
    get:
      operationId: get_api_pools_id_my_keys
      tags:
      - Api
      summary: Returns all API keys from all your subscriptions on this pool.
      x-source: https://cheapestinference.com/docs/api/unlimited-subscriptions
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/pools/{id}/my-subscriptions:
    get:
      operationId: get_api_pools_id_my_subscriptions
      tags:
      - Api
      summary: Returns all your active subscriptions for this pool.
      x-source: https://cheapestinference.com/docs/api/unlimited-subscriptions
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiPoolsIdMySubscriptionsResponse'
      x-evidence:
        kind: documentation
  /api/pools/{id}/pledge:
    delete:
      operationId: delete_api_pools_id_pledge
      tags:
      - Api
      summary: Cancels your most recent subscription.
      x-source: https://cheapestinference.com/docs/api/unlimited-subscriptions
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteApiPoolsIdPledgeResponse'
      x-evidence:
        kind: documentation
  /api/pools/{slug}/my-pledge:
    get:
      operationId: get_api_pools_slug_my_pledge
      tags:
      - Api
      summary: Get the user's pledge for a pool by slug.
      x-source: https://cheapestinference.com/docs/api/billing
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/usage:
    get:
      operationId: get_api_usage
      tags:
      - Api
      summary: Returns all your keys with usage stats across 4 time periods and subscription info.
      x-source: https://cheapestinference.com/docs/api/usage
      parameters:
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer token with management key (mk_...)
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiUsageResponse'
      x-evidence:
        kind: documentation
  /api/usage/{keyid}:
    get:
      operationId: get_api_usage_keyid
      tags:
      - Api
      summary: Returns info for a specific key (by UUID).
      x-source: https://cheapestinference.com/docs/api/usage
      parameters:
      - name: keyid
        in: path
        required: true
        schema:
          type: string
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer token with management key (mk_...)
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiUsageKeyidResponse'
      x-evidence:
        kind: documentation
  /v1/chat/completions:
    get:
      operationId: get_v1_chat_completions
      tags:
      - Chat
      summary: GET /v1/chat/completions
      x-source: https://cheapestinference.com/docs/api/streaming
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl Section titled “cURL” \n Terminal window curl https://api.cheapestinference.com/v1/chat/completions \\ -H \" Authorization:\
          \ Bearer YOUR_API_KEY \" \\ -H \" Content-Type: application/json \" \\ -d ' { \"model\": \"glm-5.3\", \"messages\": [{\"role\": \"user\"\
          , \"content\": \"Write a haiku about coding\"}], \"stream\": true } ' \n Python Section titled “Python” \n stream = client.chat.completions.\
          \ create ( model = \" glm"
    post:
      operationId: post_v1_chat_completions
      tags:
      - Chat
      summary: Models can produce internal reasoning (step-by-step thinking) before their final answer.
      x-source: https://cheapestinference.com/docs/api/reasoning
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ChatCompletionsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1ChatCompletionsResponse'
      x-evidence:
        kind: documentation
  /v1/models:
    get:
      operationId: get_v1_models
      tags:
      - Models
      summary: Any model returned by GET /v1/models can be used.
      x-source: https://cheapestinference.com/docs/api/chat-completions
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/usage:
    get:
      operationId: get_v1_usage
      tags:
      - Usage
      summary: GET /v1/usage
      x-source: https://cheapestinference.com/docs/api/usage
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1UsageResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.cheapestinference.com/v1/usage \\ -H \" Authorization: Bearer sk-xxxxxxxxxxxxxxxx \" \n Response Section titled\
          \ “Response” \n { \"plan\" : { \"slug\" : \" frontier \" , \"status\" : \" active \" , \"expires_at\" : \" 2026-02-15T10:00:00.000Z\
          \ \" }, \"key\" : { \"name\" : \" prod-key \" , \"type\" : \" subscription \" , \"created_at\" : \" 2026-01-15T10:00:00.000Z \" } }\
          \ \n Field Description plan.slug Pool slug (e.g"
security:


# --- truncated at 32 KB (36 KB total) ---
# Full source: https://artifacts.apis.io/cheapestinference-com/openapi/_ae-authored/cheapestinference-com-api-openapi-generated.yml