POST Gemini native generate

openapi: 3.1.0
info:
  title: ClearMaas API
  version: '2026.04'
  description: ClearMaas is an OpenAI-compatible API gateway.
  contact:
    name: ClearMaas Support
    email: support@clearmaas.com
    url: https://clearmaas.com
servers:
  - url: https://api.clearmaas.com
    description: Production
security:
  - bearerAuth: []
paths:
  /v1beta/models/{model_path}:
    post:
      tags:
        - Gemini Native
      summary: Gemini native generate
      operationId: geminiNativeAction
      parameters:
        - in: path
          name: model_path
          required: true
          schema:
            type: string
          example: google/gemini-2.5-flash:generateContent
          description: Model name with action suffix, e.g. google/gemini-2.5-flash:generateContent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Gemini-native request body (Google's GenerateContentRequest shape).
            example:
              contents:
                - role: user
                  parts:
                    - text: Write a one-sentence haiku about the sea.
      responses:
        '200':
          description: |
            Successful response. For `:generateContent` the body is JSON (GenerateContentResponse).
            For `:streamGenerateContent` the body is SSE (text/event-stream).
          content:
            application/json:
              schema:
                type: object
                description: Gemini-native GenerateContentResponse.
            text/event-stream:
              schema:
                type: string
                description: SSE stream of partial responses.
      servers:
        - url: https://api.clearmaas.com
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key (sk-...)
      description: |
        ClearMaas API keys look like `sk-...`. Pass them in the
        `Authorization: Bearer sk-...` header, or use `x-goog-api-key` / `?key=` for SDK compatibility.