Google

Cloud Vision API

Integrates Google Vision features, including image labeling, face, logo, and landmark detection, optical character recognition (OCR), and detection of…

AI & machine learning#openapi#analytics#media

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Integrates Google Vision features, including image labeling, face, logo, and landmark detection, optical character recognition (OCR), and detection of explicit content, into applications.

Endpoints 23

files

  • POSTService that performs image detection and annotation for a batch of files/v1/files:annotateService that performs image detection and annotation for a batch of files. Now only "application/pdf", "image/tiff" and "image/gif" are supported. This…
  • POSTRun asynchronous image detection and annotation for a list of generic files, such as PDF files, which may contain…/v1/files:asyncBatchAnnotateRun asynchronous image detection and annotation for a list of generic files, such as PDF files, which may contain multiple pages and multiple images per page.…

images

  • POSTRun image detection and annotation for a batch of images./v1/images:annotateRun image detection and annotation for a batch of images.
  • POSTRun asynchronous image detection and annotation for a list of images/v1/images:asyncBatchAnnotateRun asynchronous image detection and annotation for a list of images. Progress and results can be retrieved through the google.longrunning.Operations…

projects.operations

  • GETGets the latest state of a long-running operation/v1/:nameGets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

projects.locations.products.referenceImages

  • DELETEPermanently deletes a reference image/v1/:namePermanently deletes a reference image. The image metadata will be deleted right away, but search queries against ProductSets containing the image may still…
  • GETLists reference images/v1/:parent/referenceImages?pageSize=0&pageToken=stringLists reference images. Possible errors: * Returns NOT_FOUND if the parent product does not exist. * Returns INVALID_ARGUMENT if the page_size is greater than…
  • POSTCreates and returns a new ReferenceImage resource/v1/:parent/referenceImages?referenceImageId=stringCreates and returns a new ReferenceImage resource. The bounding_poly field is optional. If bounding_poly is not specified, the system will try to detect…

projects.locations.products

  • PATCHMakes changes to a Product resource/v1/:name?updateMask=stringMakes changes to a Product resource. Only the display_name, description, and labels fields can be updated right now. If labels are updated, the change will…
  • GETLists products in an unspecified order/v1/:parent/products?pageSize=0&pageToken=stringLists products in an unspecified order. Possible errors: * Returns INVALID_ARGUMENT if page_size is greater than 100 or less than 1.
  • POSTCreates and returns a new product resource/v1/:parent/products?productId=stringCreates and returns a new product resource. Possible errors: * Returns INVALID_ARGUMENT if display_name is missing or longer than 4096 characters. * Returns…
  • POSTAsynchronous API to delete all Products in a ProductSet or all Products that are in no ProductSet/v1/:parent/products:purgeAsynchronous API to delete all Products in a ProductSet or all Products that are in no ProductSet. If a Product is a member of the specified ProductSet in…

operations

  • POSTStarts asynchronous cancellation on a long-running operation/v1/:name:cancelStarts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the…

projects.locations.files

  • POSTService that performs image detection and annotation for a batch of files/v1/:parent/files:annotateService that performs image detection and annotation for a batch of files. Now only "application/pdf", "image/tiff" and "image/gif" are supported. This…
  • POSTRun asynchronous image detection and annotation for a list of generic files, such as PDF files, which may contain…/v1/:parent/files:asyncBatchAnnotateRun asynchronous image detection and annotation for a list of generic files, such as PDF files, which may contain multiple pages and multiple images per page.…

projects.locations.images

  • POSTRun image detection and annotation for a batch of images./v1/:parent/images:annotateRun image detection and annotation for a batch of images.
  • POSTRun asynchronous image detection and annotation for a list of images/v1/:parent/images:asyncBatchAnnotateRun asynchronous image detection and annotation for a list of images. Progress and results can be retrieved through the google.longrunning.Operations…

projects.locations.productSets

  • POSTAdds a Product to the specified ProductSet/v1/:name:addProductAdds a Product to the specified ProductSet. If the Product is already present, no change is made. One Product can be added to at most 100 ProductSets.…
  • GETLists ProductSets in an unspecified order/v1/:parent/productSets?pageSize=0&pageToken=stringLists ProductSets in an unspecified order. Possible errors: * Returns INVALID_ARGUMENT if page_size is greater than 100, or less than 1.
  • POSTCreates and returns a new ProductSet resource/v1/:parent/productSets?productSetId=stringCreates and returns a new ProductSet resource. Possible errors: * Returns INVALID_ARGUMENT if display_name is missing, or is longer than 4096 characters.
  • POSTAsynchronous API that imports a list of reference images to specified product sets based on a list of image information/v1/:parent/productSets:importAsynchronous API that imports a list of reference images to specified product sets based on a list of image information. The google.longrunning.Operation API…
  • POSTRemoves a Product from the specified ProductSet./v1/:name:removeProductRemoves a Product from the specified ProductSet.

projects.locations.productSets.products

  • GETLists the Products in a ProductSet, in an unspecified order/v1/:name/products?pageSize=0&pageToken=stringLists the Products in a ProductSet, in an unspecified order. If the ProductSet does not exist, the products field of the response will be empty. Possible…

API details

Base URL
https://vision.googleapis.com
Authentication
OAuth 2.0 (authorization code flow) with 2 scopes
An API key in the key query parameter
Operations
23 operations on 18 pathsPOST 16GET 5PATCH 1DELETE 1
Main resources
projects.locations.productSets 5projects.locations.products 4projects.locations.products.referenceImages 3files 2images 2projects.locations.files 2projects.locations.images 2operations 1projects.locations.productSets.products 1projects.operations 1
Response formats
application/json
Description format
Google API Discovery, API version v1

How to test the Cloud Vision API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Cloud Vision API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code flow) with 2 scopes. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Service that performs image detection and annotation for a batch of files” (POST /v1/files:annotate), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Cloud Vision API?

Integrates Google Vision features, including image labeling, face, logo, and landmark detection, optical character recognition (OCR), and detection of… It is listed under AI & machine learning and has 23 endpoints.

Who publishes the Cloud Vision API?

It is listed from Google's public API description (an OpenAPI document), not published by Google on Swastik Codes. Anyone who controls googleapis.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Cloud Vision API?

Requests go to https://vision.googleapis.com. Endpoint paths are added to this base URL.

How do I authenticate with the Cloud Vision API?

It accepts 2 methods: OAuth 2.0 (authorization code flow) with 2 scopes; an API key in the key query parameter.

How many endpoints does the Cloud Vision API have?

23 operations on 18 paths (16 POST, 5 GET, 1 PATCH, 1 DELETE). The largest groups are projects.locations.productSets, projects.locations.products, projects.locations.products.referenceImages, files.

Is forking the Cloud Vision API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.