import {z} from 'zod' export type GetApiApiV2ModelGroupsOptions = {baseUrl?: string | undefined, apiKeyAuth?: string | undefined, appKeyAuth?: string | undefined, fetch?: typeof fetch | undefined}; export const aiGatewayNullableMaxReasoningLevel = z.enum(["none", "minimal", "low", "medium", "high", "xhigh", "max"]).nullable(); export const aiGatewayModelCapabilities = z.object({attachment: z.boolean().optional(), interleaved_reasoning: z.boolean().optional(), reasoning: z.boolean().optional(), structured_output: z.boolean().optional(), temperature: z.boolean().optional(), tool_call: z.boolean().optional()}); export const aiGatewayModelMetadataKind = z.enum(["language", "embedding", "image", "audio", "decision", "reranking"]); export const aiGatewayModelMetadataLifecycle = z.enum(["active", "alpha", "beta", "deprecated"]); export const aiGatewayModelLimits = z.object({context_window_tokens: z.number().int().gte(0).optional(), max_input_tokens: z.number().int().gte(0).optional(), max_output_tokens: z.number().int().gte(0).optional()}); export const aiGatewayModelModalities = z.object({input: z.array(z.string()).optional(), output: z.array(z.string()).optional()}); export const aiGatewayModelReasoningControlType = z.enum(["toggle", "effort", "budget_tokens"]); export const aiGatewayModelReasoningControl = z.object({effort_levels: z.array(z.string().nullable()).optional(), max_budget_tokens: z.number().int().gte(0).optional(), min_budget_tokens: z.number().int().gte(-1).optional(), type: aiGatewayModelReasoningControlType}); export const aiGatewayModelReasoning = z.object({controls: z.array(aiGatewayModelReasoningControl)}); export const aiGatewayModelReferencePrice = z.object({amount: z.string(), component: z.string(), context_max_tokens: z.number().int().gte(1).optional(), context_min_tokens: z.number().int().gte(0), currency: z.string(), mode: z.string(), service_tier: z.string().optional(), unit: z.string()}); export const aiGatewayModelMetadataSourceMatchedBy = z.enum(["override", "wire_id", "canonical_id", "wire_id_date_suffix", "canonical_model"]); export const aiGatewayModelMetadataSource = z.object({matched_by: aiGatewayModelMetadataSourceMatchedBy, model_id: z.string(), name: z.string(), observed_at: z.string().optional(), provider: z.string(), revision: z.string().optional()}); export const aiGatewayModelMetadataStatus = z.enum(["available", "partial"]); export const aiGatewayModelMetadata = z.object({capabilities: aiGatewayModelCapabilities, description: z.string().optional(), display_name: z.string().optional(), family: z.string().optional(), kind: aiGatewayModelMetadataKind.optional(), knowledge_cutoff: z.string().optional(), last_updated: z.string().optional(), lifecycle: aiGatewayModelMetadataLifecycle.optional(), limits: aiGatewayModelLimits, modalities: aiGatewayModelModalities, open_weights: z.boolean().optional(), reasoning: aiGatewayModelReasoning.optional(), reference_pricing: z.array(aiGatewayModelReferencePrice).optional(), release_date: z.string().optional(), source: aiGatewayModelMetadataSource, status: aiGatewayModelMetadataStatus}); export const aiGatewayModelSource = z.enum(["discovered", "manual"]); export const aiGatewaySupportedOperation = z.enum(["ANTHROPIC_MESSAGES", "ANTHROPIC_COUNT_TOKENS", "OPENAI_CHAT_COMPLETIONS", "OPENAI_RESPONSES", "OPENAI_WEB_SEARCH", "OPENAI_EMBEDDINGS", "GEMINI_GENERATE_CONTENT", "GEMINI_RAW_PREDICTIONS"]); export const aiGatewayModelGroupModel = z.object({created_at: z.string(), enabled: z.boolean(), id: z.string(), metadata: aiGatewayModelMetadata.optional(), model_id_canonical: z.string(), model_id_wire: z.string(), provider_id: z.number().int(), source: aiGatewayModelSource, supported_operations: z.array(aiGatewaySupportedOperation), updated_at: z.string()}); export const aiGatewayModelGroupProvider = z.object({id: z.number().int().gte(1), name: z.string()}); export const aiGatewayModelGroupRoutingRule = z.object({slug: z.string()}); export const aiGatewayModelGroupAttributes = z.object({allow_fast_mode: z.boolean(), created_at: z.string(), max_reasoning_level: aiGatewayNullableMaxReasoningLevel, model_ids: z.array(z.number().int().gte(1)), models: z.array(aiGatewayModelGroupModel), name: z.string(), provider_ids: z.array(z.number().int().gte(1)), providers: z.array(aiGatewayModelGroupProvider), revision: z.number().int().gte(0).optional(), routing_rules: z.array(aiGatewayModelGroupRoutingRule), updated_at: z.string()}); export const aiGatewayModelGroupType = z.literal("model-groups"); export const aiGatewayModelGroupResource = z.object({attributes: aiGatewayModelGroupAttributes, id: z.string(), type: aiGatewayModelGroupType}); export const aiGatewayModelGroupListResponse = z.object({data: z.array(aiGatewayModelGroupResource)}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * List AI Gateway model groups * * GET /api/v2/model-groups * * Also accepts auth: AuthZ */ export const getApiApiV2ModelGroups = async (options?: GetApiApiV2ModelGroupsOptions) => { const {baseUrl = "https://api.datadoghq.com", fetch: fetchFn = fetch, apiKeyAuth, appKeyAuth} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (apiKeyAuth !== undefined) headers.set("DD-API-KEY", apiKeyAuth) if (appKeyAuth !== undefined) headers.set("DD-APPLICATION-KEY", appKeyAuth) const url = `${baseUrl.replace(/\/+$/, '')}/api/v2/model-groups${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(aiGatewayModelGroupListResponse, await res.json()) };