Transcribe audio
POST/v1/audio/transcriptions
Transcribes a short audio clip to text. Send the clip as multipart form data (file, an audio/* type, up to 25 MB); language is an optional hint. Needs a spendable balance on the project's billing account.
Request
Responses
- 200
- 401
- 403
- 413
- 422
- 429
- 500
- 502
- 503
Successful Response
Authentication failed: the credential is missing, malformed, expired, or revoked.
invalid_token— The access token is invalid.project_disabled— This project is not active.token_expired— The access token has expired.user_disabled— This user is not active.
The caller is authenticated but not permitted to perform this action.
permission_denied— You do not have permission to perform this action.
The request body is larger than the allowed limit.
file_too_large— The file exceeds the maximum allowed size.payload_too_large— The request body is too large.
A request value failed validation; the details array names each offending field.
unsupported_media_type— The media type is not supported.validation_failed— The request payload failed validation.
Either too many requests (a Retry-After header says when to retry) or the billing account is out of credits (no Retry-After — top up to continue); the code field tells the two apart.
insufficient_credits— The billing account has insufficient credits.rate_limited— Too many requests. Please slow down.
An unexpected server-side error occurred.
internal— An unexpected error occurred.
An upstream service returned an error while handling the request.
upstream_error— Transcription failed. Please try again.
The service is temporarily unavailable; retry after a short delay.
service_unavailable— Transcription is temporarily unavailable.