@talonic/docs 0.20.26 → 0.20.28

package/dist/seo.js

@@ -14833,6 +14833,127 @@ var openapi_default = {
           }
         }
       }
+    },
+    "/v1/usage/credits": {
+      get: {
+        operationId: "getCreditUsageByFunction",
+        summary: "Per-function credit consumption",
+        description: "Credit consumption grouped by platform function (operation_type) from the customer-pay ledger, plus the window total. Shows where credits went (extraction vs structuring vs intelligence ops). Populates once metering is enforcing.",
+        tags: [
+          "Usage"
+        ],
+        parameters: [
+          {
+            name: "days",
+            in: "query",
+            required: false,
+            schema: {
+              type: "integer",
+              minimum: 1,
+              maximum: 365,
+              default: 30
+            },
+            description: "Trailing reporting window in days (default 30)."
+          }
+        ],
+        responses: {
+          "200": {
+            description: "Per-function credit consumption.",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    period_days: {
+                      type: "integer"
+                    },
+                    total_credits: {
+                      type: "integer"
+                    },
+                    by_function: {
+                      type: "array",
+                      items: {
+                        type: "object",
+                        properties: {
+                          operation_type: {
+                            type: "string"
+                          },
+                          operations: {
+                            type: "integer"
+                          },
+                          credits: {
+                            type: "integer"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/pricing": {
+      get: {
+        operationId: "getPricing",
+        summary: "Credit pricing catalog",
+        description: "Public (unauthenticated) machine-readable credit pricing catalog: fixed per-unit credit rates, EUR equivalents, the credits-per-EUR conversion rate, and processing-mode multipliers (e.g. batch at 0.5x). Predict spend before running anything.",
+        tags: [
+          "Pricing"
+        ],
+        responses: {
+          "200": {
+            description: "The credit pricing catalog.",
+            content: {
+              "application/json": {
+                schema: {
+                  type: "object",
+                  properties: {
+                    currency: {
+                      type: "string",
+                      example: "EUR"
+                    },
+                    credits_per_eur: {
+                      type: "number"
+                    },
+                    multipliers: {
+                      type: "object",
+                      additionalProperties: {
+                        type: "number"
+                      }
+                    },
+                    units: {
+                      type: "array",
+                      items: {
+                        type: "object",
+                        properties: {
+                          unit: {
+                            type: "string"
+                          },
+                          label: {
+                            type: "string"
+                          },
+                          credits: {
+                            type: "number"
+                          },
+                          eur: {
+                            type: "number"
+                          },
+                          free: {
+                            type: "boolean"
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
     }
   },
   components: {
@@ -21463,7 +21584,11 @@ var API_NAV_SECTIONS = [
     { id: "cost-headers", label: "Cost Headers" }
   ] },
   { id: "usage", label: "Usage", children: [
-    { id: "usage-overview", label: "Overview" }
+    { id: "usage-overview", label: "Overview" },
+    { id: "usage-credits", label: "Credit Usage" }
+  ] },
+  { id: "pricing", label: "Pricing", children: [
+    { id: "pricing-overview", label: "Pricing Catalog" }
   ] },
   { id: "document-types", label: "Document Types", children: [
     { id: "list-document-types", label: "Document Types" }
@@ -21667,7 +21792,8 @@ var API_SECTION_META = [
   { id: "routing-rules", title: "Routing Rules API", description: "Document routing rules \u2014 create, manage, and reorder priority-based rules for automatic document workflow assignment." },
   { id: "reference-data", title: "Reference Data API", description: "Upload, list, and manage reference data tables used as lookup targets for matching configurations. Supports JSON upload, paginated row access, and CSV export." },
   { id: "fields", title: "Fields API", description: "Read-only access to the field registry \u2014 list fields with filters, cross-schema harmonization analysis, field detail with occurrences, and embedding-based similarity search." },
-  { id: "usage", title: "Usage API", description: "AI token usage tracking \u2014 aggregate stats by operation type and model, per-document usage breakdown with cost estimates." },
+  { id: "usage", title: "Usage API", description: "AI token usage tracking \u2014 aggregate stats by operation type and model, per-document usage breakdown with cost estimates, and per-function credit consumption." },
+  { id: "pricing", title: "Pricing API", description: "Public machine-readable credit pricing catalog \u2014 fixed per-unit credit rates, EUR equivalents, the credits-per-EUR conversion, and processing-mode multipliers, so an agent can predict spend before running." },
   { id: "document-types", title: "Document Types API", description: "Document type classification \u2014 list workspace document types by frequency and retrieve the 529-type ontology taxonomy." },
   { id: "registry", title: "Registry API", description: "Query previously-extracted field values across all documents \u2014 ingest once, query forever. Zero re-extraction, zero AI calls." },
   { id: "billing", title: "Billing API", description: "Billing settings, auto top-up for AI agents, and cost response headers on extraction requests." },