{"openapi":"3.1.0","info":{"title":"Wesog API","description":"Wesog AI services for media providers","version":"1.0.0"},"servers":[{"url":"https://api.wesog.com","description":"Production server"},{"url":"https://v2.api.wesog.com","description":"Production server (v2)"}],"paths":{"/me":{"get":{"tags":["Roles"],"summary":"Get my role","description":"Get information about my role like client name, role name... (using the provided api key)","operationId":"read_me_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/ops/":{"get":{"tags":["Operations"],"summary":"See all operations","operationId":"get_all_operations_ops__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/ops/{op_id}":{"get":{"tags":["Operations"],"summary":"Check operation status","operationId":"operation_status_ops__op_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"op_id","in":"path","required":true,"schema":{"type":"integer","title":"Op Id"}}],"responses":{"200":{"description":"Operation status successfully retrieved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Operations"],"summary":"Abort current running operation","operationId":"operation_delete_ops__op_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"op_id","in":"path","required":true,"schema":{"type":"integer","title":"Op Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/tag/image":{"post":{"tags":["Wesog Tag"],"summary":"Tag an image","description":"Analyze a single image and return visual metadata. The request must provide exactly one input source: either `image` or `image_url`. This endpoint does not accept batches or multiple files in the same call.","operationId":"tag_image_tag_image_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_tag_image_tag_image_post","oneOf":[{"required":["image"]},{"required":["image_url"]}],"properties":{"image":{"type":"string","format":"binary","description":"Binary image file to analyze. Use this or `image_url`, but not both."},"image_url":{"type":"string","format":"uri","description":"Publicly reachable image URL to analyze instead of uploading a file."},"lang":{"type":"string","description":"Language used for language-dependent outputs such as caption or keywords.","default":"en","example":"en"},"mode":{"type":"string","description":"Tagging profile. Currently the default documented mode is `editorial`.","default":"editorial","example":"editorial"},"date":{"type":"string","description":"Optional image context date, typically in ISO format `YYYY-MM-DD`. Helps downstream people and caption enrichment.","default":"","example":"2025-10-16"},"event":{"type":"string","description":"Optional event name associated with the image, used as context for enriched outputs.","default":"","example":"Carabao Cup winners presentation"},"city":{"type":"string","description":"Optional city associated with the image context.","default":"","example":"London"},"country":{"type":"string","description":"Optional country associated with the image context.","default":"","example":"United Kingdom"},"caption":{"type":"boolean","description":"When `true`, include an AI-generated caption in the response.","default":false},"keywords":{"type":"boolean","description":"When `true`, include generated keyword tags in the response.","default":false},"ocr":{"type":"boolean","description":"When `true`, include OCR text extracted from the image.","default":false},"colors":{"type":"boolean","description":"When `true`, include dominant colors and black-and-white detection.","default":false}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagImageResponse"}}}},"400":{"description":"Invalid input combination.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagErrorResponse"}}}},"422":{"description":"Validation error in multipart form fields."}},"security":[{"APIKeyHeader":[]}]}},"/query_imgs":{"post":{"tags":["Query Images"],"summary":"Upload 1 query image","description":"Upload 1 image file to be used in a reverse image search. This endpoint returns an image hash that can be used as a reference later in the search query.","operationId":"upload_query_image_query_imgs_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_query_image_query_imgs_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/imgs/{image_id}":{"get":{"tags":["Images"],"summary":"Get 1 image","description":"Get a image by its ID.","operationId":"get_1_imgs__image_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"fields","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["image_id","src","url_img_watermark","url_img_thumbnail","title","headline","caption","alt_text","ai_generated","model_release","property_release","nsfw","status","date","location","city","country","event","author","provider","shot","scene","technique","medium","keywords","categories","collections","height","width","n_faces"]},"description":"List of fields to retrieve. Example: fields=title&fields=description","default":["height","width","src","url_img_watermark","url_img_thumbnail","n_faces","title","headline","caption"],"title":"Fields"},"description":"List of fields to retrieve. Example: fields=title&fields=description"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/image"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Images"],"summary":"Create 1 image","description":"Create a image by its ID.","operationId":"post_1_imgs__image_id__post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Create_1_image"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"201":{"description":"image successfully created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"image creation accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Images"],"summary":"Replace 1 image","description":"Completely replace existing image in DB.","operationId":"put_1_imgs__image_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Create_1_image"}}}},"responses":{"200":{"description":"image successfully replaced","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"image replacement accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Images"],"summary":"Modify 1 image","description":"Partially update certain fields of an existing image by its ID.","operationId":"patch_1_imgs__image_id__patch","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Update_1_image"}}}},"responses":{"200":{"description":"image successfully modified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"image modification accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Images"],"summary":"Delete 1 image","description":"Remove existing image by ID from the database.","operationId":"delete_1_imgs__image_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"}],"responses":{"200":{"description":"image successfully deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"image deletion accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/imgs":{"get":{"tags":["Images"],"summary":"Search N images","description":"Do simple image listing or do advanced image search with filters, sorting, pagination, facets and counting","operationId":"get_n_imgs_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Query filtering formula, must be url-encoded. Similarity uses i~, i~~, i~~~ for semantic similarity search and i=, i==, i=== for visual duplicate-detection search. i==== requests an additional, more precise duplicate-verification pass on the top candidate, slightly slower than the other comparisons; this mode is currently restricted to selected tenants.","default":"","title":"Q"},"description":"Query filtering formula, must be url-encoded. Similarity uses i~, i~~, i~~~ for semantic similarity search and i=, i==, i=== for visual duplicate-detection search. i==== requests an additional, more precise duplicate-verification pass on the top candidate, slightly slower than the other comparisons; this mode is currently restricted to selected tenants."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number. 1 is the first page.","default":1,"title":"Page"},"description":"Page number. 1 is the first page."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"description":"Maximum number of images to return per page","default":50,"title":"Limit"},"description":"Maximum number of images to return per page"},{"name":"sort_by","in":"query","required":false,"schema":{"enum":["","image_id","src","url_img_watermark","url_img_thumbnail","height","width","aspect_ratio","n_faces","date","title","headline","caption","location","city","country","event","author","provider","shot","scene","medium","technique","similarity","sim"],"type":"string","description":"Sorting criterion. Note that sort_by=similarity only works if there are present \"similary filters\" on the Query Filtering Formula.","default":"","title":"Sort By"},"description":"Sorting criterion. Note that sort_by=similarity only works if there are present \"similary filters\" on the Query Filtering Formula."},{"name":"sort_order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Ascending or descending sorting.","default":"desc","title":"Sort Order"},"description":"Ascending or descending sorting."},{"name":"fields","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["image_id","src","url_img_watermark","url_img_thumbnail","title","headline","caption","alt_text","ai_generated","model_release","property_release","nsfw","status","date","location","city","country","event","author","provider","shot","scene","technique","medium","keywords","categories","collections","height","width","n_faces"]},"description":"Array of fields to retrieve. Example: fields=image_id&fields=src","default":["height","width","src","url_img_watermark","url_img_thumbnail","n_faces","title","headline","caption"],"title":"Fields"},"description":"Array of fields to retrieve. Example: fields=image_id&fields=src"},{"name":"facets","in":"query","required":false,"schema":{"type":"array","items":{"enum":["ai_generated","model_release","property_release","nsfw","orientation","status","location","city","country","event","author","provider","shot","scene","medium","technique","keywords","categories","collections"],"type":"string"},"description":"Array of facets to retrieve. Example: facets=author&facets=keywords","default":[],"title":"Facets"},"description":"Array of facets to retrieve. Example: facets=author&facets=keywords"},{"name":"count","in":"query","required":false,"schema":{"type":"boolean","description":"Include total hit count?","default":false,"title":"Count"},"description":"Include total hit count?"},{"name":"lang","in":"query","required":false,"schema":{"enum":["ml","en","es"],"type":"string","description":"Language code.","default":"ml","title":"Lang"},"description":"Language code."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/image_search_response"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Images"],"summary":"Create N images","description":"Create one or more new images.","operationId":"post_n_imgs_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Create_N_images"},"title":"Items"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"201":{"description":"images successfully created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"images creation accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Images"],"summary":"Replace N images","description":"Completely replace existing images in DB.","operationId":"put_n_imgs_put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Create_N_images"},"title":"Items"}}}},"responses":{"200":{"description":"images successfully replaced","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"images replacement accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Images"],"summary":"Modify N images","description":"Partially update certain fields of existing images in the DB.","operationId":"patch_n_imgs_patch","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Update_N_images"},"title":"Items"}}}},"responses":{"200":{"description":"images successfully modified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"images modification accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Images"],"summary":"Delete N images","description":"Remove existing images from the database.","operationId":"delete_n_imgs_delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ImagesIdMandatory"},"title":"Items"}}}},"responses":{"200":{"description":"images successfully deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"images deletion accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/vids/{video_id}":{"get":{"tags":["Videos"],"summary":"Get 1 video","description":"Get a video by its ID.","operationId":"get_1_vids__video_id__get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"fields","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["video_id","src","thumbnail_url","preview_url","img_src","img_zoom","date","location","city","country","event","author","provider","keywords","categories","collections","title","headline","description","alt_text","status","medium","ai_generated","model_release","property_release","nsfw","container","codec_video","codec_audio","height","width","aspect_ratio","fps","duration_secs","id"]},"description":"List of fields to retrieve. Example: fields=title&fields=description","default":["id","src","thumbnail_url","preview_url","img_src","img_zoom","title","headline","duration_secs"],"title":"Fields"},"description":"List of fields to retrieve. Example: fields=title&fields=description"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/video"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Videos"],"summary":"Create 1 video","description":"Create a video by its ID.","operationId":"post_1_vids__video_id__post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Create_1_video"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"201":{"description":"video successfully created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"video creation accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Videos"],"summary":"Replace 1 video","description":"Completely replace existing video in DB.","operationId":"put_1_vids__video_id__put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Create_1_video"}}}},"responses":{"200":{"description":"video successfully replaced","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"video replacement accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Videos"],"summary":"Modify 1 video","description":"Partially update certain fields of an existing video by its ID.","operationId":"patch_1_vids__video_id__patch","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Update_1_video"}}}},"responses":{"200":{"description":"video successfully modified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"video modification accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Videos"],"summary":"Delete 1 video","description":"Remove existing video by ID from the database.","operationId":"delete_1_vids__video_id__delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"}],"responses":{"200":{"description":"video successfully deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"video deletion accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/vids":{"get":{"tags":["Videos"],"summary":"Search N videos","description":"Do simple video listing or do advanced video search with filters, sorting, pagination, facets and counting","operationId":"get_n_vids_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Query filtering formula, must be url-encoded. Similarity uses i~, i~~, i~~~ for semantic similarity search and i=, i==, i=== for visual duplicate-detection search. i==== requests an additional, more precise duplicate-verification pass on the top candidate, slightly slower than the other comparisons; this mode is currently restricted to selected tenants.","default":"","title":"Q"},"description":"Query filtering formula, must be url-encoded. Similarity uses i~, i~~, i~~~ for semantic similarity search and i=, i==, i=== for visual duplicate-detection search. i==== requests an additional, more precise duplicate-verification pass on the top candidate, slightly slower than the other comparisons; this mode is currently restricted to selected tenants."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number. 1 is the first page.","default":1,"title":"Page"},"description":"Page number. 1 is the first page."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"description":"Maximum number of videos to return per page","default":50,"title":"Limit"},"description":"Maximum number of videos to return per page"},{"name":"sort_by","in":"query","required":false,"schema":{"enum":["","id","src","title","headline","date","date_jdn","duration_secs","height","width"],"type":"string","description":"Sorting criterion. Note that sort_by=similarity only works if there are present \"similary filters\" on the Query Filtering Formula.","default":"","title":"Sort By"},"description":"Sorting criterion. Note that sort_by=similarity only works if there are present \"similary filters\" on the Query Filtering Formula."},{"name":"sort_order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Ascending or descending sorting.","default":"desc","title":"Sort Order"},"description":"Ascending or descending sorting."},{"name":"fields","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["video_id","src","thumbnail_url","preview_url","img_src","img_zoom","date","location","city","country","event","author","provider","keywords","categories","collections","title","headline","description","alt_text","status","medium","ai_generated","model_release","property_release","nsfw","container","codec_video","codec_audio","height","width","aspect_ratio","fps","duration_secs","id"]},"description":"Array of fields to retrieve. Example: fields=image_id&fields=src","default":["id","src","thumbnail_url","preview_url","img_src","img_zoom","title","headline","duration_secs"],"title":"Fields"},"description":"Array of fields to retrieve. Example: fields=image_id&fields=src"},{"name":"facets","in":"query","required":false,"schema":{"type":"array","items":{"enum":["ai_generated","model_release","property_release","nsfw","status","medium","location","city","country","event","author","provider","keywords","categories","collections"],"type":"string"},"description":"Array of facets to retrieve. Example: facets=author&facets=keywords","default":[],"title":"Facets"},"description":"Array of facets to retrieve. Example: facets=author&facets=keywords"},{"name":"count","in":"query","required":false,"schema":{"type":"boolean","description":"Include total hit count?","default":false,"title":"Count"},"description":"Include total hit count?"},{"name":"lang","in":"query","required":false,"schema":{"enum":["ml","en","es"],"type":"string","description":"Language code.","default":"ml","title":"Lang"},"description":"Language code."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/video_search_response"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Videos"],"summary":"Create N videos","description":"Create one or more new videos.","operationId":"post_n_vids_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Create_N_videos"},"title":"Items"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"201":{"description":"videos successfully created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"videos creation accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Videos"],"summary":"Replace N videos","description":"Completely replace existing videos in DB.","operationId":"put_n_vids_put","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Create_N_videos"},"title":"Items"}}}},"responses":{"200":{"description":"videos successfully replaced","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"videos replacement accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Videos"],"summary":"Modify N videos","description":"Partially update certain fields of existing videos in the DB.","operationId":"patch_n_vids_patch","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"en|es|pt|fr|ru","default":"es","title":"Lang"},"description":"en|es|pt|fr|ru"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Update_N_videos"},"title":"Items"}}}},"responses":{"200":{"description":"videos successfully modified","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"videos modification accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Videos"],"summary":"Delete N videos","description":"Remove existing videos from the database.","operationId":"delete_n_vids_delete","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"wait","in":"query","required":false,"schema":{"type":"boolean","description":"Wait for completion?","default":false,"title":"Wait"},"description":"Wait for completion?"},{"name":"urgent","in":"query","required":false,"schema":{"type":"boolean","description":"Enqueue at head of queue if True","default":false,"title":"Urgent"},"description":"Enqueue at head of queue if True"},{"name":"strict","in":"query","required":false,"schema":{"type":"boolean","description":"Use strict mode if True","default":false,"title":"Strict"},"description":"Use strict mode if True"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VideosIdMandatory"},"title":"Items"}}}},"responses":{"200":{"description":"videos successfully deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation_Out"}}}},"202":{"description":"videos deletion accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingOperation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_tag_image_tag_image_post":{"properties":{"image":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Image","description":"Binary image file to analyze. Mutually exclusive with `image_url`."},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","description":"Remote image URL to analyze. Mutually exclusive with `image`."},"lang":{"type":"string","title":"Lang","description":"Language used for language-dependent outputs such as generated caption and keywords.","default":"en"},"mode":{"type":"string","title":"Mode","description":"Tagging profile to apply. The endpoint currently uses `editorial` as default mode.","default":"editorial"},"date":{"type":"string","title":"Date","description":"Optional contextual date for the image, ideally in ISO `YYYY-MM-DD` format.","default":""},"event":{"type":"string","title":"Event","description":"Optional contextual event name associated with the image.","default":""},"city":{"type":"string","title":"City","description":"Optional contextual city associated with the image.","default":""},"country":{"type":"string","title":"Country","description":"Optional contextual country associated with the image.","default":""},"caption":{"type":"boolean","title":"Caption","description":"If `true`, the response includes an AI-generated caption.","default":false},"keywords":{"type":"boolean","title":"Keywords","description":"If `true`, the response includes generated keyword tags.","default":false},"ocr":{"type":"boolean","title":"Ocr","description":"If `true`, the response includes OCR text extracted from the image.","default":false},"colors":{"type":"boolean","title":"Colors","description":"If `true`, the response includes dominant colors and black-and-white detection.","default":false}},"type":"object","title":"Body_tag_image_tag_image_post"},"Body_upload_query_image_query_imgs_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image","description":"Binary image (JPG / PNG ≤ 5 MB)"}},"type":"object","required":["image"],"title":"Body_upload_query_image_query_imgs_post"},"Create_1_image":{"properties":{"src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src"},"src_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src Path"},"url_img_watermark":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Img Watermark"},"url_img_thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Img Thumbnail"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text"},"ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ai Generated"},"model_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Release"},"property_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Property Release"},"nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nsfw"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"shot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shot"},"scene":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scene"},"technique":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Technique"},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Collections"}},"type":"object","title":"Create_1_image"},"Create_1_video":{"properties":{"src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Url"},"img_src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Src"},"img_zoom":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Zoom"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Collections"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium"},"ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ai Generated"},"model_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Release"},"property_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Property Release"},"nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nsfw"},"container":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container"},"codec_video":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec Video"},"codec_audio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec Audio"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"aspect_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Aspect Ratio"},"fps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fps"},"duration_secs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Secs"}},"type":"object","title":"Create_1_video"},"Create_N_images":{"properties":{"id":{"type":"string","title":"Id"},"src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src"},"src_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src Path"},"url_img_watermark":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Img Watermark"},"url_img_thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Img Thumbnail"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text"},"ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ai Generated"},"model_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Release"},"property_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Property Release"},"nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nsfw"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"shot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shot"},"scene":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scene"},"technique":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Technique"},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Collections"}},"type":"object","required":["id"],"title":"Create_N_images"},"Create_N_videos":{"properties":{"id":{"type":"string","title":"Id"},"src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Url"},"img_src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Src"},"img_zoom":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Zoom"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Collections"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium"},"ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ai Generated"},"model_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Release"},"property_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Property Release"},"nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nsfw"},"container":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container"},"codec_video":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec Video"},"codec_audio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec Audio"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"aspect_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Aspect Ratio"},"fps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fps"},"duration_secs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Secs"}},"type":"object","required":["id"],"title":"Create_N_videos"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ImagesIdMandatory":{"properties":{"id":{"type":"string","title":"Id"}},"type":"object","required":["id"],"title":"ImagesIdMandatory"},"OpError":{"properties":{"id":{"type":"integer","title":"Id","description":"Identifier of the resource that triggered the error."},"msg":{"type":"string","title":"Msg","description":"Human-readable description of the error returned by the system."}},"type":"object","required":["id","msg"],"title":"OpError","description":"Details of an error produced during the operation."},"OpMethod":{"type":"string","enum":["add","upd","del","multiple"],"title":"OpMethod","description":"Tipo de respuesta asociada a una operación con imágenes."},"OpResource":{"type":"string","enum":["video","image","celebs"],"title":"OpResource"},"Operation_Out":{"properties":{"method":{"$ref":"#/components/schemas/OpMethod","description":"Operation type based on the HTTP method."},"resource":{"$ref":"#/components/schemas/OpResource","description":"Resource type involved in the operation."},"num_total":{"type":"integer","title":"Num Total","description":"Total of elements."},"num_good":{"type":"integer","title":"Num Good","description":"Number of correctly processed elements."},"num_bad":{"type":"integer","title":"Num Bad","description":"Number of failed processed elements."},"is_started":{"type":"boolean","title":"Is Started","description":"Boolean indicating if the operation has started."},"is_finished":{"type":"boolean","title":"Is Finished","description":"Boolean indicating if the operations has finished."},"all_good":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"All Good","description":"Boolean indicating that there is no failed elements yet."},"do_wait":{"type":"boolean","title":"Do Wait","description":"Boolean for know if have to wait or not."},"do_urgent":{"type":"boolean","title":"Do Urgent","description":"Boolean for know if it is an urgent operation."},"do_strict":{"type":"boolean","title":"Do Strict","description":"Boolean for know if is required strict operations over DB."},"idle_ms":{"type":"number","title":"Idle Ms","description":"Duration (milliseconds) between the operation has been created and has started."},"exec_ms":{"type":"number","title":"Exec Ms","description":"Duration (milliseconds) between the operation has been started and has finished."},"created_at":{"type":"string","title":"Created At","description":"Creation datetime."},"started_at":{"type":"string","title":"Started At","description":"Start datetime."},"finished_at":{"type":"string","title":"Finished At","description":"Finalization datetime."},"errors":{"items":{"$ref":"#/components/schemas/OpError"},"type":"array","title":"Errors","description":"List of errors that occurred during processing the operation."}},"type":"object","required":["method","resource","num_total","num_good","num_bad","is_started","is_finished","all_good","do_wait","do_urgent","do_strict","idle_ms","exec_ms","created_at","started_at","finished_at","errors"],"title":"Operation_Out","description":"Output of:\n- a synchronous (blocking) operation. POST /imgs?wait=true\n- operation status.                   GET ops/<op_id>"},"PendingOperation":{"properties":{"operation_id":{"type":"integer","title":"Operation Id","description":"ID assigned to the operation, or -1 if enqueuing failed"},"n_total":{"type":"integer","title":"N Total","description":"Total number of items attempted to enqueue"},"msg":{"type":"string","title":"Msg","description":"Status message (e.g., 'Operation enqueued successfully')"}},"type":"object","required":["operation_id","n_total","msg"],"title":"PendingOperation","description":"Immediate output of an asynchronous (queued) operation.\n\nProcessing takes place in the background; `operation_id = -1`\nindicates that the job could not be enqueued."},"TagErrorResponse":{"properties":{"error":{"type":"string","title":"Error","description":"Human-readable validation error."}},"type":"object","required":["error"],"title":"TagErrorResponse"},"TagImageResponse":{"properties":{"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"Image height in pixels."},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"Image width in pixels."},"ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ratio","description":"Aspect ratio of the image."},"orient":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Orient","description":"Image orientation."},"n_faces":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N Faces","description":"Number of detected faces."},"shot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shot","description":"Predicted shot type."},"illumination":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Illumination","description":"Predicted lighting type."},"shape":{"anyOf":[{"type":"string"},{"items":{"type":"integer"},"type":"array"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Shape","description":"Predicted image shape/style or raw shape dimensions."},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"string"},{"type":"null"}],"title":"Date","description":"Image date when available."},"people":{"anyOf":[{"items":{"$ref":"#/components/schemas/TagPersonResponse"},"type":"array"},{"type":"null"}],"title":"People","description":"Detected people metadata."},"photo_or_illus":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Photo Or Illus","description":"Whether the input is a photo or illustration."},"type_of_photo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type Of Photo","description":"Predicted photo subtype."},"type_of_illus":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type Of Illus","description":"Predicted illustration subtype."},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories","description":"General image categories."},"colors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Colors","description":"Representative image colors when requested."},"bw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Bw","description":"Whether the image is black and white."},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption","description":"Generated caption when requested."},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"Generated keywords when requested."},"ocr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ocr","description":"Extracted OCR text when requested."}},"additionalProperties":true,"type":"object","title":"TagImageResponse"},"TagPersonResponse":{"properties":{"face_box_as_dict":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Face Box As Dict","description":"Face bounding box coordinates."},"celeb_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Celeb Name","description":"Matched celebrity name if available."},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender","description":"Predicted gender."},"nationality":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Nationality","description":"Detected or linked nationality."},"occupation":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Occupation","description":"Detected or linked occupation."},"race":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Race","description":"Predicted ethnicity/race label."},"age_group":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age Group","description":"Predicted age group."},"current_age":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Age","description":"Estimated or linked age."},"face_expression":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Face Expression","description":"Detected face expression."},"date_birth":{"anyOf":[{"type":"string","format":"date"},{"type":"string"},{"type":"null"}],"title":"Date Birth","description":"Birth date when available."},"date_death":{"anyOf":[{"type":"string","format":"date"},{"type":"string"},{"type":"null"}],"title":"Date Death","description":"Death date when available."},"wesog_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wesog Id","description":"Internal Wesog identifier."}},"additionalProperties":true,"type":"object","title":"TagPersonResponse"},"Update_1_image":{"properties":{"src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src","description":"Url of the image in high or medium resolution (used as source for the AI).","example":"https://cdn.example.com/image/source.jpg"},"url_img_watermark":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Img Watermark","description":"URL of the watermarked image.","example":"https://cdn.example.com/image/wm.jpg"},"url_img_thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Img Thumbnail","description":"URL of the thumbnail image.","example":"https://cdn.example.com/image/thumb.jpg"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"A shorthand reference for the image.","example":"image123"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline","description":"Short text describing the image.","example":"Sunset over the Hudson River"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption","description":"Long text describing the image.","example":"A vibrant orange sunset reflecting on the river with the city skyline in silhouette."},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text","description":"Text describing the visual appearance of an image (Accessibility)."},"ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ai Generated","description":"Image generated by Artificial Intelligence."},"model_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Release","description":"image with model release."},"property_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Property Release","description":"image with property release."},"nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nsfw","description":"Image Not Safe For Work."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Current status of the image.","example":"Active"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","description":"Date of the image creation in year-month-day format. Capture date for photographies.","example":"2024-10-19"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"A detailed description of the location, complementing the specified country and city with additional details such as street address or notable landmarks.","example":"123 Main St, near Central Park"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Name of the country.","example":"New York"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Name of the country.","example":"United States"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event","description":"Related event","example":"Oscar awards 2024"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author","description":"The name of the individual or entity responsible for creating the image, such as a photographer or painter.","example":"Jane Doe"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"The identifier of the provider, which can be either a unique numeric ID or a descriptive name.","example":"Acme Inc."},"shot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shot","description":"Type of photography shot.","example":"Portrait"},"scene":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scene","description":"Spot, place, visual location","example":"Town square"},"technique":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Technique","description":"The specific method or process used in creating the artwork, reflecting the artist's unique approach or the traditional methods tied to certain mediums.","example":"Drawing"},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium","description":"The material or substance used in the creation of the artwork or object. This field corresponds to various artistic mediums like oils, acrylics, or digital formats.","example":"Oil on canvas"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"Specific tags describing the image","example":["Tree","Dog","Ball","Water"]},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories","description":"General categories of the image","example":["Sport","Fashion","Politics"]},"collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Collections","description":"Collections that the image belongs to","example":["Steet pics","Exclusive"]}},"type":"object","title":"Update_1_image"},"Update_1_video":{"properties":{"src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src","description":"URL del vídeo original."},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Nombre canónico backend para la miniatura del vídeo.","example":"https://cdn.example.com/video/thumb.jpg"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Url","description":"Nombre canónico backend para el preview reproducible del vídeo.","example":"https://cdn.example.com/video/preview.mp4"},"img_src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Src","description":"Alias temporal de compatibilidad frontend para `thumbnail_url`.","example":"https://cdn.example.com/video/thumb.jpg"},"img_zoom":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Zoom","description":"Alias temporal de compatibilidad frontend para `preview_url`.","example":"https://cdn.example.com/video/preview.mp4"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","description":"Fecha del vídeo en formato YYYY-MM-DD.","example":"2024-10-19"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"Localización descriptiva del vídeo."},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Ciudad."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"País."},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event","description":"Evento relacionado."},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author","description":"Autor o creador."},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"Proveedor o agencia."},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"Palabras clave."},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories","description":"Categorías."},"collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Collections","description":"Colecciones."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Título."},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline","description":"Titular."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Descripción."},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text","description":"Texto alternativo."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Estado editorial del vídeo."},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium","description":"Medio o tipo editorial."},"ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ai Generated","description":"Indica si fue generado por IA."},"model_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Release","description":"Indica si tiene model release."},"property_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Property Release","description":"Indica si tiene property release."},"nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nsfw","description":"Indica si está marcado como NSFW."},"container":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container","description":"Contenedor del vídeo, por ejemplo MP4."},"codec_video":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec Video","description":"Codec de vídeo, por ejemplo H264."},"codec_audio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec Audio","description":"Codec de audio, por ejemplo AAC."},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"Alto del vídeo."},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"Ancho del vídeo."},"aspect_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Aspect Ratio","description":"Aspect ratio del vídeo."},"fps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fps","description":"Frames por segundo."},"duration_secs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Secs","description":"Duración del vídeo en segundos."}},"type":"object","title":"Update_1_video"},"Update_N_images":{"properties":{"id":{"type":"string","title":"Id"},"src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src","description":"Url of the image in high or medium resolution (used as source for the AI).","example":"https://cdn.example.com/image/source.jpg"},"url_img_watermark":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Img Watermark","description":"URL of the watermarked image.","example":"https://cdn.example.com/image/wm.jpg"},"url_img_thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Img Thumbnail","description":"URL of the thumbnail image.","example":"https://cdn.example.com/image/thumb.jpg"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"A shorthand reference for the image.","example":"image123"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline","description":"Short text describing the image.","example":"Sunset over the Hudson River"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption","description":"Long text describing the image.","example":"A vibrant orange sunset reflecting on the river with the city skyline in silhouette."},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text","description":"Text describing the visual appearance of an image (Accessibility)."},"ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ai Generated","description":"Image generated by Artificial Intelligence."},"model_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Release","description":"image with model release."},"property_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Property Release","description":"image with property release."},"nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nsfw","description":"Image Not Safe For Work."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Current status of the image.","example":"Active"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","description":"Date of the image creation in year-month-day format. Capture date for photographies.","example":"2024-10-19"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"A detailed description of the location, complementing the specified country and city with additional details such as street address or notable landmarks.","example":"123 Main St, near Central Park"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Name of the country.","example":"New York"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Name of the country.","example":"United States"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event","description":"Related event","example":"Oscar awards 2024"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author","description":"The name of the individual or entity responsible for creating the image, such as a photographer or painter.","example":"Jane Doe"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"The identifier of the provider, which can be either a unique numeric ID or a descriptive name.","example":"Acme Inc."},"shot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shot","description":"Type of photography shot.","example":"Portrait"},"scene":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scene","description":"Spot, place, visual location","example":"Town square"},"technique":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Technique","description":"The specific method or process used in creating the artwork, reflecting the artist's unique approach or the traditional methods tied to certain mediums.","example":"Drawing"},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium","description":"The material or substance used in the creation of the artwork or object. This field corresponds to various artistic mediums like oils, acrylics, or digital formats.","example":"Oil on canvas"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"Specific tags describing the image","example":["Tree","Dog","Ball","Water"]},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories","description":"General categories of the image","example":["Sport","Fashion","Politics"]},"collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Collections","description":"Collections that the image belongs to","example":["Steet pics","Exclusive"]}},"type":"object","required":["id"],"title":"Update_N_images"},"Update_N_videos":{"properties":{"id":{"type":"string","title":"Id"},"src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src","description":"URL del vídeo original."},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Nombre canónico backend para la miniatura del vídeo.","example":"https://cdn.example.com/video/thumb.jpg"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Url","description":"Nombre canónico backend para el preview reproducible del vídeo.","example":"https://cdn.example.com/video/preview.mp4"},"img_src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Src","description":"Alias temporal de compatibilidad frontend para `thumbnail_url`.","example":"https://cdn.example.com/video/thumb.jpg"},"img_zoom":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Zoom","description":"Alias temporal de compatibilidad frontend para `preview_url`.","example":"https://cdn.example.com/video/preview.mp4"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","description":"Fecha del vídeo en formato YYYY-MM-DD.","example":"2024-10-19"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"Localización descriptiva del vídeo."},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Ciudad."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"País."},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event","description":"Evento relacionado."},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author","description":"Autor o creador."},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"Proveedor o agencia."},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"Palabras clave."},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories","description":"Categorías."},"collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Collections","description":"Colecciones."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Título."},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline","description":"Titular."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Descripción."},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text","description":"Texto alternativo."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Estado editorial del vídeo."},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium","description":"Medio o tipo editorial."},"ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ai Generated","description":"Indica si fue generado por IA."},"model_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Release","description":"Indica si tiene model release."},"property_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Property Release","description":"Indica si tiene property release."},"nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nsfw","description":"Indica si está marcado como NSFW."},"container":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container","description":"Contenedor del vídeo, por ejemplo MP4."},"codec_video":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec Video","description":"Codec de vídeo, por ejemplo H264."},"codec_audio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec Audio","description":"Codec de audio, por ejemplo AAC."},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"Alto del vídeo."},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"Ancho del vídeo."},"aspect_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Aspect Ratio","description":"Aspect ratio del vídeo."},"fps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fps","description":"Frames por segundo."},"duration_secs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Secs","description":"Duración del vídeo en segundos."}},"type":"object","required":["id"],"title":"Update_N_videos"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VideosIdMandatory":{"properties":{"id":{"type":"string","title":"Id"}},"type":"object","required":["id"],"title":"VideosIdMandatory"},"image":{"properties":{"image_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Id"},"src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src","description":"Url of the image in high or medium resolution (used as source for the AI).","example":"https://cdn.example.com/image/source.jpg"},"url_img_watermark":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Img Watermark","description":"URL of the watermarked image.","example":"https://cdn.example.com/image/wm.jpg"},"url_img_thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Img Thumbnail","description":"URL of the thumbnail image.","example":"https://cdn.example.com/image/thumb.jpg"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"A shorthand reference for the image.","example":"image123"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline","description":"Short text describing the image.","example":"Sunset over the Hudson River"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption","description":"Long text describing the image.","example":"A vibrant orange sunset reflecting on the river with the city skyline in silhouette."},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text","description":"Text describing the visual appearance of an image (Accessibility)."},"ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ai Generated","description":"Image generated by Artificial Intelligence."},"model_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Release","description":"image with model release."},"property_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Property Release","description":"image with property release."},"nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nsfw","description":"Image Not Safe For Work."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Current status of the image.","example":"Active"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","description":"Date of the image creation in year-month-day format. Capture date for photographies.","example":"2024-10-19"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"A detailed description of the location, complementing the specified country and city with additional details such as street address or notable landmarks.","example":"123 Main St, near Central Park"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Name of the country.","example":"New York"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Name of the country.","example":"United States"},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event","description":"Related event","example":"Oscar awards 2024"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author","description":"The name of the individual or entity responsible for creating the image, such as a photographer or painter.","example":"Jane Doe"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"The identifier of the provider, which can be either a unique numeric ID or a descriptive name.","example":"Acme Inc."},"shot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shot","description":"Type of photography shot.","example":"Portrait"},"scene":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scene","description":"Spot, place, visual location","example":"Town square"},"technique":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Technique","description":"The specific method or process used in creating the artwork, reflecting the artist's unique approach or the traditional methods tied to certain mediums.","example":"Drawing"},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium","description":"The material or substance used in the creation of the artwork or object. This field corresponds to various artistic mediums like oils, acrylics, or digital formats.","example":"Oil on canvas"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"Specific tags describing the image","example":["Tree","Dog","Ball","Water"]},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories","description":"General categories of the image","example":["Sport","Fashion","Politics"]},"collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Collections","description":"Collections that the image belongs to","example":["Steet pics","Exclusive"]},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"Height of the image."},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"Width of the image."},"n_faces":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N Faces","description":"Num of people faces that appears on the image."}},"type":"object","title":"image"},"image_search_response":{"properties":{"results":{"items":{"$ref":"#/components/schemas/image"},"type":"array","title":"Results"},"count":{"type":"integer","title":"Count"},"facets":{"additionalProperties":{"items":{"additionalProperties":{"type":"integer"},"type":"object"},"type":"array"},"type":"object","title":"Facets"}},"type":"object","required":["results","count","facets"],"title":"image_search_response"},"video":{"properties":{"video_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Id"},"src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Src","description":"URL del vídeo original."},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url","description":"Nombre canónico backend para la miniatura del vídeo.","example":"https://cdn.example.com/video/thumb.jpg"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Url","description":"Nombre canónico backend para el preview reproducible del vídeo.","example":"https://cdn.example.com/video/preview.mp4"},"img_src":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Src","description":"Alias temporal de compatibilidad frontend para `thumbnail_url`.","example":"https://cdn.example.com/video/thumb.jpg"},"img_zoom":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img Zoom","description":"Alias temporal de compatibilidad frontend para `preview_url`.","example":"https://cdn.example.com/video/preview.mp4"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date","description":"Fecha del vídeo en formato YYYY-MM-DD.","example":"2024-10-19"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"Localización descriptiva del vídeo."},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Ciudad."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"País."},"event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event","description":"Evento relacionado."},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author","description":"Autor o creador."},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider","description":"Proveedor o agencia."},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords","description":"Palabras clave."},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories","description":"Categorías."},"collections":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Collections","description":"Colecciones."},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Título."},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline","description":"Titular."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Descripción."},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text","description":"Texto alternativo."},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"Estado editorial del vídeo."},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium","description":"Medio o tipo editorial."},"ai_generated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ai Generated","description":"Indica si fue generado por IA."},"model_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Model Release","description":"Indica si tiene model release."},"property_release":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Property Release","description":"Indica si tiene property release."},"nsfw":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Nsfw","description":"Indica si está marcado como NSFW."},"container":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container","description":"Contenedor del vídeo, por ejemplo MP4."},"codec_video":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec Video","description":"Codec de vídeo, por ejemplo H264."},"codec_audio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codec Audio","description":"Codec de audio, por ejemplo AAC."},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"Alto del vídeo."},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"Ancho del vídeo."},"aspect_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Aspect Ratio","description":"Aspect ratio del vídeo."},"fps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fps","description":"Frames por segundo."},"duration_secs":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration Secs","description":"Duración del vídeo en segundos."},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","description":"Identificador único del vídeo."}},"type":"object","title":"video"},"video_search_response":{"properties":{"results":{"items":{"$ref":"#/components/schemas/video"},"type":"array","title":"Results"},"count":{"type":"integer","title":"Count"},"facets":{"additionalProperties":{"items":{"additionalProperties":{"type":"integer"},"type":"object"},"type":"array"},"type":"object","title":"Facets"}},"type":"object","required":["results","count","facets"],"title":"video_search_response"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"API-Key"}}}}