import {z} from 'zod' export type GettyImagesServicesConnectPublicControllersSearchModelAgeOfPeopleFilterType = 'newborn' | 'baby' | 'child' | 'teenager' | 'young_adult' | 'adult' | 'adults_only' | 'mature_adult' | 'senior_adult' | '0-1_months' | '2-5_months' | '6-11_months' | '12-17_months' | '18-23_months' | '2-3_years' | '4-5_years' | '6-7_years' | '8-9_years' | '10-11_years' | '12-13_years' | '14-15_years' | '16-17_years' | '18-19_years' | '20-24_years' | '20-29_years' | '25-29_years' | '30-34_years' | '30-39_years' | '35-39_years' | '40-44_years' | '40-49_years' | '45-49_years' | '50-54_years' | '50-59_years' | '55-59_years' | '60-64_years' | '60-69_years' | '65-69_years' | '70-79_years' | '80-89_years' | '90_plus_years' | '100_over'; export type GettyImagesServicesConnectPublicControllersSearchModelVideoAspectRatioFilterType = '16:9' | '9:16' | '3:4' | '4:3' | '4:5' | '2:1' | '17:9' | '9:17'; export type GettyImagesServicesConnectPublicControllersSearchModelCollectionsFilterType = 'include' | 'exclude'; export type GettyImagesServicesConnectPublicControllersSearchModelCompositionsFilterType = 'abstract' | 'candid' | 'close_up' | 'copy_space' | 'cut_out' | 'full_frame' | 'full_length' | 'headshot' | 'looking_at_camera' | 'macro' | 'medium_shot' | 'part_of_a_series' | 'portrait' | 'sparse' | 'still_life' | 'three_quarter_length' | 'waist_up' | 'wide_shot'; export type GettyImagesServicesConnectPublicControllersSearchModelEthnicityFilterType = 'black' | 'white' | 'east_asian' | 'hispanic_latinx' | 'japanese' | 'middle_eastern' | 'multiracial_person' | 'multiethnic_group' | 'native_american_first_nations' | 'pacific_islander' | 'south_asian' | 'southeast_asian'; export type GettyImagesServicesConnectPublicControllersSearchFacetsCreateVideoSearchFacetsFields = 'artists' | 'locations'; export type GettyImagesServicesConnectPublicControllersSearchModelCreativeVideosFieldValues = 'allowed_use' | 'artist' | 'aspect_ratio' | 'asset_family' | 'call_for_image' | 'caption' | 'clip_length' | 'collection_code' | 'collection_id' | 'collection_name' | 'color_type' | 'comp' | 'copyright' | 'date_created' | 'date_submitted' | 'display_set' | 'download_product' | 'download_sizes' | 'era' | 'id' | 'istock_collection' | 'istock_exclusive' | 'keywords' | 'largest_downloads' | 'license_model' | 'mastered_to' | 'object_name' | 'orientation' | 'originally_shot_on' | 'preview' | 'product_types' | 'quality_rank' | 'referral_destinations' | 'shot_speed' | 'summary_set' | 'thumb' | 'title'; export type GettyImagesServicesConnectPublicModelsVideoFormatsRequest = 'sd' | 'hd' | '4k' | 'hd_web'; export type GettyImagesServicesConnectPublicModelsVideoFrameRates = '23.98' | '24' | '25' | '29.97' | '30' | '50' | '59.94' | '60'; export type GettyImagesServicesConnectPublicControllersSearchModelImageTechniquesFilterType = 'realtime' | 'time_lapse' | 'slow_motion' | 'color' | 'black_and_white' | 'animation' | 'selective_focus'; export type GettyImagesServicesConnectPublicModelsLicenseModelVideoRequest = 'rightsready' | 'royaltyfree'; export type GettyImagesServicesConnectPublicControllersSearchModelNumberOfPeopleFilterType = 'none' | 'one' | 'two' | 'group'; export type GettyImagesServicesConnectPublicModelsVideoOrientationRequest = 'horizontal' | 'vertical'; export type GettyImagesServicesConnectPublicControllersSearchModelCreativeVideoSortOrder = 'best_match' | 'most_popular' | 'newest' | 'random'; export type GettyImagesServicesConnectPublicControllersSearchModelReleaseStatus = 'release_not_important' | 'fully_released'; export type GettyImagesServicesConnectPublicControllersSearchModelViewpointsFilterType = 'lockdown' | 'panning' | 'tracking_shot' | 'aerial_view' | 'high_angle_view' | 'low_angle_view' | 'tilt' | 'point_of_view'; export type GetApiV3SearchVideosCreativeArgs = {'Accept-Language'?: string | undefined, 'GI-Country-Code'?: string | undefined, age_of_people?: Array | undefined, artists?: string | undefined, aspect_ratios?: Array | undefined, collection_codes?: Array | undefined, collections_filter_type?: GettyImagesServicesConnectPublicControllersSearchModelCollectionsFilterType | undefined, compositions?: Array | undefined, download_product?: string | undefined, enhanced_search?: boolean | undefined, ethnicity?: Array | undefined, exclude_editorial_use_only?: boolean | undefined, exclude_keyword_ids?: Array | undefined, exclude_nudity?: boolean | undefined, facet_fields?: Array | undefined, facet_max_count?: number | undefined, fields?: Array | undefined, format_available?: GettyImagesServicesConnectPublicModelsVideoFormatsRequest | undefined, frame_rates?: Array | undefined, image_techniques?: Array | undefined, include_facets?: boolean | undefined, include_related_searches?: boolean | undefined, istock_exclusive?: boolean | undefined, keyword_ids?: Array | undefined, license_models?: Array | undefined, min_clip_length?: number | undefined, max_clip_length?: number | undefined, number_of_people?: Array | undefined, orientations?: Array | undefined, page?: number | undefined, page_size?: number | undefined, phrase?: string | undefined, safe_search?: boolean | undefined, sort_order?: GettyImagesServicesConnectPublicControllersSearchModelCreativeVideoSortOrder | undefined, release_status?: GettyImagesServicesConnectPublicControllersSearchModelReleaseStatus | undefined, viewpoints?: Array | undefined}; export type GetApiV3SearchVideosCreativeOptions = {baseUrl: string, ApiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const gettyImagesServicesConnectPublicModelsAllowedUse = z.object({how_can_i_use_it: z.string().nullable().optional(), release_info: z.string().nullable().optional(), usage_restrictions: z.array(z.string()).nullable().optional(), editorial_use_only: z.boolean().optional()}); export const gettyImagesServicesConnectPublicModelsSearchVideoSearchItemDisplaySize = z.object({is_watermarked: z.boolean().optional(), name: z.string().nullable().optional(), uri: z.string().nullable().optional(), aspect_ratio: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsVideosVideoDownloadAuthorization = z.object({product_id: z.string().nullable().optional(), product_type: z.string().nullable().optional(), uri: z.string().nullable().optional(), agreement_name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsVideosVideoDownloadSize = z.object({bit_depth: z.string().nullable().optional(), broadcast_video_standard: z.string().nullable().optional(), compression: z.string().nullable().optional(), content_type: z.string().nullable().optional(), description: z.string().nullable().optional(), downloads: z.array(gettyImagesServicesConnectPublicModelsVideosVideoDownloadAuthorization).nullable().optional(), format: z.string().nullable().optional(), frame_rate: z.number().nullable().optional(), frame_size: z.string().nullable().optional(), height: z.number().nullable().optional(), interlaced: z.boolean().optional(), bytes: z.number().int().optional(), name: z.string().nullable().optional(), width: z.number().int().optional()}); export const gettyImagesServicesConnectPublicModelsKeyword = z.object({keyword_id: z.string().nullable().optional(), text: z.string().nullable().optional(), type: z.string().nullable().optional(), relevance: z.number().int().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsDownload = z.object({product_id: z.string().nullable().optional(), product_type: z.string().nullable().optional(), uri: z.string().nullable().optional(), agreement_name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsMaxDimensions = z.object({height: z.number().int().optional(), width: z.number().int().optional()}); export const gettyImagesServicesConnectPublicModelsReferralDestination = z.object({site_name: z.string().nullable().optional(), uri: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicDomainServicesCreditPackAssetLicenseName = z.enum(["Standard", "Multiseat", "Unlimited", "Resale", "Indemnification"]); export const gettyImagesServicesConnectPublicModelsIStockLicense = z.object({license_type: gettyImagesServicesConnectPublicDomainServicesCreditPackAssetLicenseName.optional(), credits: z.number().int().optional()}); export const gettyImagesServicesConnectPublicModelsSearchNewModelsVideoVideo = z.object({id: z.string().nullable().optional(), allowed_use: gettyImagesServicesConnectPublicModelsAllowedUse.optional(), alternative_ids: z.record(z.string(), z.string().nullable()).nullable().optional(), artist: z.string().nullable().optional(), aspect_ratio: z.string().nullable().optional(), asset_family: z.string().nullable().optional(), asset_type: z.string().nullable().optional(), call_for_image: z.boolean().nullable().optional(), caption: z.string().nullable().optional(), clip_length: z.string().nullable().optional(), collection_id: z.number().int().nullable().optional(), collection_code: z.string().nullable().optional(), collection_name: z.string().nullable().optional(), color_type: z.string().nullable().optional(), copyright: z.string().nullable().optional(), date_camera_shot: z.string().nullable().optional(), date_created: z.string().nullable().optional(), date_submitted: z.string().nullable().optional(), display_sizes: z.array(gettyImagesServicesConnectPublicModelsSearchVideoSearchItemDisplaySize).nullable().optional(), download_product: z.string().nullable().optional(), download_sizes: z.array(gettyImagesServicesConnectPublicModelsVideosVideoDownloadSize).nullable().optional(), istock_collection: z.string().nullable().optional(), istock_exclusive: z.boolean().nullable().optional(), keywords: z.array(gettyImagesServicesConnectPublicModelsKeyword).nullable().optional(), largest_downloads: z.array(gettyImagesServicesConnectPublicModelsDownload).nullable().optional(), license_model: z.string().nullable().optional(), mastered_to: z.string().nullable().optional(), max_dimensions: gettyImagesServicesConnectPublicModelsMaxDimensions.optional(), orientation: z.string().nullable().optional(), originally_shot_on: z.string().nullable().optional(), product_types: z.array(z.string()).nullable().optional(), quality_rank: z.number().int().nullable().optional(), referral_destinations: z.array(gettyImagesServicesConnectPublicModelsReferralDestination).nullable().optional(), shot_speed: z.string().nullable().optional(), title: z.string().nullable().optional(), istock_licenses: z.array(gettyImagesServicesConnectPublicModelsIStockLicense).nullable().optional(), object_name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsSpecificPeople = z.object({id: z.number().int().optional(), name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsFacetEvent = z.object({id: z.number().int().optional(), name: z.string().nullable().optional(), date: z.string().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsLocation = z.object({id: z.number().int().optional(), name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsArtist = z.object({name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsEntertainment = z.object({id: z.number().int().optional(), name: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicControllersSearchFacetsSearchFacetsResponse = z.object({specific_people: z.array(gettyImagesServicesConnectPublicControllersSearchFacetsSpecificPeople).nullable().optional(), events: z.array(gettyImagesServicesConnectPublicControllersSearchFacetsFacetEvent).nullable().optional(), locations: z.array(gettyImagesServicesConnectPublicControllersSearchFacetsLocation).nullable().optional(), artists: z.array(gettyImagesServicesConnectPublicControllersSearchFacetsArtist).nullable().optional(), entertainment: z.array(gettyImagesServicesConnectPublicControllersSearchFacetsEntertainment).nullable().optional()}); export const gettyImagesServicesConnectPublicDomainServicesAssetRelatedSearch = z.object({phrase: z.string().nullable().optional(), url: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsSearchAutoCorrections = z.object({phrase: z.string().nullable().optional()}); export const gettyImagesServicesConnectPublicModelsSearchNewModelsVideoVideoSearchResponse1GettyImagesServicesConnectPublicModelsSearchNewModelsVideoVideo = z.object({videos: z.array(gettyImagesServicesConnectPublicModelsSearchNewModelsVideoVideo).nullable().optional(), facets: gettyImagesServicesConnectPublicControllersSearchFacetsSearchFacetsResponse.optional(), related_searches: z.array(gettyImagesServicesConnectPublicDomainServicesAssetRelatedSearch).nullable().optional(), result_count: z.number().int().optional(), auto_corrections: gettyImagesServicesConnectPublicModelsSearchAutoCorrections.optional()}); 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 }; /** * Search for creative videos * * GET /v3/search/videos/creative * * Also accepts auth: OAuth2 */ export const getApiV3SearchVideosCreative = async (args: GetApiV3SearchVideosCreativeArgs, options: GetApiV3SearchVideosCreativeOptions) => { const {baseUrl, fetch: fetchFn = fetch, ApiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args['Accept-Language'] != null) headers.set("Accept-Language", String(args['Accept-Language'])) if (args['GI-Country-Code'] != null) headers.set("GI-Country-Code", String(args['GI-Country-Code'])) if (args.age_of_people != null) query.append("age_of_people", args.age_of_people.join(',')) if (args.artists != null) query.append("artists", String(args.artists)) if (args.aspect_ratios != null) query.append("aspect_ratios", args.aspect_ratios.join(',')) if (args.collection_codes != null) query.append("collection_codes", args.collection_codes.join(',')) if (args.collections_filter_type != null) query.append("collections_filter_type", String(args.collections_filter_type)) if (args.compositions != null) query.append("compositions", args.compositions.join(',')) if (args.download_product != null) query.append("download_product", String(args.download_product)) if (args.enhanced_search != null) query.append("enhanced_search", String(args.enhanced_search)) if (args.ethnicity != null) query.append("ethnicity", args.ethnicity.join(',')) if (args.exclude_editorial_use_only != null) query.append("exclude_editorial_use_only", String(args.exclude_editorial_use_only)) if (args.exclude_keyword_ids != null) query.append("exclude_keyword_ids", args.exclude_keyword_ids.join(',')) if (args.exclude_nudity != null) query.append("exclude_nudity", String(args.exclude_nudity)) if (args.facet_fields != null) query.append("facet_fields", args.facet_fields.join(',')) if (args.facet_max_count != null) query.append("facet_max_count", String(args.facet_max_count)) if (args.fields != null) query.append("fields", args.fields.join(',')) if (args.format_available != null) query.append("format_available", String(args.format_available)) if (args.frame_rates != null) query.append("frame_rates", args.frame_rates.join(',')) if (args.image_techniques != null) query.append("image_techniques", args.image_techniques.join(',')) if (args.include_facets != null) query.append("include_facets", String(args.include_facets)) if (args.include_related_searches != null) query.append("include_related_searches", String(args.include_related_searches)) if (args.istock_exclusive != null) query.append("istock_exclusive", String(args.istock_exclusive)) if (args.keyword_ids != null) query.append("keyword_ids", args.keyword_ids.join(',')) if (args.license_models != null) query.append("license_models", args.license_models.join(',')) if (args.min_clip_length != null) query.append("min_clip_length", String(args.min_clip_length)) if (args.max_clip_length != null) query.append("max_clip_length", String(args.max_clip_length)) if (args.number_of_people != null) query.append("number_of_people", args.number_of_people.join(',')) if (args.orientations != null) query.append("orientations", args.orientations.join(',')) if (args.page != null) query.append("page", String(args.page)) if (args.page_size != null) query.append("page_size", String(args.page_size)) if (args.phrase != null) query.append("phrase", String(args.phrase)) if (args.safe_search != null) query.append("safe_search", String(args.safe_search)) if (args.sort_order != null) query.append("sort_order", String(args.sort_order)) if (args.release_status != null) query.append("release_status", String(args.release_status)) if (args.viewpoints != null) query.append("viewpoints", args.viewpoints.join(',')) if (ApiKey !== undefined) headers.set("Api-Key", ApiKey) const url = `${baseUrl.replace(/\/+$/, '')}/v3/search/videos/creative${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(gettyImagesServicesConnectPublicModelsSearchNewModelsVideoVideoSearchResponse1GettyImagesServicesConnectPublicModelsSearchNewModelsVideoVideo, await res.json()) };