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

# openrouter_models

> Run the openrouter_models tool. Returns a clean, normalized JSON shape.



## OpenAPI

````yaml /openapi.json post /v1/openrouter_models
openapi: 3.1.0
info:
  title: fetchbean API
  version: v1
  description: >-
    One key for external tools and durable agent work products, with HTTP,
    hosted MCP, exact file artifacts, and spend controls.
servers:
  - url: https://api.fetchbean.com
security:
  - apiKeyAuth: []
paths:
  /v1/openrouter_models:
    post:
      tags:
        - Tools
      summary: openrouter_models
      description: Run the openrouter_models tool. Returns a clean, normalized JSON shape.
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              additionalProperties: false
              type: object
              properties:
                q:
                  description: Search model name or slug.
                  type: string
                category:
                  anyOf:
                    - const: programming
                      type: string
                    - const: roleplay
                      type: string
                    - const: marketing
                      type: string
                    - const: marketing/seo
                      type: string
                    - const: technology
                      type: string
                    - const: science
                      type: string
                    - const: translation
                      type: string
                    - const: legal
                      type: string
                    - const: finance
                      type: string
                    - const: health
                      type: string
                    - const: trivia
                      type: string
                    - const: academia
                      type: string
                supported_parameters:
                  description: Comma-separated parameters such as tools,response_format.
                  type: string
                output_modalities:
                  description: >-
                    Comma-separated text, image, embeddings, audio, video,
                    rerank, speech or transcription; use all for every model.
                  type: string
                input_modalities:
                  description: Comma-separated text, image, audio or file.
                  type: string
                context:
                  minimum: 1
                  description: Minimum context length in tokens.
                  type: integer
                sort:
                  anyOf:
                    - const: most-popular
                      type: string
                    - const: newest
                      type: string
                    - const: top-weekly
                      type: string
                    - const: pricing-low-to-high
                      type: string
                    - const: pricing-high-to-low
                      type: string
                    - const: context-high-to-low
                      type: string
                    - const: throughput-high-to-low
                      type: string
                    - const: latency-low-to-high
                      type: string
                    - const: intelligence-high-to-low
                      type: string
                    - const: coding-high-to-low
                      type: string
                    - const: agentic-high-to-low
                      type: string
                    - const: design-arena-elo-high-to-low
                      type: string
                min_price:
                  minimum: 0
                  description: Minimum prompt price in USD per million tokens.
                  type: number
                max_price:
                  minimum: 0
                  description: Maximum prompt price in USD per million tokens.
                  type: number
                arch:
                  type: string
                model_authors:
                  description: Comma-separated author slugs.
                  type: string
                providers:
                  description: Comma-separated hosting provider names.
                  type: string
                distillable:
                  type: boolean
                zdr:
                  description: Only models with a zero-data-retention endpoint.
                  const: true
                  type: boolean
                region:
                  anyOf:
                    - const: eu
                      type: string
                    - const: us
                      type: string
                min_output_price:
                  minimum: 0
                  type: number
                max_output_price:
                  minimum: 0
                  type: number
                min_age_days:
                  minimum: 0
                  type: integer
                max_age_days:
                  minimum: 0
                  type: integer
                min_intelligence_index:
                  minimum: 0
                  type: number
                max_intelligence_index:
                  minimum: 0
                  type: number
                min_coding_index:
                  minimum: 0
                  type: number
                max_coding_index:
                  minimum: 0
                  type: number
                min_agentic_index:
                  minimum: 0
                  type: number
                max_agentic_index:
                  minimum: 0
                  type: number
                min_tool_success_rate:
                  minimum: 0
                  maximum: 1
                  type: number
                max_tool_success_rate:
                  minimum: 0
                  maximum: 1
                  type: number
                free_only:
                  default: false
                  description: Only exact :free variants and the openrouter/free router.
                  type: boolean
                offset:
                  minimum: 0
                  type: integer
                limit:
                  minimum: 1
                  maximum: 1000
                  type: integer
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Insufficient credits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      description: >-
        A caller-generated key for safely retrying this execution after a
        network failure. Reusing the same key with the same operation and input
        returns the original result; reusing it for a different call is
        rejected.
      schema:
        type: string
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
            billable:
              type: boolean
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Your fetchbean API key (fb_…). Keys are not accepted through
        Authorization.

````