{
  "openapi": "3.1.0",
  "info": {
    "title": "Omneity Public API",
    "version": "2026-10-25",
    "description": "Public API request and response contract. See the platform documentation for current prices and account limits. API responses use private, no-store, no-transform. Revalidate this OpenAPI document after 60 seconds."
  },
  "servers": [
    {
      "url": "https://api.sawalni.com"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "paths": {
    "/v1/models": {
      "get": {
        "operationId": "get_v1_models",
        "summary": "List available model aliases",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "List available model aliases",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Model visibility does not guarantee entitlement or healthy capacity."
      }
    },
    "/v1/account/usage": {
      "get": {
        "operationId": "get_v1_account_usage",
        "summary": "Read account usage and rate limits",
        "tags": [
          "Billing"
        ],
        "responses": {
          "200": {
            "description": "Read account usage and rate limits",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountUsage"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Authenticated account only. Returns usage, allowances and tier progress shared across account API keys. Optional tier_assignment separates the spending-qualified tier, manual override from the effective quota tier. Overrides do not reset usage or change credits or model access. Removing one restores the spending tier. Without an override, qualifying spending determines the effective tier automatically. Spending calculations refresh within five minutes; removing an override refreshes them immediately. Text-only chat quota and credit reservations use actual model input-token counts, including message formatting and tools. Embedding quota and credit reservations use actual processed input-token counts. Media usage is checked before delivery when it is unavailable in advance. Encoded media size is not a token estimate. Text-only content arrays support streaming. Minute and hour windows roll continuously. Calendar days and months use UTC. Audio quantities use milliseconds. A null limit means no account quota. Used and reserved amounts are separate. Confirmed credit purchases minus refunds determine spending progress. Spending-based tier changes are automatic. Token policy account-tiers-20261114-v11: Tier 0 through Tier 5 daily token budgets are 256000, 1000000, 2000000, 4000000, 16000000 and 64000000; monthly token budgets are 1000000, 10000000, 30000000, 60000000, 240000000 and 1000000000. Existing usage remains counted after policy changes. An administrative quota reset restarts current allowances while retaining measured usage and historical statistics; used quota can therefore differ from historical totals. Successful requests with a verified zero credit price settle without a debit. Their measured usage still counts against applicable quotas. See the rate-limits guide for rolling-window limits and other quotas."
      }
    },
    "/v1/billing/balance": {
      "get": {
        "operationId": "get_v1_billing_balance",
        "summary": "Read the current credit balance",
        "tags": [
          "Billing"
        ],
        "responses": {
          "200": {
            "description": "Read the current credit balance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BalanceResponse"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        }
      }
    },
    "/v1/billing/transactions": {
      "get": {
        "operationId": "get_v1_billing_transactions",
        "summary": "Read credit transactions",
        "tags": [
          "Billing"
        ],
        "responses": {
          "200": {
            "description": "Read credit transactions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TransactionPage"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Authenticated account only. Returns newest entries first. Pass next_cursor as before to continue. Credits are exact decimal strings. Legacy entries can lack API and consumption details. Read-only; no charge for this route. Credit holds are separate from charges. Unknown interrupted usage can require verified reconciliation before a pending hold is released.",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 25
            }
          },
          {
            "name": "before",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^[0-9]{1,20}-[0-9]{1,20}$"
            }
          }
        ]
      }
    },
    "/v1/chat/completions": {
      "post": {
        "operationId": "post_v1_chat_completions",
        "summary": "Generate a completion",
        "tags": [
          "Chat"
        ],
        "responses": {
          "200": {
            "description": "Generate a completion",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChatResponse"
                }
              },
              "text/event-stream": {
                "schema": {
                  "type": "string"
                },
                "example": "data: {\"choices\":[{\"delta\":{\"content\":\"Hello\"}}]}\n\ndata: [DONE]\n\n"
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "OpenAI-compatible text and tool calls. During the open-access experiment started 14 November 2026, public Sawalni and Sawalni Mini aliases are available to all authenticated API accounts without a model entitlement. Existing grants and pending requests are not modified. Hidden/internal models retain their restrictions. Authentication, key scopes, billing and quotas still apply. Multimodal support depends on the selected model. Media uses actual input-token counts where available. When final usage is required before delivery, SSE is buffered and returns X-Sawalni-Delivery-Mode: buffered-for-quota-validation. Audio-output SSE on quota-bound tiers uses the same buffered delivery. Missing non-streaming usage returns HTTP 503. Missing streaming usage emits token_usage_unavailable before [DONE]. Reservations are not substituted for actual usage. Unknown fields are rejected. Use POST /v1/language/translate for translation models. Streaming responses use server-sent events and can include comment keepalives. A stream failure emits an error with code, message and status, followed by [DONE]. Context limits depend on the model. Requests exceeding supported context return HTTP 400 with input_tokens, context_limit, requested_output_tokens and available_output_tokens. Explicit impossible text context is rejected before quota and credit admission; input and explicit output limits are not silently trimmed. Chat admission waits up to five seconds for available model capacity before token counting. If capacity remains busy, HTTP 429 returns model_capacity_exhausted, resource=model_capacity, retry_policy=wait_for_capacity, reset_at=null and Retry-After: 2. This is separate from account quota. No product quota or credit reservation is consumed before this admission succeeds. HTTP 503 with model_unavailable means no healthy model service; token_count_unavailable means exact input counting failed. Temporary infrastructure unavailability can also return HTTP 503.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChatRequest"
              },
              "example": {
                "model": "sawalni-mini-beta",
                "messages": [
                  {
                    "role": "user",
                    "content": "Explain this in Darija."
                  }
                ]
              }
            }
          }
        }
      }
    },
    "/v1/language/translate": {
      "post": {
        "operationId": "post_v1_language_translate",
        "summary": "Translate text",
        "tags": [
          "Translation"
        ],
        "responses": {
          "200": {
            "description": "Translate text",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TranslationResponse"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Available to all authenticated API users without a model entitlement. Account quotas and billing apply. During the open-access experiment, Sawalni and Sawalni Mini also need no model entitlement. API keys, scopes, credits and quotas remain required. Translation-only API for Mini v4 and Nano v3. Send text, source and target language codes. Mini v4 accepts optional instructions and reference examples. Nano supports Moroccan Arabic to English, French or Modern Standard Arabic and rejects nonempty instructions. Chat messages, tools, history, streaming and generation controls are not accepted. Mini has a 2048-token output cap; Nano has a 512-token output cap. Split long passages at paragraph or sentence boundaries. A response with data.complete=false is incomplete. Translation quality varies by language pair.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TranslationRequest"
              },
              "examples": {
                "mini": {
                  "summary": "Standard multilingual translation",
                  "value": {
                    "model": "tarjamli-mini-v4",
                    "text": "The workspace is ready.",
                    "source": "eng_Latn",
                    "target": "fra_Latn"
                  }
                },
                "mini_instructions": {
                  "summary": "Instructions, glossary and reference example",
                  "value": {
                    "model": "tarjamli-mini-v4",
                    "text": "The Atlas workspace is ready.",
                    "source": "eng_Latn",
                    "target": "fra_Latn",
                    "instructions": "Use formal French. Keep Atlas unchanged. Glossary: workspace → espace de travail. Example: The workspace is open. → L’espace de travail est ouvert."
                  }
                },
                "nano": {
                  "summary": "Fast Darija translation",
                  "value": {
                    "model": "tarjamli-nano-v3",
                    "text": "سلام كيف داير؟",
                    "source": "ary_Arab",
                    "target": "eng_Latn"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/embeddings": {
      "post": {
        "operationId": "post_v1_embeddings",
        "summary": "embeddings",
        "tags": [
          "Embeddings"
        ],
        "responses": {
          "200": {
            "description": "embeddings",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmbeddingResponse"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Quota and credit reservations use actual processed input-token counts, including model truncation. Usage is required before delivery. Input byte length is not a token estimate. Account batch limits apply.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EmbeddingRequest"
              },
              "example": {
                "model": "madmon-beta",
                "input": [
                  "A document"
                ]
              }
            }
          }
        }
      }
    },
    "/v1/language/identify": {
      "post": {
        "operationId": "post_v1_language_identify",
        "summary": "language identify",
        "tags": [
          "Language"
        ],
        "responses": {
          "200": {
            "description": "language identify",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IdentifyResponse"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Temporary unavailability returns HTTP 503. Timeouts return HTTP 504. Retry with backoff. Failed identification requests release their credit reservations and do not consume credits.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IdentifyRequest"
              },
              "example": {
                "model": "gherbal-v4",
                "input": "salam kif dayr?",
                "top": 3
              }
            }
          }
        }
      }
    },
    "/v1/language/encode": {
      "post": {
        "operationId": "post_v1_language_encode",
        "summary": "language encode",
        "tags": [
          "Language"
        ],
        "responses": {
          "200": {
            "description": "language encode",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EncodeResponse"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EncodeRequest"
              },
              "example": {
                "model": "sawtone-v4",
                "input": [
                  "دار",
                  "dar"
                ],
                "channel": "composite"
              }
            }
          }
        }
      }
    },
    "/v1/language/transliterate": {
      "post": {
        "operationId": "post_v1_language_transliterate",
        "summary": "language transliterate",
        "tags": [
          "Language"
        ],
        "responses": {
          "200": {
            "description": "language transliterate",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Requests can time out after 95 seconds. HTTP 503 indicates temporary unavailability; observe Retry-After. HTTP 504 indicates a timeout; retry with shorter input.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RescriptRequest"
              },
              "example": {
                "model": "rescript-v1",
                "input": "salam",
                "target_code": "ary_Arab",
                "max_candidates": 3
              }
            }
          }
        }
      }
    },
    "/v1/language/rescript": {
      "post": {
        "operationId": "post_v1_language_rescript",
        "summary": "language rescript",
        "tags": [
          "Language"
        ],
        "responses": {
          "200": {
            "description": "language rescript",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Requests can time out after 95 seconds. HTTP 503 indicates temporary unavailability; observe Retry-After. HTTP 504 indicates a timeout; retry with shorter input.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RescriptRequest"
              }
            }
          }
        }
      }
    },
    "/v1/language/rhyme/score": {
      "post": {
        "operationId": "post_v1_language_rhyme_score",
        "summary": "language rhyme score",
        "tags": [
          "Lyrics"
        ],
        "responses": {
          "200": {
            "description": "language rhyme score",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RhymeScoreRequest"
              },
              "example": {
                "pairs": [
                  [
                    "moon",
                    "tune"
                  ]
                ],
                "language": "eng_Latn"
              }
            }
          }
        }
      }
    },
    "/v1/language/rhyme/search": {
      "post": {
        "operationId": "post_v1_language_rhyme_search",
        "summary": "language rhyme search",
        "tags": [
          "Lyrics"
        ],
        "responses": {
          "200": {
            "description": "language rhyme search",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RhymeSearchRequest"
              },
              "example": {
                "query": "rain",
                "language": "eng_Latn",
                "top_k": 10
              }
            }
          }
        }
      }
    },
    "/v1/language/lyrics/suggest-replacements": {
      "post": {
        "operationId": "post_v1_language_lyrics_suggest-replacements",
        "summary": "language lyrics suggest-replacements",
        "tags": [
          "Lyrics"
        ],
        "responses": {
          "200": {
            "description": "language lyrics suggest-replacements",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LyricReplaceRequest"
              },
              "example": {
                "line": "I keep my heart above the rain",
                "target": "rain",
                "language": "eng_Latn"
              }
            }
          }
        }
      }
    },
    "/v1/language/lyrics/score": {
      "post": {
        "operationId": "post_v1_language_lyrics_score",
        "summary": "language lyrics score",
        "tags": [
          "Lyrics"
        ],
        "responses": {
          "200": {
            "description": "language lyrics score",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LyricScoreRequest"
              },
              "example": {
                "text": "I wait in rain\nI take the train",
                "language": "eng_Latn"
              }
            }
          }
        }
      }
    },
    "/v1/tarakib/analyze": {
      "post": {
        "operationId": "post_v1_tarakib_analyze",
        "summary": "tarakib analyze",
        "tags": [
          "Grammar"
        ],
        "responses": {
          "200": {
            "description": "tarakib analyze",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TarakibRequest"
              },
              "example": {
                "text": "ذهب الطفل إلى المدرسة.",
                "language": "ar"
              }
            }
          }
        }
      }
    },
    "/v1/maktaba/search": {
      "post": {
        "operationId": "post_v1_maktaba_search",
        "summary": "maktaba search",
        "tags": [
          "Search"
        ],
        "responses": {
          "200": {
            "description": "maktaba search",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SearchRequest"
              },
              "example": {
                "query": "Morocco solar energy",
                "limit": 5
              }
            }
          }
        }
      }
    },
    "/v1/maktaba/social/search": {
      "post": {
        "operationId": "post_v1_maktaba_social_search",
        "summary": "maktaba social search",
        "tags": [
          "Search"
        ],
        "responses": {
          "200": {
            "description": "maktaba social search",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SocialRequest"
              },
              "example": {
                "query": "solar energy",
                "limit": 5
              }
            }
          }
        }
      }
    },
    "/v1/maktaba/research": {
      "post": {
        "operationId": "post_v1_maktaba_research",
        "summary": "maktaba research",
        "tags": [
          "Search"
        ],
        "responses": {
          "200": {
            "description": "maktaba research",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResearchRequest"
              },
              "example": {
                "task": "Research Morocco solar energy with sources",
                "mode": "deep"
              }
            }
          }
        }
      }
    },
    "/v1/akhbar/search": {
      "post": {
        "operationId": "post_v1_akhbar_search",
        "summary": "akhbar search",
        "tags": [
          "News"
        ],
        "responses": {
          "200": {
            "description": "akhbar search",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NewsSearchRequest"
              },
              "example": {
                "query": "الطاقة الشمسية",
                "limit": 10
              }
            }
          }
        }
      }
    },
    "/v1/tarakib/models": {
      "get": {
        "operationId": "get_v1_tarakib_models",
        "summary": "tarakib models",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "tarakib models",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        }
      }
    },
    "/v1/tarakib/languages": {
      "get": {
        "operationId": "get_v1_tarakib_languages",
        "summary": "tarakib languages",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "tarakib languages",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        }
      }
    },
    "/v1/maktaba/status": {
      "get": {
        "operationId": "get_v1_maktaba_status",
        "summary": "maktaba status",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "maktaba status",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        }
      }
    },
    "/v1/maktaba/pages/{page_id}": {
      "get": {
        "operationId": "get_v1_maktaba_pages_page_id",
        "summary": "maktaba pages {page_id}",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "maktaba pages {page_id}",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "page_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ]
      }
    },
    "/v1/akhbar/articles/{article_id}": {
      "get": {
        "operationId": "get_v1_akhbar_articles_article_id",
        "summary": "akhbar articles {article_id}",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "akhbar articles {article_id}",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "article_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/akhbar/status": {
      "get": {
        "operationId": "get_v1_akhbar_status",
        "summary": "akhbar status",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "akhbar status",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        }
      }
    },
    "/v1/akhbar/edition": {
      "get": {
        "operationId": "get_v1_akhbar_edition",
        "summary": "Read news edition",
        "tags": [
          "News"
        ],
        "responses": {
          "200": {
            "description": "Read news edition",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/akhbar/headlines": {
      "get": {
        "operationId": "get_v1_akhbar_headlines",
        "summary": "Read news headlines",
        "tags": [
          "News"
        ],
        "responses": {
          "200": {
            "description": "Read news headlines",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/speech/transcribe": {
      "post": {
        "operationId": "post_v1_speech_transcribe",
        "summary": "Transcribe uploaded audio",
        "tags": [
          "Speech"
        ],
        "responses": {
          "200": {
            "description": "Transcribe uploaded audio",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TranscribeResponse"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/TranscribeRequest"
              }
            }
          }
        }
      }
    },
    "/v1/speech/align": {
      "post": {
        "operationId": "post_v1_speech_align",
        "summary": "Submit a subtitle alignment job",
        "tags": [
          "Speech"
        ],
        "responses": {
          "202": {
            "description": "Submit a subtitle alignment job",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlignmentJob"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/AlignmentRequest"
              }
            }
          }
        }
      }
    },
    "/v1/speech/align/job/{job_id}": {
      "get": {
        "operationId": "get_v1_speech_align_job_job_id",
        "summary": "Poll alignment job",
        "tags": [
          "Speech"
        ],
        "responses": {
          "200": {
            "description": "Poll alignment job",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AlignmentJob"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/speech/align/job/{job_id}/srt": {
      "get": {
        "operationId": "get_v1_speech_align_job_job_id_srt",
        "summary": "Download aligned subtitles",
        "tags": [
          "Speech"
        ],
        "responses": {
          "200": {
            "description": "Download aligned subtitles",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/speech/word-align": {
      "post": {
        "operationId": "post_v1_speech_word-align",
        "summary": "Align words synchronously",
        "tags": [
          "Speech"
        ],
        "responses": {
          "200": {
            "description": "Align words synchronously",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Align the supplied transcript to matching audio. If the transcript requires more alignment frames than the recording provides, HTTP 422 returns detail.code=alignment_transcript_too_long, with available_frames, required_frames, target_tokens and repeated_tokens. Correct the transcript or split audio and text into matching segments before retrying. This rejected alignment produces no successful alignment usage or credit charge; its admission reservation is released. Unknown interrupted outcomes remain subject to verified reconciliation. Successful usage and prices are unchanged.",
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/AlignmentRequest"
              }
            }
          }
        }
      }
    },
    "/v1/audio/speech": {
      "post": {
        "operationId": "post_v1_audio_speech",
        "summary": "Synthesize speech audio",
        "tags": [
          "Speech"
        ],
        "responses": {
          "200": {
            "description": "Synthesize speech audio",
            "content": {
              "audio/wav": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Account request and generated-audio quotas apply. ASAT does not reserve the entire remaining audio allowance. WAV and PCM16 streams check measured duration before each chunk and return X-Sawalni-Delivery-Mode: streamed-with-quota-validation. Other formats can require buffered validation. A stream stops when its duration quota is exhausted. Existing streaming billing remains deferred. A quota error before delivery returns a structured error and Retry-After when waiting can help.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SpeechRequest"
              },
              "example": {
                "model": "asat",
                "input": "مرحبا بكم",
                "response_format": "wav"
              }
            }
          }
        }
      }
    },
    "/v1/speech/synthesize": {
      "post": {
        "operationId": "post_v1_speech_synthesize",
        "summary": "Synthesize speech audio",
        "tags": [
          "Speech"
        ],
        "responses": {
          "200": {
            "description": "Synthesize speech audio",
            "content": {
              "audio/wav": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Account request and generated-audio quotas apply. ASAT does not reserve the entire remaining audio allowance. WAV and PCM16 streams check measured duration before each chunk and return X-Sawalni-Delivery-Mode: streamed-with-quota-validation. Other formats can require buffered validation. A stream stops when its duration quota is exhausted. Existing streaming billing remains deferred. A quota error before delivery returns a structured error and Retry-After when waiting can help.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SpeechRequest"
              },
              "example": {
                "model": "asat",
                "input": "مرحبا بكم",
                "response_format": "wav"
              }
            }
          }
        }
      }
    },
    "/v1/atlas/search": {
      "get": {
        "operationId": "get_v1_atlas_search",
        "summary": "Search Moroccan places",
        "tags": [
          "Maps"
        ],
        "responses": {
          "200": {
            "description": "Search Moroccan places",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "sawtone-v4"
            }
          },
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "composite",
              "enum": [
                "composite",
                "phonetic",
                "ortho",
                "semantic"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "place_type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name_filter",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "include_streets",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ]
      }
    },
    "/v1/atlas/osm/search": {
      "get": {
        "operationId": "get_v1_atlas_osm_search",
        "summary": "Search named OSM features",
        "tags": [
          "Maps"
        ],
        "responses": {
          "200": {
            "description": "Search named OSM features",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "sawtone-v4"
            }
          },
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "default": "composite",
              "enum": [
                "composite",
                "phonetic",
                "ortho",
                "semantic"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "default": 8
            }
          }
        ]
      }
    },
    "/v1/atlas/route": {
      "get": {
        "operationId": "get_v1_atlas_route",
        "summary": "Get a driving route",
        "tags": [
          "Maps"
        ],
        "responses": {
          "200": {
            "description": "Get a driving route",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "start_lat",
            "in": "query",
            "required": true,
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "start_lon",
            "in": "query",
            "required": true,
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "end_lat",
            "in": "query",
            "required": true,
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "end_lon",
            "in": "query",
            "required": true,
            "schema": {
              "type": "number"
            }
          }
        ]
      }
    },
    "/v1/atlas/stats": {
      "get": {
        "operationId": "get_v1_atlas_stats",
        "summary": "Read Atlas stats",
        "tags": [
          "Maps"
        ],
        "responses": {
          "200": {
            "description": "Read Atlas stats",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        }
      }
    },
    "/v1/atlas/models": {
      "get": {
        "operationId": "get_v1_atlas_models",
        "summary": "Read Atlas models",
        "tags": [
          "Maps"
        ],
        "responses": {
          "200": {
            "description": "Read Atlas models",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        }
      }
    },
    "/v1/atlas/health": {
      "get": {
        "operationId": "get_v1_atlas_health",
        "summary": "Read Atlas health",
        "tags": [
          "Maps"
        ],
        "responses": {
          "200": {
            "description": "Read Atlas health",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Object"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/knowledge/{id}/search": {
      "post": {
        "operationId": "post_api_public_knowledge_id_search",
        "summary": "Search a Khizana collection",
        "tags": [
          "Knowledge"
        ],
        "responses": {
          "200": {
            "description": "Search a Khizana collection",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeSearchResponse"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid credential",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "402": {
            "description": "Insufficient credit or plan allowance",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "403": {
            "description": "Access denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "413": {
            "description": "Request too large",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "422": {
            "description": "Input validation failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "429": {
            "description": "Rate or capacity limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              },
              "Retry-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Minimum retry delay in seconds for account quota errors. Not a guarantee that capacity will be free."
              },
              "x-should-retry": {
                "schema": {
                  "type": "string",
                  "enum": [
                    "true",
                    "false"
                  ]
                },
                "description": "Account quota retry hint. False for spent day/month budgets. Honor this before automatic 429 retries. Temporary reservation pressure can be retried with bounded backoff."
              }
            }
          },
          "503": {
            "description": "Service unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          },
          "504": {
            "description": "Upstream timeout",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "headers": {
              "Cache-Control": {
                "description": "API responses are private. Do not store or transform them in a browser or shared cache.",
                "schema": {
                  "type": "string",
                  "const": "private, no-store, no-transform"
                }
              }
            }
          }
        },
        "description": "Use a collection-scoped search key. Named keys support optional expiration and revocation; legacy collection keys remain valid until revoked. A general model API key does not replace this key. Search uses the reviewed source release, while draft sources remain private to workspace testing. A collection with no released sources returns an empty result set. CORS requires an explicitly configured origin.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "KnowledgeKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/KnowledgeSearchRequest"
              },
              "example": {
                "query": "What is the return policy?",
                "limit": 5
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "TranslationRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "default": "tarjamli-mini-v4",
            "enum": [
              "tarjamli-mini-v4",
              "tarjamli-nano-v3",
              "tarjamli-v3"
            ]
          },
          "text": {
            "type": "string",
            "minLength": 1,
            "description": "Passage to translate. At most 262144 UTF-8 bytes. Whitespace-only input is rejected."
          },
          "source": {
            "type": "string",
            "enum": [
              "ary_Arab",
              "ary_Latn",
              "shi_Latn",
              "zgh_Tfng",
              "amh_Ethi",
              "arb_Arab",
              "ben_Beng",
              "ces_Latn",
              "cmn_Hans",
              "dan_Latn",
              "deu_Latn",
              "ell_Grek",
              "eng_Latn",
              "fin_Latn",
              "fra_Latn",
              "guj_Gujr",
              "hau_Latn",
              "heb_Hebr",
              "hin_Deva",
              "hun_Latn",
              "ind_Latn",
              "ita_Latn",
              "jpn_Jpan",
              "kan_Knda",
              "khm_Khmr",
              "kor_Hang",
              "lao_Laoo",
              "mal_Mlym",
              "mar_Deva",
              "mya_Mymr",
              "nld_Latn",
              "nob_Latn",
              "npi_Deva",
              "pan_Guru",
              "pes_Arab",
              "pol_Latn",
              "por_Latn",
              "ron_Latn",
              "rus_Cyrl",
              "sin_Sinh",
              "som_Latn",
              "spa_Latn",
              "swe_Latn",
              "swh_Latn",
              "tam_Taml",
              "tel_Telu",
              "tha_Thai",
              "tur_Latn",
              "ukr_Cyrl",
              "urd_Arab",
              "vie_Latn",
              "yor_Latn",
              "zsm_Latn",
              "zul_Latn"
            ],
            "description": "Source language and script. Explicit code required."
          },
          "target": {
            "type": "string",
            "enum": [
              "ary_Arab",
              "ary_Latn",
              "shi_Latn",
              "zgh_Tfng",
              "amh_Ethi",
              "arb_Arab",
              "ben_Beng",
              "ces_Latn",
              "cmn_Hans",
              "dan_Latn",
              "deu_Latn",
              "ell_Grek",
              "eng_Latn",
              "fin_Latn",
              "fra_Latn",
              "guj_Gujr",
              "hau_Latn",
              "heb_Hebr",
              "hin_Deva",
              "hun_Latn",
              "ind_Latn",
              "ita_Latn",
              "jpn_Jpan",
              "kan_Knda",
              "khm_Khmr",
              "kor_Hang",
              "lao_Laoo",
              "mal_Mlym",
              "mar_Deva",
              "mya_Mymr",
              "nld_Latn",
              "nob_Latn",
              "npi_Deva",
              "pan_Guru",
              "pes_Arab",
              "pol_Latn",
              "por_Latn",
              "ron_Latn",
              "rus_Cyrl",
              "sin_Sinh",
              "som_Latn",
              "spa_Latn",
              "swe_Latn",
              "swh_Latn",
              "tam_Taml",
              "tel_Telu",
              "tha_Thai",
              "tur_Latn",
              "ukr_Cyrl",
              "urd_Arab",
              "vie_Latn",
              "yor_Latn",
              "zsm_Latn",
              "zul_Latn"
            ],
            "description": "Target language and script. Nano supports eng_Latn, fra_Latn and arb_Arab from ary_Arab or ary_Latn only."
          },
          "instructions": {
            "type": "string",
            "description": "Mini v4 only. Optional tone, audience, terminology, formatting, glossary, dictionary notes or reference examples. At most 32768 UTF-8 bytes. Omit for a standard translation."
          }
        },
        "required": [
          "text",
          "source",
          "target"
        ],
        "additionalProperties": false
      },
      "TranslationResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "input": {
                "type": "string"
              },
              "translated": {
                "type": "string"
              },
              "alternatives": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "detected_lang": {
                "type": "string",
                "description": "The supplied source code; this endpoint does not detect language."
              },
              "source": {
                "type": "string"
              },
              "target": {
                "type": "string"
              },
              "model": {
                "type": "string"
              },
              "complete": {
                "type": "boolean"
              }
            },
            "required": [
              "input",
              "translated",
              "source",
              "target",
              "model",
              "complete"
            ]
          },
          "usage": {
            "type": "object",
            "properties": {}
          }
        },
        "required": [
          "data",
          "usage"
        ]
      },
      "ChatRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string"
          },
          "messages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "role": {
                  "type": "string",
                  "enum": [
                    "system",
                    "developer",
                    "user",
                    "assistant",
                    "tool"
                  ]
                },
                "content": {
                  "oneOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {}
                      }
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "tool_calls": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {}
                  }
                },
                "tool_call_id": {
                  "type": "string"
                }
              },
              "required": [
                "role"
              ]
            },
            "minItems": 1,
            "maxItems": 1000
          },
          "stream": {
            "type": "boolean",
            "default": false
          },
          "temperature": {
            "type": "number",
            "minimum": 0,
            "maximum": 2
          },
          "max_tokens": {
            "type": "integer",
            "minimum": 1
          },
          "top_p": {
            "type": "number"
          },
          "stop": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          },
          "tools": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {}
            }
          },
          "tool_choice": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "properties": {}
              }
            ]
          },
          "parallel_tool_calls": {
            "type": "boolean"
          },
          "response_format": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string"
              }
            }
          },
          "stream_options": {
            "type": "object",
            "properties": {
              "include_usage": {
                "type": "boolean"
              }
            }
          },
          "modalities": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "text",
                "audio"
              ]
            }
          },
          "audio": {
            "type": "object",
            "properties": {
              "voice": {
                "type": "string",
                "default": "male-1"
              },
              "format": {
                "type": "string",
                "default": "pcm16"
              }
            }
          },
          "n": {
            "type": "integer",
            "minimum": 1,
            "maximum": 4,
            "default": 1
          },
          "max_completion_tokens": {
            "type": "integer",
            "minimum": 1,
            "description": "Alternative output-token limit. Takes precedence over max_tokens. Tiers 0–5 allow at most 2048 generated tokens total across n choices. Text and media content arrays support streaming. Final-usage checks can require buffered SSE with X-Sawalni-Delivery-Mode: buffered-for-quota-validation. Omitted output limits can be reduced to fit remaining allowance or available credits; explicit limits are preserved."
          },
          "seed": {
            "type": "integer"
          },
          "logprobs": {
            "type": "boolean"
          },
          "top_logprobs": {
            "type": "integer"
          },
          "presence_penalty": {
            "type": "number"
          },
          "frequency_penalty": {
            "type": "number"
          },
          "logit_bias": {
            "type": "object",
            "properties": {}
          },
          "functions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {}
            }
          },
          "function_call": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "object",
                "properties": {}
              }
            ]
          },
          "user": {
            "type": "string"
          },
          "metadata": {
            "type": "object",
            "properties": {},
            "description": "Accepted. Retention and return of client metadata are not guaranteed."
          },
          "reasoning_effort": {
            "type": "string"
          },
          "verbosity": {
            "type": "string"
          },
          "prediction": {
            "type": "object",
            "properties": {}
          },
          "service_tier": {
            "type": "string"
          },
          "store": {
            "type": "boolean"
          },
          "chat_template_kwargs": {
            "type": "object",
            "properties": {}
          },
          "repetition_penalty": {
            "type": "number"
          },
          "min_p": {
            "type": "number"
          },
          "top_k": {
            "type": "integer"
          },
          "extra_body": {
            "type": "object",
            "properties": {
              "chat_template_kwargs": {
                "type": "object",
                "properties": {}
              },
              "repetition_penalty": {
                "type": "number"
              },
              "min_p": {
                "type": "number"
              },
              "top_k": {
                "type": "integer"
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "model",
          "messages"
        ],
        "additionalProperties": false
      },
      "BalanceResponse": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": "string"
          },
          "initial_balance": {
            "type": [
              "string",
              "null"
            ]
          },
          "balance": {
            "type": "string"
          },
          "reserved": {
            "type": "string",
            "description": "Credits held by active or pending requests. A hold is not a charge."
          },
          "available_balance": {
            "type": "string",
            "description": "Credits available after holds. Concurrent requests cannot spend another request hold."
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "user_id",
          "balance",
          "reserved",
          "available_balance"
        ]
      },
      "ChatResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "type": "string"
          },
          "created": {
            "type": "integer"
          },
          "model": {
            "type": "string"
          },
          "choices": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "index": {
                  "type": "integer"
                },
                "message": {
                  "type": "object",
                  "properties": {
                    "role": {
                      "type": "string",
                      "enum": [
                        "system",
                        "developer",
                        "user",
                        "assistant",
                        "tool"
                      ]
                    },
                    "content": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {}
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "tool_calls": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {}
                      }
                    },
                    "tool_call_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "role"
                  ]
                },
                "finish_reason": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "usage": {
            "type": "object",
            "properties": {}
          }
        },
        "required": [
          "choices"
        ]
      },
      "EmbeddingRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string"
          },
          "input": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          },
          "encoding_format": {
            "type": "string",
            "default": "float",
            "description": "Use float for portable TEI support. Other encodings depend on the deployment."
          }
        },
        "required": [
          "model",
          "input"
        ]
      },
      "EmbeddingResponse": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "index": {
                  "type": "integer"
                },
                "embedding": {
                  "type": "array",
                  "items": {
                    "type": "number"
                  }
                }
              }
            }
          },
          "usage": {
            "type": "object",
            "properties": {}
          }
        },
        "required": [
          "data"
        ]
      },
      "IdentifyRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "examples": [
              "gherbal-v4"
            ]
          },
          "input": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          },
          "top": {
            "type": "integer",
            "default": 1,
            "description": "Positive k returns top-k predictions; non-positive values request all predictions."
          }
        },
        "required": [
          "model",
          "input"
        ]
      },
      "IdentifyResponse": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "input": {
                  "type": "string"
                },
                "predictions": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "language": {
                        "type": "string"
                      },
                      "confidence": {
                        "type": "number"
                      }
                    }
                  }
                }
              }
            }
          },
          "usage": {
            "type": "object",
            "properties": {}
          }
        },
        "required": [
          "data"
        ]
      },
      "EncodeRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "examples": [
              "sawtone-v4"
            ]
          },
          "input": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          },
          "channel": {
            "type": "string",
            "default": "composite",
            "enum": [
              "composite",
              "phonetic",
              "ortho",
              "semantic"
            ]
          }
        },
        "required": [
          "model",
          "input"
        ]
      },
      "EncodeResponse": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "input": {
                  "type": "string"
                },
                "embedding": {
                  "type": "array",
                  "items": {
                    "type": "number"
                  }
                }
              }
            }
          },
          "channel": {
            "type": "string"
          },
          "dimensions": {
            "type": "integer"
          },
          "usage": {
            "type": "object",
            "properties": {}
          }
        },
        "required": [
          "data"
        ]
      },
      "RescriptRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "default": "rescript-v1"
          },
          "input": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          },
          "source_code": {
            "type": "string"
          },
          "target_code": {
            "type": "string",
            "default": "ary_Arab"
          },
          "max_candidates": {
            "type": "integer",
            "minimum": 1,
            "maximum": 32,
            "description": "Use 1 to 3 candidates for a portable request. Confirm the current account limits."
          },
          "min_overlap": {
            "type": "number",
            "default": 0.9,
            "minimum": -1,
            "maximum": 1
          },
          "max_decoder_len": {
            "type": "integer",
            "default": 64,
            "minimum": 8,
            "maximum": 128
          },
          "seed": {
            "type": "integer",
            "default": 20260628
          },
          "include_candidates": {
            "type": "boolean",
            "default": false
          }
        },
        "required": [
          "input"
        ]
      },
      "TarakibRequest": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "maxLength": 20000
          },
          "tokens": {
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^\\S+$"
            },
            "maxItems": 96
          },
          "language": {
            "type": "string"
          },
          "tasks": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "pos",
                "morphology",
                "dependencies"
              ]
            }
          },
          "morphology_threshold": {
            "type": "number",
            "minimum": 0.05,
            "maximum": 0.95,
            "default": 0.5
          }
        },
        "oneOf": [
          {
            "required": [
              "text"
            ],
            "not": {
              "required": [
                "tokens"
              ]
            }
          },
          {
            "required": [
              "tokens"
            ],
            "not": {
              "required": [
                "text"
              ]
            }
          }
        ]
      },
      "TranscribeRequest": {
        "type": "object",
        "properties": {
          "audio": {
            "type": "string",
            "format": "binary"
          },
          "model": {
            "type": "string",
            "default": "daktilo",
            "enum": [
              "daktilo",
              "daktilo-v1",
              "daktilo-v2",
              "daktilo-v3"
            ],
            "description": "Use daktilo or daktilo-v3. Compatibility aliases daktilo-v1 and daktilo-v2 are supported. Discover available models with GET /v1/models."
          },
          "language": {
            "type": "string",
            "description": "Default: auto. Forced hints: ar, ary, en, fr, es, de, it, pt, zh, ja, ko, ru, tr, nl. Unsupported hints, including shi, return HTTP 400. File audio must be at most 30 minutes."
          }
        },
        "required": [
          "audio"
        ]
      },
      "TranscribeResponse": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string"
          },
          "language": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "duration": {
            "type": "number"
          },
          "segments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {}
            }
          },
          "warnings": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "usage": {
            "type": "object",
            "properties": {}
          }
        },
        "required": [
          "text"
        ]
      },
      "AlignmentRequest": {
        "type": "object",
        "properties": {
          "audio": {
            "type": "string",
            "format": "binary",
            "description": "Audio or video, at most 128 MiB."
          },
          "text": {
            "type": "string",
            "description": "Transcript; at most 1,000,000 UTF-8 bytes."
          }
        },
        "required": [
          "audio",
          "text"
        ]
      },
      "AlignmentJob": {
        "type": "object",
        "properties": {
          "job_id": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "step": {
            "type": "string"
          },
          "progress": {
            "type": "number"
          },
          "words_so_far": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {}
            }
          },
          "srt_url": {
            "type": "string"
          },
          "usage": {
            "type": "object",
            "properties": {}
          }
        },
        "required": [
          "job_id",
          "status"
        ]
      },
      "SpeechRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "default": "asat"
          },
          "input": {
            "type": "string",
            "minLength": 1,
            "description": "Tiers 0–5 accept at most 1000 input characters per request."
          },
          "voice": {
            "type": "string",
            "default": "male-1"
          },
          "response_format": {
            "type": "string",
            "default": "wav",
            "description": "wav is the portable choice. pcm16 support depends on the selected deployment."
          },
          "stream": {
            "type": "boolean",
            "default": false
          }
        },
        "required": [
          "input"
        ]
      },
      "SearchRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1
          },
          "limit": {
            "type": "integer",
            "default": 10
          },
          "cursor": {
            "type": [
              "string",
              "null"
            ]
          },
          "filters": {
            "type": "object",
            "properties": {
              "domains": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "languages": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "source_types": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "published_from": {
                "type": "string"
              },
              "published_to": {
                "type": "string"
              }
            }
          },
          "include_content": {
            "type": "boolean"
          },
          "include_text": {
            "type": "boolean"
          }
        },
        "required": [
          "query"
        ]
      },
      "SocialRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1
          },
          "language": {
            "type": "string"
          },
          "platform": {
            "type": "string"
          },
          "limit": {
            "type": "integer",
            "default": 8
          }
        },
        "required": [
          "query"
        ]
      },
      "ResearchRequest": {
        "type": "object",
        "properties": {
          "task": {
            "type": "string",
            "minLength": 1
          },
          "mode": {
            "type": "string",
            "default": "deep"
          }
        },
        "required": [
          "task"
        ]
      },
      "NewsSearchRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1
          },
          "filters": {
            "type": "object",
            "properties": {
              "languages": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "limit": {
            "type": "integer",
            "default": 10
          }
        },
        "required": [
          "query"
        ]
      },
      "KnowledgeSearchRequest": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1,
            "maxLength": 1000
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10,
            "default": 5
          }
        },
        "required": [
          "query"
        ]
      },
      "KnowledgeSearchResponse": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "sourceId": {
                  "type": "string"
                },
                "sourceName": {
                  "type": "string"
                },
                "chunk": {
                  "type": "integer"
                },
                "text": {
                  "type": "string"
                },
                "score": {
                  "type": "number"
                }
              }
            }
          }
        },
        "required": [
          "results"
        ]
      },
      "Error": {
        "type": "object",
        "properties": {
          "detail": {},
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "resource": {
                "type": "string"
              },
              "window": {
                "type": "string"
              },
              "requested": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "used": {
                "type": "integer"
              },
              "reserved": {
                "type": "integer"
              },
              "remaining": {
                "type": "integer"
              },
              "reset_at": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "retry_after_seconds": {
                "type": "integer"
              },
              "retry_policy": {
                "type": "string",
                "enum": [
                  "wait_for_capacity",
                  "wait_for_reset",
                  "bounded_backoff",
                  "do_not_retry"
                ]
              },
              "automatic_retry": {
                "type": "boolean"
              },
              "usage_url": {
                "type": "string"
              }
            }
          }
        },
        "description": "Errors can contain FastAPI detail or an error object. Inspect the HTTP status first. For rolling quota rejection, reset_at and Retry-After identify when enough recorded usage expires for the requested units, rather than the first usage event. Concurrent reservations can still change availability. Spent hourly, daily and monthly budgets use wait_for_reset and automatic_retry=false."
      },
      "Object": {
        "type": "object",
        "properties": {},
        "description": "Pass-through response. Additional service fields can be present."
      },
      "TransactionPage": {
        "type": "object",
        "properties": {
          "transactions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "kind": {
                  "type": "string",
                  "enum": [
                    "charge",
                    "grant",
                    "refund"
                  ]
                },
                "credits": {
                  "type": "string"
                },
                "occurred_at_ms": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "model": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "api": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "metrics": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "string"
                  }
                },
                "price_version": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "id",
                "kind",
                "credits",
                "metrics"
              ]
            }
          },
          "next_cursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "transactions",
          "next_cursor"
        ]
      },
      "QuotaMetric": {
        "type": "object",
        "properties": {
          "used": {
            "type": "integer",
            "minimum": 0
          },
          "reserved": {
            "type": "integer",
            "minimum": 0
          },
          "limit": {
            "type": [
              "integer",
              "null"
            ]
          },
          "remaining": {
            "type": [
              "integer",
              "null"
            ]
          },
          "reset_at": {
            "type": "string",
            "format": "date-time"
          },
          "window_kind": {
            "type": "string",
            "enum": [
              "rolling",
              "calendar_utc"
            ]
          }
        },
        "required": [
          "used",
          "reserved",
          "limit",
          "remaining",
          "reset_at",
          "window_kind"
        ]
      },
      "TierAssignment": {
        "type": "object",
        "properties": {
          "spending_tier": {
            "type": "string",
            "enum": [
              "0",
              "1",
              "2",
              "3",
              "4",
              "5"
            ]
          },
          "assigned_tier": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "0",
              "1",
              "2",
              "3",
              "4",
              "5",
              null
            ],
            "deprecated": true,
            "description": "Compatibility alias for spending_tier. There is no separate normal assignment. Null for unlimited accounts."
          },
          "override_tier": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "0",
              "1",
              "2",
              "3",
              "4",
              "5",
              null
            ]
          },
          "effective_tier": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "0",
              "1",
              "2",
              "3",
              "4",
              "5",
              null
            ]
          },
          "source": {
            "type": "string",
            "enum": [
              "manual",
              "spending",
              "unlimited"
            ]
          },
          "revision": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "spending_tier",
          "assigned_tier",
          "override_tier",
          "effective_tier",
          "source",
          "revision"
        ]
      },
      "AccountUsage": {
        "type": "object",
        "properties": {
          "tier_assignment": {
            "$ref": "#/components/schemas/TierAssignment"
          },
          "policy_version": {
            "type": "string"
          },
          "tier": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "0",
              "1",
              "2",
              "3",
              "4",
              "5",
              null
            ]
          },
          "unlimited": {
            "type": "boolean"
          },
          "effective_since": {
            "type": "string"
          },
          "as_of": {
            "type": "string"
          },
          "timezone": {
            "type": "string",
            "enum": [
              "UTC"
            ]
          },
          "requests": {
            "type": "object",
            "properties": {
              "minute": {
                "$ref": "#/components/schemas/QuotaMetric"
              },
              "hour": {
                "$ref": "#/components/schemas/QuotaMetric"
              },
              "day": {
                "$ref": "#/components/schemas/QuotaMetric"
              },
              "month": {
                "$ref": "#/components/schemas/QuotaMetric"
              }
            },
            "required": [
              "minute",
              "hour",
              "day",
              "month"
            ]
          },
          "resources": {
            "type": "object",
            "properties": {
              "tokens": {
                "type": "object",
                "properties": {
                  "minute": {
                    "$ref": "#/components/schemas/QuotaMetric"
                  },
                  "hour": {
                    "$ref": "#/components/schemas/QuotaMetric"
                  },
                  "day": {
                    "$ref": "#/components/schemas/QuotaMetric"
                  },
                  "month": {
                    "$ref": "#/components/schemas/QuotaMetric"
                  }
                },
                "required": [
                  "minute",
                  "hour",
                  "day",
                  "month"
                ]
              },
              "tts": {
                "type": "object",
                "properties": {
                  "day": {
                    "$ref": "#/components/schemas/QuotaMetric"
                  },
                  "month": {
                    "$ref": "#/components/schemas/QuotaMetric"
                  }
                },
                "required": [
                  "day",
                  "month"
                ]
              },
              "speech": {
                "type": "object",
                "properties": {
                  "day": {
                    "$ref": "#/components/schemas/QuotaMetric"
                  },
                  "month": {
                    "$ref": "#/components/schemas/QuotaMetric"
                  }
                },
                "required": [
                  "day",
                  "month"
                ]
              }
            },
            "required": [
              "tokens",
              "tts",
              "speech"
            ]
          },
          "concurrency": {
            "type": "object",
            "properties": {
              "used": {
                "type": "integer"
              },
              "limit": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            },
            "required": [
              "used",
              "limit"
            ]
          },
          "statistics": {
            "type": "object",
            "properties": {
              "accepted": {
                "type": "integer"
              },
              "succeeded": {
                "type": "integer"
              },
              "failed": {
                "type": "integer"
              },
              "blocked": {
                "type": "integer"
              },
              "endpoints": {
                "type": "object",
                "additionalProperties": {
                  "type": "integer"
                }
              }
            }
          },
          "per_request": {
            "type": "object",
            "properties": {
              "generated_tokens": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "tts_characters": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "transcription_seconds": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "batch_items": {
                "type": [
                  "integer",
                  "null"
                ]
              }
            }
          },
          "spending": {
            "type": "object",
            "properties": {
              "confirmed_net_payments_usd": {
                "type": "string"
              },
              "next_tier": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "next_tier_threshold_usd": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "remaining_usd": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "promotion_mode": {
                "type": "string",
                "enum": [
                  "automatic"
                ]
              },
              "as_of": {
                "type": "string"
              },
              "source": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            }
          },
          "upgrade_message": {
            "type": "string"
          },
          "counting_policy": {
            "type": "string"
          },
          "streaming_policy": {
            "type": "string"
          },
          "token_accounting_note": {
            "type": "string"
          }
        },
        "required": [
          "policy_version",
          "tier",
          "unlimited",
          "requests",
          "resources",
          "concurrency",
          "statistics",
          "per_request",
          "spending",
          "as_of",
          "effective_since",
          "timezone"
        ]
      },
      "RhymeScoreRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "default": "sawtone-v4"
          },
          "language": {
            "type": "string"
          },
          "script": {
            "type": "string"
          },
          "pairs": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1
              },
              "minItems": 2,
              "maxItems": 2
            },
            "minItems": 1
          },
          "include_ipa": {
            "type": "boolean"
          },
          "include_components": {
            "type": "boolean"
          }
        },
        "required": [
          "pairs"
        ]
      },
      "RhymeSearchRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "default": "sawtone-v4"
          },
          "language": {
            "type": "string"
          },
          "script": {
            "type": "string"
          },
          "query": {
            "type": "string",
            "minLength": 1
          },
          "candidates": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "vocabulary": {
            "type": "string",
            "default": "common-lyrics",
            "enum": [
              "raw",
              "common",
              "common-lyrics"
            ]
          },
          "top_k": {
            "type": "integer",
            "default": 50
          },
          "min_score": {
            "type": "number"
          },
          "include_ipa": {
            "type": "boolean"
          }
        },
        "required": [
          "query",
          "language"
        ]
      },
      "LyricReplaceRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "default": "sawtone-v4"
          },
          "language": {
            "type": "string"
          },
          "script": {
            "type": "string"
          },
          "line": {
            "type": "string",
            "minLength": 1
          },
          "target": {
            "type": "string"
          },
          "vocabulary": {
            "type": "string",
            "default": "common-lyrics",
            "enum": [
              "raw",
              "common",
              "common-lyrics"
            ]
          },
          "top_k": {
            "type": "integer",
            "default": 20
          },
          "weights": {
            "type": "object",
            "properties": {}
          },
          "include_components": {
            "type": "boolean",
            "default": true
          }
        },
        "required": [
          "line",
          "language"
        ]
      },
      "LyricScoreRequest": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string",
            "default": "sawtone-v4"
          },
          "language": {
            "type": "string"
          },
          "script": {
            "type": "string"
          },
          "text": {
            "type": "string",
            "minLength": 1
          },
          "rhyme_threshold": {
            "type": "number",
            "default": 0.64
          },
          "include_internal_rhymes": {
            "type": "boolean",
            "default": true
          }
        },
        "required": [
          "text",
          "language"
        ]
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      },
      "KnowledgeKey": {
        "type": "http",
        "scheme": "bearer",
        "description": "Collection search key"
      }
    }
  },
  "x-websocket": {
    "/v1/speech/transcribe/stream": {
      "url": "wss://api.sawalni.com/v1/speech/transcribe/stream",
      "protocol": "sawalni.transcribe.v1",
      "authentication": "Bearer header, x-api-key header, or sawalni-key.BASE64URL_KEY subprotocol from a browser. Do not put keys in query strings.",
      "start": {
        "type": "start",
        "model": "daktilo",
        "language": "ar",
        "sample_rate": 16000,
        "channels": 1,
        "audio_format": "pcm_s16le"
      },
      "client": "Use daktilo or daktilo-v3. Compatibility aliases daktilo-v1 and daktilo-v2 are supported. Send start JSON and 16 kHz mono PCM16 frames. Flush returns a session sync. Stop returns final, usage and done. Maximum audio is 30 minutes; lower account limits can apply. Idle timeout is 120 seconds. A temporary capacity error can return no_capacity and close with code 1013. Retry with bounded backoff.",
      "server": [
        "ready",
        "partial",
        "sync",
        "final",
        "usage",
        "done",
        "error"
      ]
    }
  }
}
