Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/google-cloud-speech-to-text:google-cloud-speech-to-text-projects-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Cloud Speech-to-Text Projects API
version: v1
description: Generated from Google's published Discovery document for Cloud Speech-to-Text API (speech v1, revision 20261110). 10 operation(s).
contact:
name: Google
url: https://developers.google.com/
termsOfService: https://developers.google.com/terms
servers:
- url: https://speech.googleapis.com
tags:
- name: Projects
paths:
/v1/projects/{projectsId}/locations/{locationsId}/phraseSets/{phraseSetsId}:
delete:
operationId: speech.projects.locations.phraseSets.delete
summary: Delete phraseSets
description: Delete a phrase set.
parameters:
- name: projectsId
in: path
required: true
description: Resource name segment (projectsId).
schema:
type: string
- name: locationsId
in: path
required: true
description: Resource name segment (locationsId).
schema:
type: string
- name: phraseSetsId
in: path
required: true
description: Resource name segment (phraseSetsId).
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Empty'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/cloud-platform
- apiKey: []
tags:
- Projects
patch:
operationId: speech.projects.locations.phraseSets.patch
summary: Patch phraseSets
description: Update a phrase set.
parameters:
- name: projectsId
in: path
required: true
description: Resource name segment (projectsId).
schema:
type: string
- name: locationsId
in: path
required: true
description: Resource name segment (locationsId).
schema:
type: string
- name: phraseSetsId
in: path
required: true
description: Resource name segment (phraseSetsId).
schema:
type: string
- name: updateMask
in: query
required: false
description: The list of fields to be updated.
schema:
format: google-fieldmask
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PhraseSet'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/PhraseSet'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/cloud-platform
- apiKey: []
tags:
- Projects
get:
operationId: speech.projects.locations.phraseSets.get
summary: Get phraseSets
description: Get a phrase set.
parameters:
- name: projectsId
in: path
required: true
description: Resource name segment (projectsId).
schema:
type: string
- name: locationsId
in: path
required: true
description: Resource name segment (locationsId).
schema:
type: string
- name: phraseSetsId
in: path
required: true
description: Resource name segment (phraseSetsId).
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/PhraseSet'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/cloud-platform
- apiKey: []
tags:
- Projects
/v1/projects/{projectsId}/locations/{locationsId}/phraseSets:
get:
operationId: speech.projects.locations.phraseSets.list
summary: List phraseSets
description: List phrase sets.
parameters:
- name: projectsId
in: path
required: true
description: Resource name segment (projectsId).
schema:
type: string
- name: locationsId
in: path
required: true
description: Resource name segment (locationsId).
schema:
type: string
- name: pageSize
in: query
required: false
description: The maximum number of phrase sets to return. The service may return fewer than this value. If unspecified, at most 50 phrase sets will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
schema:
type: integer
format: int32
- name: pageToken
in: query
required: false
description: A page token, received from a previous `ListPhraseSet` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPhraseSet` must match the call that provided the page token.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListPhraseSetResponse'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/cloud-platform
- apiKey: []
tags:
- Projects
post:
operationId: speech.projects.locations.phraseSets.create
summary: Create phraseSets
description: Create a set of phrase hints. Each item in the set can be a single word or a multi-word phrase. The items in the PhraseSet are favored by the recognition model when you send a call that includes the PhraseSet.
parameters:
- name: projectsId
in: path
required: true
description: Resource name segment (projectsId).
schema:
type: string
- name: locationsId
in: path
required: true
description: Resource name segment (locationsId).
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreatePhraseSetRequest'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/PhraseSet'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/cloud-platform
- apiKey: []
tags:
- Projects
/v1/projects/{projectsId}/locations/{locationsId}/customClasses/{customClassesId}:
patch:
operationId: speech.projects.locations.customClasses.patch
summary: Patch customClasses
description: Update a custom class.
parameters:
- name: projectsId
in: path
required: true
description: Resource name segment (projectsId).
schema:
type: string
- name: locationsId
in: path
required: true
description: Resource name segment (locationsId).
schema:
type: string
- name: customClassesId
in: path
required: true
description: Resource name segment (customClassesId).
schema:
type: string
- name: updateMask
in: query
required: false
description: The list of fields to be updated.
schema:
type: string
format: google-fieldmask
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CustomClass'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/CustomClass'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/cloud-platform
- apiKey: []
tags:
- Projects
get:
operationId: speech.projects.locations.customClasses.get
summary: Get customClasses
description: Get a custom class.
parameters:
- name: projectsId
in: path
required: true
description: Resource name segment (projectsId).
schema:
type: string
- name: locationsId
in: path
required: true
description: Resource name segment (locationsId).
schema:
type: string
- name: customClassesId
in: path
required: true
description: Resource name segment (customClassesId).
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/CustomClass'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/cloud-platform
- apiKey: []
tags:
- Projects
delete:
operationId: speech.projects.locations.customClasses.delete
summary: Delete customClasses
description: Delete a custom class.
parameters:
- name: projectsId
in: path
required: true
description: Resource name segment (projectsId).
schema:
type: string
- name: locationsId
in: path
required: true
description: Resource name segment (locationsId).
schema:
type: string
- name: customClassesId
in: path
required: true
description: Resource name segment (customClassesId).
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Empty'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/cloud-platform
- apiKey: []
tags:
- Projects
/v1/projects/{projectsId}/locations/{locationsId}/customClasses:
get:
operationId: speech.projects.locations.customClasses.list
summary: List customClasses
description: List custom classes.
parameters:
- name: projectsId
in: path
required: true
description: Resource name segment (projectsId).
schema:
type: string
- name: locationsId
in: path
required: true
description: Resource name segment (locationsId).
schema:
type: string
- name: pageSize
in: query
required: false
description: The maximum number of custom classes to return. The service may return fewer than this value. If unspecified, at most 50 custom classes will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
schema:
type: integer
format: int32
- name: pageToken
in: query
required: false
description: A page token, received from a previous `ListCustomClass` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCustomClass` must match the call that provided the page token.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListCustomClassesResponse'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/cloud-platform
- apiKey: []
tags:
- Projects
post:
operationId: speech.projects.locations.customClasses.create
summary: Create customClasses
description: Create a custom class.
parameters:
- name: projectsId
in: path
required: true
description: Resource name segment (projectsId).
schema:
type: string
- name: locationsId
in: path
required: true
description: Resource name segment (locationsId).
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateCustomClassRequest'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/CustomClass'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/cloud-platform
- apiKey: []
tags:
- Projects
components:
schemas:
Empty:
properties: {}
type: object
description: 'A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }'
CreateCustomClassRequest:
description: Message sent by the client for the `CreateCustomClass` method.
type: object
properties:
customClass:
$ref: '#/components/schemas/CustomClass'
description: Required. The custom class to create.
customClassId:
description: Required. The ID to use for the custom class, which will become the final component of the custom class' resource name. This value should restrict to letters, numbers, and hyphens, with the first character a letter, the last a letter or a number, and be 4-63 characters.
type: string
ListCustomClassesResponse:
type: object
properties:
customClasses:
type: array
description: The custom classes.
items:
$ref: '#/components/schemas/CustomClass'
nextPageToken:
type: string
description: A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
description: Message returned to the client by the `ListCustomClasses` method.
CreatePhraseSetRequest:
properties:
phraseSetId:
type: string
description: Required. The ID to use for the phrase set, which will become the final component of the phrase set's resource name. This value should restrict to letters, numbers, and hyphens, with the first character a letter, the last a letter or a number, and be 4-63 characters.
phraseSet:
$ref: '#/components/schemas/PhraseSet'
description: Required. The phrase set to create.
description: Message sent by the client for the `CreatePhraseSet` method.
type: object
GoogleRpcError:
type: object
description: The error envelope every Google API returns.
properties:
error:
type: object
properties:
code:
type: integer
message:
type: string
status:
type: string
details:
type: array
items:
type: object
ClassItem:
type: object
description: An item of the class.
properties:
value:
description: The class item's value.
type: string
CustomClass:
properties:
displayName:
readOnly: true
description: Output only. User-settable, human-readable name for the CustomClass. Must be 63 characters or less. This field is not used.
type: string
customClassId:
description: If this custom class is a resource, the custom_class_id is the resource id of the CustomClass. Case sensitive.
type: string
etag:
type: string
readOnly: true
description: Output only. This checksum is computed by the server based on the value of other fields. This may be sent on update, undelete, and delete requests to ensure the client has an up-to-date value before proceeding. This field is not used.
kmsKeyVersionName:
description: Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which content of the ClassItem is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.
readOnly: true
type: string
name:
description: The resource name of the custom class.
type: string
uid:
description: Output only. System-assigned unique identifier for the CustomClass. This field is not used.
type: string
readOnly: true
items:
items:
$ref: '#/components/schemas/ClassItem'
type: array
description: A collection of class items.
reconciling:
type: boolean
readOnly: true
description: Output only. Whether or not this CustomClass is in the process of being updated. This field is not used.
expireTime:
type: string
description: Output only. The time at which this resource will be purged. This field is not used.
readOnly: true
format: google-datetime
kmsKeyName:
readOnly: true
type: string
description: Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the content of the ClassItem is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
annotations:
description: Output only. Allows users to store small amounts of arbitrary data. Both the key and the value must be 63 characters or less each. At most 100 annotations. This field is not used.
additionalProperties:
type: string
readOnly: true
type: object
state:
description: Output only. The CustomClass lifecycle state. This field is not used.
enum:
- STATE_UNSPECIFIED
- ACTIVE
- DELETED
readOnly: true
type: string
deleteTime:
type: string
description: Output only. The time at which this resource was requested for deletion. This field is not used.
readOnly: true
format: google-datetime
type: object
description: A set of words or phrases that represents a common concept likely to appear in your audio, for example a list of passenger ship names. CustomClass items can be substituted into placeholders that you set in PhraseSet phrases.
PhraseSet:
description: Provides "hints" to the speech recognizer to favor specific words and phrases in the results.
properties:
annotations:
description: Output only. Allows users to store small amounts of arbitrary data. Both the key and the value must be 63 characters or less each. At most 100 annotations. This field is not used.
additionalProperties:
type: string
readOnly: true
type: object
kmsKeyVersionName:
type: string
description: Output only. The [KMS key version name](https://cloud.google.com/kms/docs/resource-hierarchy#key_versions) with which content of the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}`.
readOnly: true
expireTime:
readOnly: true
description: Output only. The time at which this resource will be purged. This field is not used.
format: google-datetime
type: string
kmsKeyName:
readOnly: true
description: Output only. The [KMS key name](https://cloud.google.com/kms/docs/resource-hierarchy#keys) with which the content of the PhraseSet is encrypted. The expected format is `projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`.
type: string
displayName:
type: string
readOnly: true
description: Output only. User-settable, human-readable name for the PhraseSet. Must be 63 characters or less. This field is not used.
state:
description: Output only. The CustomClass lifecycle state. This field is not used.
enum:
- STATE_UNSPECIFIED
- ACTIVE
- DELETED
readOnly: true
type: string
name:
description: The resource name of the phrase set.
type: string
uid:
type: string
readOnly: true
description: Output only. System-assigned unique identifier for the PhraseSet. This field is not used.
boost:
description: Hint Boost. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost values would correspond to anti-biasing. Anti-biasing is not enabled, so negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 (exclusive) and 20. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.
format: float
type: number
etag:
type: string
description: Output only. This checksum is computed by the server based on the value of other fields. This may be sent on update, undelete, and delete requests to ensure the client has an up-to-date value before proceeding. This field is not used.
readOnly: true
reconciling:
description: Output only. Whether or not this PhraseSet is in the process of being updated. This field is not used.
readOnly: true
type: boolean
phrases:
items:
$ref: '#/components/schemas/Phrase'
description: A list of word and phrases.
type: array
deleteTime:
format: google-datetime
type: string
description: Output only. The time at which this resource was requested for deletion. This field is not used.
readOnly: true
type: object
Phrase:
type: object
properties:
boost:
description: Hint Boost. Overrides the boost set at the phrase set level. Positive value will increase the probability that a specific phrase will be recognized over other similar sounding phrases. The higher the boost, the higher the chance of false positive recognition as well. Negative boost will simply be ignored. Though `boost` can accept a wide range of positive values, most use cases are best served with values between 0 and 20. We recommend using a binary search approach to finding the optimal value for your use case as well as adding phrases both with and without boost to your requests.
type: number
format: float
value:
type: string
description: The phrase itself.
description: 'A phrases containing words and phrase "hints" so that the speech recognition is more likely to recognize them. This can be used to improve the accuracy for specific words and phrases, for example, if specific commands are typically spoken by the user. This can also be used to add additional words to the vocabulary of the recognizer. See [usage limits](https://cloud.google.com/speech-to-text/quotas#content). List items can also include pre-built or custom classes containing groups of words that represent common concepts that occur in natural language. For example, rather than providing a phrase hint for every month of the year (e.g. "i was born in january", "i was born in febuary", ...), use the pre-built `$MONTH` class improves the likelihood of correctly transcribing audio that includes months (e.g. "i was born in $month"). To refer to pre-built classes, use the class'' symbol prepended with `$` e.g. `$MONTH`. To refer to custom classes that were defined inline in the request, set the class''s `custom_class_id` to a string unique to all class resources and inline classes. Then use the class'' id wrapped in $`{...}` e.g. "${my-months}". To refer to custom classes resources, use the class'' id wrapped in `${}` (e.g. `${my-months}`). Speech-to-Text supports three locations: `global`, `us` (US North America), and `eu` (Europe). If you are calling the `speech.googleapis.com` endpoint, use the `global` location. To specify a region, use a [regional endpoint](https://cloud.google.com/speech-to-text/docs/endpoints) with matching `us` or `eu` location value.'
ListPhraseSetResponse:
description: Message returned to the client by the `ListPhraseSet` method.
properties:
phraseSets:
description: The phrase set.
items:
$ref: '#/components/schemas/PhraseSet'
type: array
nextPageToken:
description: A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
type: string
type: object
securitySchemes:
apiKey:
type: apiKey
in: query
name: key
description: API key; accepted by methods that do not need user data.
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://accounts.google.com/o/oauth2/auth
tokenUrl: https://oauth2.googleapis.com/token
scopes:
https://www.googleapis.com/auth/cloud-platform: See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
externalDocs:
url: https://cloud.google.com/speech-to-text/docs/quickstart-protocol
x-provenance:
method: harvested
publisher: Google
source: https://speech.googleapis.com/$discovery/rest?version=v1
note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261110)