@naturali/sdk 0.78.0 → 0.78.1

package/dist/index.d.cts

@@ -3312,7 +3312,8 @@ type Model = {
      */
     input_per_1k_tokens: number;
     /**
-     * USD per 1K output tokens.
+     * USD per 1K output tokens. Reasoning ("thinking") tokens are output tokens: on a model that reasons by default they are counted in `output_tokens` and billed at this rate, and can be most of the output on a short answer. A rate alone therefore does not size a request on such a model.
+     *
      */
     output_per_1k_tokens: number;
     /**
@@ -4036,6 +4037,7 @@ type UsageTokens = {
 type UsageComponent = {
   /**
    * The measured dimension — input_tokens, cached_tokens, output_tokens, reasoning_tokens, compute_second, request, gb_day, …
+   * Components are not always disjoint. `reasoning_tokens` is the part of `output_tokens` a reasoning model spent thinking: it is reported for visibility and priced as output, so its own `cost_usd` is null to keep it from being counted twice. On a model that reasons by default it can be most of the output — and most of the bill — for a short answer.
    *
    */
   component: string;
@@ -4049,7 +4051,7 @@ type UsageComponent = {
    */
   quantity: number;
   /**
-   * Billing-grade cost in USD for this component; null when it was not priced. The quantity is still measured — null never means free.
+   * Billing-grade cost in USD for this component; null when it was not priced, or when another component already prices it (as `output_tokens` prices `reasoning_tokens`). The quantity is still measured — null never means free.
    *
    */
   cost_usd: number | null;

package/dist/index.d.mts

@@ -3312,7 +3312,8 @@ type Model = {
      */
     input_per_1k_tokens: number;
     /**
-     * USD per 1K output tokens.
+     * USD per 1K output tokens. Reasoning ("thinking") tokens are output tokens: on a model that reasons by default they are counted in `output_tokens` and billed at this rate, and can be most of the output on a short answer. A rate alone therefore does not size a request on such a model.
+     *
      */
     output_per_1k_tokens: number;
     /**
@@ -4036,6 +4037,7 @@ type UsageTokens = {
 type UsageComponent = {
   /**
    * The measured dimension — input_tokens, cached_tokens, output_tokens, reasoning_tokens, compute_second, request, gb_day, …
+   * Components are not always disjoint. `reasoning_tokens` is the part of `output_tokens` a reasoning model spent thinking: it is reported for visibility and priced as output, so its own `cost_usd` is null to keep it from being counted twice. On a model that reasons by default it can be most of the output — and most of the bill — for a short answer.
    *
    */
   component: string;
@@ -4049,7 +4051,7 @@ type UsageComponent = {
    */
   quantity: number;
   /**
-   * Billing-grade cost in USD for this component; null when it was not priced. The quantity is still measured — null never means free.
+   * Billing-grade cost in USD for this component; null when it was not priced, or when another component already prices it (as `output_tokens` prices `reasoning_tokens`). The quantity is still measured — null never means free.
    *
    */
   cost_usd: number | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/sdk",
-  "version": "0.78.0",
+  "version": "0.78.1",
   "description": "TypeScript SDK for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "sideEffects": false,
@@ -37,7 +37,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/api": "0.78.0"
+    "@naturali/api": "0.78.1"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",