@leaflow/sdk 0.0.0-dev.429.gf6440ec → 0.0.0-dev.433.g7e48b8f

package/dist/canopy/v1/generated/validators/modelMeter.zod.js

@@ -40,9 +40,28 @@
  */
 import * as zod from "zod";
 export const ModelMeter = zod.strictObject({
-    token_kind: zod.enum(["input", "output", "cache_read", "cache_write", "reasoning"]),
+    kind: zod
+        .enum([
+        "input",
+        "output",
+        "cache_read",
+        "cache_write",
+        "reasoning",
+        "images",
+        "audio_characters",
+        "audio_seconds",
+        "video_seconds",
+        "rerank_units",
+    ])
+        .describe("The billable quantity this entry prices. Token kinds are `input`, `output`, `cache_read`, `cache_write` and `reasoning`; media kinds are `images`, `audio_characters`, `audio_seconds` and `video_seconds`."),
     meter_lookup_key: zod.string(),
+    unit: zod
+        .string()
+        .describe("The unit the meter counts in, such as token, image, character or second."),
+    dimension_keys: zod
+        .array(zod.string())
+        .describe("The dimension keys every rate of this kind is matched on, in the order the meter declares them."),
     dimensions: zod
         .record(zod.string(), zod.string())
-        .describe("The dimension values the usage of this token kind carries, and the rate is matched at."),
+        .describe("One set of dimension values of this kind, useful as a query template. A media kind may have other values on the same keys, such as another size or resolution."),
 });

package/dist/canopy/v1/generated/validators/modelParameter.zod.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Canopy model inference, API keys, model catalogue, service enablement and recorded usage.
+ *
+ * Project inference is served on this host in each provider's own protocol:
+ *
+ * - OpenAI: `/v1/chat/completions`, `/v1/responses` and `/v1/embeddings`; use
+ *   `https://canopy.leaflow.cloud/v1` as the OpenAI SDK base URL.
+ * - Anthropic: `/v1/messages`; use `https://canopy.leaflow.cloud` as the Anthropic SDK base URL.
+ * - Gemini: `/v1beta/models/{model}:generateContent` and `:streamGenerateContent`.
+ *
+ * Canopy does not convert between protocols. A request is accepted only for a model whose
+ * `supported_endpoints` lists the endpoint it was sent to, and it is forwarded unchanged except for
+ * the model name and the credentials. Reasoning settings such as `reasoning_effort` are passed
+ * through as written; a model's `capabilities` lists the values its upstream accepts.
+ *
+ * Management operations use `/api/v1`. The management model catalogue names how each model is billed in Billing;
+ * `/v1/models` returns the OpenAI model format with Canopy capabilities and parameter limits.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * Management and project inference accept the same verified IAM scoped token. The token is the
+ * sole billing project authority; `OpenAI-Project` and historical identity headers cannot
+ * override it. These endpoints do not accept a Canopy API key. The separate API-key gateway
+ * accepts Canopy API keys and serves the same endpoints.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days, or 400 days for the usage timeline. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates Billing holds for each model's `billing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const ModelParameter: zod.ZodObject<{
+    name: zod.ZodString;
+    description: zod.ZodString;
+    type: zod.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        object: "object";
+        array: "array";
+        integer: "integer";
+    }>;
+    required: zod.ZodBoolean;
+    default: zod.ZodOptional<zod.ZodUnknown>;
+    values: zod.ZodOptional<zod.ZodNullable<zod.ZodArray<zod.ZodString>>>;
+}, zod.z.core.$strict>;
+export type ModelParameter = zod.input<typeof ModelParameter>;
+export type ModelParameterOutput = zod.output<typeof ModelParameter>;

package/dist/canopy/v1/generated/validators/modelParameter.zod.js

@@ -0,0 +1,57 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Canopy model inference, API keys, model catalogue, service enablement and recorded usage.
+ *
+ * Project inference is served on this host in each provider's own protocol:
+ *
+ * - OpenAI: `/v1/chat/completions`, `/v1/responses` and `/v1/embeddings`; use
+ *   `https://canopy.leaflow.cloud/v1` as the OpenAI SDK base URL.
+ * - Anthropic: `/v1/messages`; use `https://canopy.leaflow.cloud` as the Anthropic SDK base URL.
+ * - Gemini: `/v1beta/models/{model}:generateContent` and `:streamGenerateContent`.
+ *
+ * Canopy does not convert between protocols. A request is accepted only for a model whose
+ * `supported_endpoints` lists the endpoint it was sent to, and it is forwarded unchanged except for
+ * the model name and the credentials. Reasoning settings such as `reasoning_effort` are passed
+ * through as written; a model's `capabilities` lists the values its upstream accepts.
+ *
+ * Management operations use `/api/v1`. The management model catalogue names how each model is billed in Billing;
+ * `/v1/models` returns the OpenAI model format with Canopy capabilities and parameter limits.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * Management and project inference accept the same verified IAM scoped token. The token is the
+ * sole billing project authority; `OpenAI-Project` and historical identity headers cannot
+ * override it. These endpoints do not accept a Canopy API key. The separate API-key gateway
+ * accepts Canopy API keys and serves the same endpoints.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days, or 400 days for the usage timeline. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates Billing holds for each model's `billing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export const ModelParameter = zod
+    .strictObject({
+    name: zod.string(),
+    description: zod.string(),
+    type: zod.enum(["string", "integer", "number", "boolean", "object", "array"]),
+    required: zod.boolean(),
+    default: zod
+        .unknown()
+        .optional()
+        .describe("The value the upstream assumes when the field is absent; null when there is none. The service never writes it into the request."),
+    values: zod
+        .array(zod.string())
+        .nullish()
+        .describe("The accepted values of an enumerated string parameter. Null when the parameter is not enumerated."),
+})
+    .describe("A non-standard request field this endpoint accepts. OpenAI SDK callers pass it through `extra_body`, which places it at the top level of the body.");

package/dist/canopy/v1/generated/validators/modelResource.zod.d.ts

@@ -48,14 +48,21 @@ export declare const ModelResource: zod.ZodObject<{
     billing: zod.ZodObject<{
         plan_id: zod.ZodNullable<zod.ZodUUID>;
         meters: zod.ZodArray<zod.ZodObject<{
-            token_kind: zod.ZodEnum<{
+            kind: zod.ZodEnum<{
                 output: "output";
                 input: "input";
                 reasoning: "reasoning";
                 cache_read: "cache_read";
                 cache_write: "cache_write";
+                images: "images";
+                audio_characters: "audio_characters";
+                audio_seconds: "audio_seconds";
+                video_seconds: "video_seconds";
+                rerank_units: "rerank_units";
             }>;
             meter_lookup_key: zod.ZodString;
+            unit: zod.ZodString;
+            dimension_keys: zod.ZodArray<zod.ZodString>;
             dimensions: zod.ZodRecord<zod.ZodString, zod.ZodString>;
         }, zod.z.core.$strict>>;
     }, zod.z.core.$strict>;
@@ -96,6 +103,43 @@ export declare const ModelResource: zod.ZodObject<{
             }, zod.z.core.$strict>>;
             summary: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
         }, zod.z.core.$strict>, zod.ZodNull]>;
+        image: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+            sizes: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+            qualities: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+            response_formats: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+            max_n: zod.ZodNullable<zod.ZodInt>;
+            supports_stream: zod.ZodNullable<zod.ZodBoolean>;
+        }, zod.z.core.$strict>, zod.ZodNull]>>;
+        audio: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+            voices: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+            formats: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+            response_formats: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+            max_input_bytes: zod.ZodNullable<zod.ZodInt>;
+            supports_stream: zod.ZodNullable<zod.ZodBoolean>;
+        }, zod.z.core.$strict>, zod.ZodNull]>>;
+        video: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+            seconds: zod.ZodNullable<zod.ZodArray<zod.ZodInt>>;
+            sizes: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+            resolutions: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+            supports_input_reference: zod.ZodNullable<zod.ZodBoolean>;
+            supports_remix: zod.ZodNullable<zod.ZodBoolean>;
+            supports_characters: zod.ZodNullable<zod.ZodBoolean>;
+        }, zod.z.core.$strict>, zod.ZodNull]>>;
+        parameters: zod.ZodOptional<zod.ZodNullable<zod.ZodArray<zod.ZodObject<{
+            name: zod.ZodString;
+            description: zod.ZodString;
+            type: zod.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                object: "object";
+                array: "array";
+                integer: "integer";
+            }>;
+            required: zod.ZodBoolean;
+            default: zod.ZodOptional<zod.ZodUnknown>;
+            values: zod.ZodOptional<zod.ZodNullable<zod.ZodArray<zod.ZodString>>>;
+        }, zod.z.core.$strict>>>>;
     }, zod.z.core.$strict>>;
     supported_endpoints: zod.ZodArray<zod.ZodEnum<{
         "/v1/chat/completions": "/v1/chat/completions";
@@ -109,6 +153,19 @@ export declare const ModelResource: zod.ZodObject<{
         "/v1/audio/translations": "/v1/audio/translations";
         "/v1/audio/speech": "/v1/audio/speech";
         "/v1/realtime": "/v1/realtime";
+        "/v1/completions": "/v1/completions";
+        "/v1/rerank": "/v1/rerank";
+        "/v1/moderations": "/v1/moderations";
+        "/v1/images/variations": "/v1/images/variations";
+        "/v1/files": "/v1/files";
+        "/v1/uploads": "/v1/uploads";
+        "/v1/batches": "/v1/batches";
+        "/v1/fine_tuning/jobs": "/v1/fine_tuning/jobs";
+        "/v1/assistants": "/v1/assistants";
+        "/v1/threads": "/v1/threads";
+        "/v1/vector_stores": "/v1/vector_stores";
+        "/v1/containers": "/v1/containers";
+        "/v1/videos": "/v1/videos";
     }>>;
 }, zod.z.core.$strict>;
 export type ModelResource = zod.input<typeof ModelResource>;

package/dist/canopy/v1/generated/validators/modelUsageListResponseBody.zod.d.ts

@@ -47,6 +47,15 @@ export declare const ModelUsageListResponseBody: zod.ZodObject<{
         model_id: zod.ZodString;
         output_tokens: zod.ZodInt;
         reasoning_tokens: zod.ZodInt;
+        media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+            images: zod.ZodInt;
+            audio_characters: zod.ZodInt;
+            audio_seconds: zod.ZodInt;
+            video_seconds: zod.ZodInt;
+            size: zod.ZodNullable<zod.ZodString>;
+            quality: zod.ZodNullable<zod.ZodString>;
+            resolution: zod.ZodNullable<zod.ZodString>;
+        }, zod.z.core.$strict>, zod.ZodNull]>>;
         requests: zod.ZodInt;
     }, zod.z.core.$strict>>;
 }, zod.z.core.$strict>;

package/dist/canopy/v1/generated/validators/modelUsageResource.zod.d.ts

@@ -46,6 +46,15 @@ export declare const ModelUsageResource: zod.ZodObject<{
     model_id: zod.ZodString;
     output_tokens: zod.ZodInt;
     reasoning_tokens: zod.ZodInt;
+    media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        images: zod.ZodInt;
+        audio_characters: zod.ZodInt;
+        audio_seconds: zod.ZodInt;
+        video_seconds: zod.ZodInt;
+        size: zod.ZodNullable<zod.ZodString>;
+        quality: zod.ZodNullable<zod.ZodString>;
+        resolution: zod.ZodNullable<zod.ZodString>;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
     requests: zod.ZodInt;
 }, zod.z.core.$strict>;
 export type ModelUsageResource = zod.input<typeof ModelUsageResource>;

package/dist/canopy/v1/generated/validators/modelUsageResource.zod.js

@@ -39,6 +39,7 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { MediaUsage } from "./mediaUsage.zod.js";
 export const ModelUsageResource = zod.strictObject({
     cache_read_tokens: zod.int(),
     cache_write_tokens: zod.int(),
@@ -46,5 +47,9 @@ export const ModelUsageResource = zod.strictObject({
     model_id: zod.string(),
     output_tokens: zod.int(),
     reasoning_tokens: zod.int(),
+    media: zod
+        .union([MediaUsage, zod.null()])
+        .optional()
+        .describe("Media quantities and their rate dimensions. Null when this range has no media usage."),
     requests: zod.int(),
 });

package/dist/canopy/v1/generated/validators/requestResource.zod.d.ts

@@ -47,7 +47,7 @@ export declare const RequestResource: zod.ZodObject<{
     error_code: zod.ZodString;
     finished_at: zod.ZodNullable<zod.z.ZodISODateTime>;
     first_token_at: zod.ZodNullable<zod.z.ZodISODateTime>;
-    id: zod.ZodUUID;
+    id: zod.ZodString;
     input_tokens: zod.ZodInt;
     model_id: zod.ZodString;
     output_tokens: zod.ZodInt;
@@ -73,6 +73,15 @@ export declare const RequestResource: zod.ZodObject<{
     reasoning: zod.ZodUnion<readonly [zod.ZodObject<{
         requested: zod.ZodRecord<zod.ZodString, zod.ZodUnknown>;
     }, zod.z.core.$strict>, zod.ZodNull]>;
+    media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        images: zod.ZodInt;
+        audio_characters: zod.ZodInt;
+        audio_seconds: zod.ZodInt;
+        video_seconds: zod.ZodInt;
+        size: zod.ZodNullable<zod.ZodString>;
+        quality: zod.ZodNullable<zod.ZodString>;
+        resolution: zod.ZodNullable<zod.ZodString>;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
 }, zod.z.core.$strict>;
 export type RequestResource = zod.input<typeof RequestResource>;
 export type RequestResourceOutput = zod.output<typeof RequestResource>;

package/dist/canopy/v1/generated/validators/requestResource.zod.js

@@ -39,6 +39,7 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { MediaUsage } from "./mediaUsage.zod.js";
 import { ReasoningDiagnostics } from "./reasoningDiagnostics.zod.js";
 export const requestResourceSourceMax = 64;
 export const RequestResource = zod.strictObject({
@@ -53,7 +54,9 @@ export const RequestResource = zod.strictObject({
     error_code: zod.string().describe("The error code on failure. Empty on success"),
     finished_at: zod.iso.datetime({ offset: true }).nullable(),
     first_token_at: zod.iso.datetime({ offset: true }).nullable(),
-    id: zod.uuid(),
+    id: zod
+        .string()
+        .describe("A typed request id such as `req_01j...`. Legacy rows may still be returned as a bare UUID."),
     input_tokens: zod.int(),
     model_id: zod.string().describe("The model named in the request"),
     output_tokens: zod.int(),
@@ -77,4 +80,8 @@ export const RequestResource = zod.strictObject({
         .enum(["none", "upstream", "estimated"])
         .describe("upstream means the figures were reported by the provider; estimated means they were derived from the character classes of the payload"),
     reasoning: zod.union([ReasoningDiagnostics, zod.null()]),
+    media: zod
+        .union([MediaUsage, zod.null()])
+        .optional()
+        .describe("Media quantities and their rate dimensions. Null for a token-only request."),
 });

package/dist/canopy/v1/generated/validators/totalsResource.zod.d.ts

@@ -45,6 +45,15 @@ export declare const TotalsResource: zod.ZodObject<{
     input_tokens: zod.ZodInt;
     output_tokens: zod.ZodInt;
     reasoning_tokens: zod.ZodInt;
+    media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        images: zod.ZodInt;
+        audio_characters: zod.ZodInt;
+        audio_seconds: zod.ZodInt;
+        video_seconds: zod.ZodInt;
+        size: zod.ZodNullable<zod.ZodString>;
+        quality: zod.ZodNullable<zod.ZodString>;
+        resolution: zod.ZodNullable<zod.ZodString>;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
     requests: zod.ZodInt;
 }, zod.z.core.$strict>;
 export type TotalsResource = zod.input<typeof TotalsResource>;

package/dist/canopy/v1/generated/validators/totalsResource.zod.js

@@ -39,11 +39,16 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { MediaUsage } from "./mediaUsage.zod.js";
 export const TotalsResource = zod.strictObject({
     cache_read_tokens: zod.int(),
     cache_write_tokens: zod.int(),
     input_tokens: zod.int(),
     output_tokens: zod.int(),
     reasoning_tokens: zod.int(),
+    media: zod
+        .union([MediaUsage, zod.null()])
+        .optional()
+        .describe("Media quantities and their rate dimensions. Null when this range has no media usage."),
     requests: zod.int(),
 });

package/dist/canopy/v1/generated/validators/usageBucketResource.zod.d.ts

@@ -46,6 +46,15 @@ export declare const UsageBucketResource: zod.ZodObject<{
     input_tokens: zod.ZodInt;
     output_tokens: zod.ZodInt;
     reasoning_tokens: zod.ZodInt;
+    media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+        images: zod.ZodInt;
+        audio_characters: zod.ZodInt;
+        audio_seconds: zod.ZodInt;
+        video_seconds: zod.ZodInt;
+        size: zod.ZodNullable<zod.ZodString>;
+        quality: zod.ZodNullable<zod.ZodString>;
+        resolution: zod.ZodNullable<zod.ZodString>;
+    }, zod.z.core.$strict>, zod.ZodNull]>>;
     requests: zod.ZodInt;
     to: zod.z.ZodISODateTime;
 }, zod.z.core.$strict>;

package/dist/canopy/v1/generated/validators/usageBucketResource.zod.js

@@ -39,6 +39,7 @@
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from "zod";
+import { MediaUsage } from "./mediaUsage.zod.js";
 export const UsageBucketResource = zod.strictObject({
     cache_read_tokens: zod.int(),
     cache_write_tokens: zod.int(),
@@ -46,6 +47,10 @@ export const UsageBucketResource = zod.strictObject({
     input_tokens: zod.int(),
     output_tokens: zod.int(),
     reasoning_tokens: zod.int(),
+    media: zod
+        .union([MediaUsage, zod.null()])
+        .optional()
+        .describe("Media quantities and their rate dimensions. Null when this range has no media usage."),
     requests: zod.int(),
     to: zod.iso.datetime({ offset: true }).describe("End of the bucket, exclusive"),
 });

package/dist/canopy/v1/generated/validators/usageTimelineResponseBody.zod.d.ts

@@ -47,6 +47,15 @@ export declare const UsageTimelineResponseBody: zod.ZodObject<{
         input_tokens: zod.ZodInt;
         output_tokens: zod.ZodInt;
         reasoning_tokens: zod.ZodInt;
+        media: zod.ZodOptional<zod.ZodUnion<readonly [zod.ZodObject<{
+            images: zod.ZodInt;
+            audio_characters: zod.ZodInt;
+            audio_seconds: zod.ZodInt;
+            video_seconds: zod.ZodInt;
+            size: zod.ZodNullable<zod.ZodString>;
+            quality: zod.ZodNullable<zod.ZodString>;
+            resolution: zod.ZodNullable<zod.ZodString>;
+        }, zod.z.core.$strict>, zod.ZodNull]>>;
         requests: zod.ZodInt;
         to: zod.z.ZodISODateTime;
     }, zod.z.core.$strict>>;

package/dist/canopy/v1/generated/validators/videoCapabilities.zod.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Canopy model inference, API keys, model catalogue, service enablement and recorded usage.
+ *
+ * Project inference is served on this host in each provider's own protocol:
+ *
+ * - OpenAI: `/v1/chat/completions`, `/v1/responses` and `/v1/embeddings`; use
+ *   `https://canopy.leaflow.cloud/v1` as the OpenAI SDK base URL.
+ * - Anthropic: `/v1/messages`; use `https://canopy.leaflow.cloud` as the Anthropic SDK base URL.
+ * - Gemini: `/v1beta/models/{model}:generateContent` and `:streamGenerateContent`.
+ *
+ * Canopy does not convert between protocols. A request is accepted only for a model whose
+ * `supported_endpoints` lists the endpoint it was sent to, and it is forwarded unchanged except for
+ * the model name and the credentials. Reasoning settings such as `reasoning_effort` are passed
+ * through as written; a model's `capabilities` lists the values its upstream accepts.
+ *
+ * Management operations use `/api/v1`. The management model catalogue names how each model is billed in Billing;
+ * `/v1/models` returns the OpenAI model format with Canopy capabilities and parameter limits.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * Management and project inference accept the same verified IAM scoped token. The token is the
+ * sole billing project authority; `OpenAI-Project` and historical identity headers cannot
+ * override it. These endpoints do not accept a Canopy API key. The separate API-key gateway
+ * accepts Canopy API keys and serves the same endpoints.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days, or 400 days for the usage timeline. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates Billing holds for each model's `billing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export declare const VideoCapabilities: zod.ZodObject<{
+    seconds: zod.ZodNullable<zod.ZodArray<zod.ZodInt>>;
+    sizes: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+    resolutions: zod.ZodNullable<zod.ZodArray<zod.ZodString>>;
+    supports_input_reference: zod.ZodNullable<zod.ZodBoolean>;
+    supports_remix: zod.ZodNullable<zod.ZodBoolean>;
+    supports_characters: zod.ZodNullable<zod.ZodBoolean>;
+}, zod.z.core.$strict>;
+export type VideoCapabilities = zod.input<typeof VideoCapabilities>;
+export type VideoCapabilitiesOutput = zod.output<typeof VideoCapabilities>;

package/dist/canopy/v1/generated/validators/videoCapabilities.zod.js

@@ -0,0 +1,69 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Leaflow Canopy API
+ * Canopy model inference, API keys, model catalogue, service enablement and recorded usage.
+ *
+ * Project inference is served on this host in each provider's own protocol:
+ *
+ * - OpenAI: `/v1/chat/completions`, `/v1/responses` and `/v1/embeddings`; use
+ *   `https://canopy.leaflow.cloud/v1` as the OpenAI SDK base URL.
+ * - Anthropic: `/v1/messages`; use `https://canopy.leaflow.cloud` as the Anthropic SDK base URL.
+ * - Gemini: `/v1beta/models/{model}:generateContent` and `:streamGenerateContent`.
+ *
+ * Canopy does not convert between protocols. A request is accepted only for a model whose
+ * `supported_endpoints` lists the endpoint it was sent to, and it is forwarded unchanged except for
+ * the model name and the credentials. Reasoning settings such as `reasoning_effort` are passed
+ * through as written; a model's `capabilities` lists the values its upstream accepts.
+ *
+ * Management operations use `/api/v1`. The management model catalogue names how each model is billed in Billing;
+ * `/v1/models` returns the OpenAI model format with Canopy capabilities and parameter limits.
+ *
+ * ## Authentication
+ *
+ * Every request carries a scoped token; see the `bearerAuth` security scheme.
+ *
+ * Management and project inference accept the same verified IAM scoped token. The token is the
+ * sole billing project authority; `OpenAI-Project` and historical identity headers cannot
+ * override it. These endpoints do not accept a Canopy API key. The separate API-key gateway
+ * accepts Canopy API keys and serves the same endpoints.
+ *
+ * ## Conventions
+ *
+ * - **The plaintext of an API key is returned once.** The `secret` appears in the response that issues it and is returned by no other endpoint. A key that has been lost has to be revoked and reissued.
+ * - **Disabling and revoking are distinct.** A disabled key may be enabled again at any time, while a revocation is irreversible and is intended for a key that has been exposed. Neither removes the record, and the usage the key accrued remains readable.
+ * - **A usage query must carry a time range**, spanning no more than 31 days, or 400 days for the usage timeline. `from` and `to` carry a timezone offset, which the server does not infer.
+ * - **The request and response bodies do not appear in the ledger.** They are not recorded. Quote the `upstream_request_id` from the response when reporting a problem.
+ * - **Usage may be estimated.** The upstream provider does not report usage on every request. Where it does not, `usage_source` is `estimated` and the figures are derived from the character classes of the payload, to within roughly fifteen per cent.
+ * - **The service is enabled before use.** A project enables the model platform once, through `create-service`; the forwarding endpoints refuse its requests until the service is `active`. Requests are then billed under the service's subscription by the tokens they use, at the rates Billing holds for each model's `billing`.
+ * OpenAPI spec version: 1.0.0
+ */
+import * as zod from "zod";
+export const VideoCapabilities = zod
+    .strictObject({
+    seconds: zod
+        .array(zod.int().min(1))
+        .nullable()
+        .describe("Durations the upstream accepts, in seconds. Null means unknown."),
+    sizes: zod
+        .array(zod.string())
+        .nullable()
+        .describe("Output sizes the upstream accepts, such as 1280x720. Null means unknown."),
+    resolutions: zod
+        .array(zod.string())
+        .nullable()
+        .describe("Resolution tiers the upstream accepts, such as 720p or 1080p. Null means unknown."),
+    supports_input_reference: zod
+        .boolean()
+        .nullable()
+        .describe("Whether a request may carry a reference image. Null means unknown."),
+    supports_remix: zod
+        .boolean()
+        .nullable()
+        .describe("Whether a generated video can be remixed into another task. Null means unknown."),
+    supports_characters: zod
+        .boolean()
+        .nullable()
+        .describe("Whether the upstream accepts reusable characters. Null means unknown."),
+})
+    .describe("The video parameters this endpoint accepts. Video is asynchronous on every endpoint that supports it. Create returns a task, and the task is polled separately.");