openapi: 3.1.0
info:
  title: Fast ACCOUNT_COSTS AGENTS API
  version: 0.1.0
tags:
- name: AGENTS
paths:
  /agents/v1/models:
    get:
      tags:
      - AGENTS
      summary: List Models
      description: List available models
      operationId: list_models_agents_v1_models_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Models'
      security:
      - HTTPBearer: []
      - HTTPBearer: []
  /agents/v1/chat/completions:
    post:
      tags:
      - AGENTS
      summary: Create Chat Completion
      description: 'Create a chat completion (OpenAI-compatible).


        Uses litellm with provider fallback: Azure GPT-5.5 → Anthropic Sonnet 4.6.

        The model in the request is ignored — provider selection is automatic.'
      operationId: create_chat_completion_agents_v1_chat_completions_post
      security:
      - HTTPBearer: []
      - HTTPBearer: []
      parameters:
      - name: x-session-id
        in: header
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 255
          - type: 'null'
          description: Optional opaque conversation identifier. When provided, the call's Langfuse trace is grouped under this session_id, letting a multi-turn agentic conversation appear as one timeline. Clients should pass the same value across every turn of a single conversation.
          title: X-Session-Id
        description: Optional opaque conversation identifier. When provided, the call's Langfuse trace is grouped under this session_id, letting a multi-turn agentic conversation appear as one timeline. Clients should pass the same value across every turn of a single conversation.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /agents/v1/embeddings:
    post:
      tags:
      - AGENTS
      summary: Create Embeddings
      description: Create embeddings using AWS Bedrock
      operationId: create_embeddings_agents_v1_embeddings_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EmbeddingsRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmbeddingsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      deprecated: true
      security:
      - HTTPBearer: []
      - HTTPBearer: []
components:
  schemas:
    Function:
      properties:
        name:
          type: string
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        parameters:
          title: Parameters
      type: object
      required:
      - name
      - parameters
      title: Function
    SystemMessage:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        role:
          type: string
          const: system
          title: Role
          default: system
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/TextContent'
            type: array
          title: Content
      type: object
      required:
      - content
      title: SystemMessage
    EmbeddingsRequest:
      properties:
        input:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
          - items:
              anyOf:
              - type: integer
              - items:
                  type: integer
                type: array
            type: array
          title: Input
        model:
          type: string
          title: Model
        encoding_format:
          type: string
          enum:
          - float
          - base64
          title: Encoding Format
          default: float
        dimensions:
          anyOf:
          - type: integer
          - type: 'null'
          title: Dimensions
        user:
          anyOf:
          - type: string
          - type: 'null'
          title: User
      type: object
      required:
      - input
      - model
      title: EmbeddingsRequest
    ImageContent:
      properties:
        type:
          type: string
          const: image_url
          title: Type
          default: image
        image_url:
          $ref: '#/components/schemas/ImageUrl'
        cache_control:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Cache Control
      type: object
      required:
      - image_url
      title: ImageContent
    ChatRequest:
      properties:
        messages:
          items:
            anyOf:
            - $ref: '#/components/schemas/SystemMessage'
            - $ref: '#/components/schemas/UserMessage'
            - $ref: '#/components/schemas/AssistantMessage'
            - $ref: '#/components/schemas/ToolMessage'
          type: array
          title: Messages
        model:
          type: string
          title: Model
          default: custom
        frequency_penalty:
          anyOf:
          - type: number
            maximum: 2.0
            minimum: -2.0
          - type: 'null'
          title: Frequency Penalty
          default: 0.0
        presence_penalty:
          anyOf:
          - type: number
            maximum: 2.0
            minimum: -2.0
          - type: 'null'
          title: Presence Penalty
          default: 0.0
        stream:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Stream
          default: false
        stream_options:
          anyOf:
          - $ref: '#/components/schemas/StreamOptions'
          - type: 'null'
        temperature:
          anyOf:
          - type: number
            maximum: 2.0
            minimum: 0.0
          - type: 'null'
          title: Temperature
          default: 1.0
        top_p:
          anyOf:
          - type: number
            maximum: 1.0
            minimum: 0.0
          - type: 'null'
          title: Top P
          default: 1.0
        user:
          anyOf:
          - type: string
          - type: 'null'
          title: User
        max_tokens:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Tokens
          default: 2048
        max_completion_tokens:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Completion Tokens
        reasoning_effort:
          anyOf:
          - type: string
            enum:
            - low
            - medium
            - high
          - type: 'null'
          title: Reasoning Effort
        n:
          anyOf:
          - type: integer
          - type: 'null'
          title: N
          default: 1
        tools:
          anyOf:
          - items:
              $ref: '#/components/schemas/Tool'
            type: array
          - type: 'null'
          title: Tools
        tool_choice:
          anyOf:
          - type: string
          - {}
          title: Tool Choice
          default: auto
        stop:
          anyOf:
          - items:
              type: string
            type: array
          - type: string
          - type: 'null'
          title: Stop
        extra_body:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Extra Body
      type: object
      required:
      - messages
      title: ChatRequest
    EmbeddingsUsage:
      properties:
        prompt_tokens:
          type: integer
          title: Prompt Tokens
        total_tokens:
          type: integer
          title: Total Tokens
      type: object
      required:
      - prompt_tokens
      - total_tokens
      title: EmbeddingsUsage
    EmbeddingsResponse:
      properties:
        object:
          type: string
          const: list
          title: Object
          default: list
        data:
          items:
            $ref: '#/components/schemas/Embedding'
          type: array
          title: Data
        model:
          type: string
          title: Model
        usage:
          $ref: '#/components/schemas/EmbeddingsUsage'
      type: object
      required:
      - data
      - model
      - usage
      title: EmbeddingsResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Tool:
      properties:
        type:
          type: string
          const: function
          title: Type
          default: function
        function:
          $ref: '#/components/schemas/Function'
      type: object
      required:
      - function
      title: Tool
    ResponseFunction:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        arguments:
          type: string
          title: Arguments
      type: object
      required:
      - arguments
      title: ResponseFunction
    TextContent:
      properties:
        type:
          type: string
          const: text
          title: Type
          default: text
        text:
          type: string
          title: Text
        cache_control:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Cache Control
      type: object
      required:
      - text
      title: TextContent
    ToolCall:
      properties:
        index:
          anyOf:
          - type: integer
          - type: 'null'
          title: Index
        id:
          anyOf:
          - type: string
          - type: 'null'
          title: Id
        type:
          type: string
          const: function
          title: Type
          default: function
        function:
          $ref: '#/components/schemas/ResponseFunction'
      type: object
      required:
      - function
      title: ToolCall
    UserMessage:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        role:
          type: string
          const: user
          title: Role
          default: user
        content:
          anyOf:
          - type: string
          - items:
              anyOf:
              - $ref: '#/components/schemas/TextContent'
              - $ref: '#/components/schemas/ImageContent'
            type: array
          title: Content
      type: object
      required:
      - content
      title: UserMessage
    ImageUrl:
      properties:
        url:
          type: string
          title: Url
        detail:
          anyOf:
          - type: string
          - type: 'null'
          title: Detail
          default: auto
      type: object
      required:
      - url
      title: ImageUrl
    ToolMessage:
      properties:
        role:
          type: string
          const: tool
          title: Role
          default: tool
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/ToolContent'
            type: array
          - items:
              additionalProperties: true
              type: object
            type: array
          title: Content
        tool_call_id:
          type: string
          title: Tool Call Id
      type: object
      required:
      - content
      - tool_call_id
      title: ToolMessage
    Models:
      properties:
        object:
          anyOf:
          - type: string
          - type: 'null'
          title: Object
          default: list
        data:
          items:
            $ref: '#/components/schemas/Model'
          type: array
          title: Data
          default: []
      type: object
      title: Models
    Embedding:
      properties:
        object:
          type: string
          const: embedding
          title: Object
          default: embedding
        embedding:
          anyOf:
          - items:
              type: number
            type: array
          - type: string
            format: binary
          title: Embedding
        index:
          type: integer
          title: Index
      type: object
      required:
      - embedding
      - index
      title: Embedding
    StreamOptions:
      properties:
        include_usage:
          type: boolean
          title: Include Usage
          default: true
      type: object
      title: StreamOptions
    Model:
      properties:
        id:
          type: string
          title: Id
        created:
          type: integer
          title: Created
        object:
          anyOf:
          - type: string
          - type: 'null'
          title: Object
          default: model
        owned_by:
          anyOf:
          - type: string
          - type: 'null'
          title: Owned By
          default: bedrock
      type: object
      required:
      - id
      title: Model
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ToolContent:
      properties:
        type:
          type: string
          const: text
          title: Type
          default: text
        text:
          type: string
          title: Text
      type: object
      required:
      - text
      title: ToolContent
    AssistantMessage:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        role:
          type: string
          const: assistant
          title: Role
          default: assistant
        content:
          anyOf:
          - type: string
          - items:
              anyOf:
              - $ref: '#/components/schemas/TextContent'
              - $ref: '#/components/schemas/ImageContent'
            type: array
          - type: 'null'
          title: Content
        tool_calls:
          anyOf:
          - items:
              $ref: '#/components/schemas/ToolCall'
            type: array
          - type: 'null'
          title: Tool Calls
      type: object
      title: AssistantMessage
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer