A REST API that returns short-lived download URLs for a licensed Krisp AI Voice SDK version package and its associated model files, intended for CI/CD pipelines, automated testing, and custom deployment scripts. Authenticated with an api-key Authorization header; the returned S3 links expire within seconds (expires_in, e.g. 300).
openapi: 3.1.0
info:
title: Krisp Developers API
version: v2
summary: REST surface of the Krisp developer platform — Voice Translation session minting, supported
languages, and programmatic SDK/model downloads.
description: >-
NOT PUBLISHED BY KRISP. Krisp publishes no OpenAPI document. This description is a faithful
transcription by the API Evangelist enrichment pipeline of the REST endpoints Krisp documents in prose
at https://sdk-docs.krisp.ai/docs/voice-translation-api.md and
https://sdk-docs.krisp.ai/docs/programmatic-sdk-model-downloads-api.md. Paths, methods, parameters,
headers, and response shapes are taken verbatim from those pages; operationIds and schema names were
assigned by the pipeline because the source documentation does not name them. The real-time
translation surface itself is a WebSocket protocol and is described separately in
asyncapi/krisp-voice-translation-asyncapi.yml.
x-apievangelist-provenance:
generated: '2026-07-19'
method: derived
published_by_provider: false
source:
- https://sdk-docs.krisp.ai/docs/voice-translation-api.md
- https://sdk-docs.krisp.ai/docs/programmatic-sdk-model-downloads-api.md
contact:
name: Krisp Developers
url: https://krisp.ai/developers/
termsOfService: https://krisp.ai/terms-of-use/
servers:
- url: https://api.developers.krisp.ai
description: Krisp developer REST API
tags:
- name: Voice Translation
description: Session minting and language discovery for the real-time voice translation service.
- name: SDK Distribution
description: Programmatic retrieval of licensed SDK packages and model files.
security:
- ApiKeyAuth: []
paths:
/v2/sdk/voice-translation/session/token:
get:
operationId: createVoiceTranslationSessionToken
tags: [Voice Translation]
summary: Mint a Voice Translation session key
description: >-
Exchanges the long-lived account API key for a short-lived session key. The session key is the
only credential passed to the streaming WebSocket endpoint, so the account key never has to reach
an untrusted client. Mint this on your backend.
parameters:
- name: expiration_ttl
in: query
required: false
description: Session key lifetime in MINUTES.
schema:
type: integer
minimum: 5
maximum: 1440
example: 100
responses:
'200':
description: Session key issued.
content:
application/json:
schema:
$ref: '#/components/schemas/SessionTokenResponse'
example:
data:
session_key: session_key_...
expires_at: '2026-05-04T12:00:00.000Z'
key_id: 123
status: active
type: session
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
/voice-translation/languages:
get:
operationId: listVoiceTranslationLanguages
tags: [Voice Translation]
summary: List supported voice translation languages
description: >-
Returns the languages currently available for voice translation. Use the returned language_code
values as source_language / target_language when starting a session. The list is dynamic — fetch
it at session start rather than hard-coding it.
x-apievangelist-note: >-
Documented in the API reference as "GET /voice-translation/languages" with no version prefix,
unlike the other documented operations which are under /v2/sdk/. Transcribed exactly as published.
responses:
'200':
description: Supported languages.
content:
application/json:
schema:
$ref: '#/components/schemas/LanguagesResponse'
example:
success: true
code: 0
data:
- name: English (United States)
language_code: en-US
- name: French
language_code: fr-FR
- name: German
language_code: de-DE
req_id: '...'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
/v2/sdk/versions/{id}/download-urls:
get:
operationId: getSdkVersionDownloadUrls
tags: [SDK Distribution]
summary: Get short-lived download URLs for an SDK version and its models
description: >-
Retrieves temporary download URLs for a specific licensed SDK version and its associated model
files, for use in CI/CD pipelines, automated testing workflows, or custom deployment scripts. The
returned S3 URLs expire after data.expires_in seconds.
parameters:
- name: id
in: path
required: true
description: The unique version ID of the SDK, found in the SDK Dashboard.
schema:
type: integer
example: 329
responses:
'200':
description: Download URLs issued.
content:
application/json:
schema:
$ref: '#/components/schemas/SdkDownloadUrlsResponse'
example:
success: true
data:
expires_in: 300
version:
id: 42
version: 1.3.4
display_name: VIVA
os: windows_x64
platform: server
technologies: [viva]
filename: release.zip
download_url: s3.amazonaws.com...
models:
- id: 1
technology: voice_isolation
product: viva
filename: model.zip
download_url: s3.amazonaws.com...
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: 'Account API key from https://developers.krisp.ai/, sent as: api-key YOUR_API_KEY'
responses:
Unauthorized:
description: Missing, invalid, or expired API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
PaymentRequired:
description: Balance exhausted or subscription expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
TooManyRequests:
description: Rate limit exceeded or max concurrent connections exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
InternalServerError:
description: Server failed to process the request.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
schemas:
SessionToken:
type: object
properties:
session_key:
type: string
description: Short-lived key passed to the streaming WebSocket endpoint.
expires_at:
type: string
format: date-time
key_id:
type: integer
status:
type: string
example: active
type:
type: string
example: session
SessionTokenResponse:
type: object
properties:
data:
$ref: '#/components/schemas/SessionToken'
Language:
type: object
properties:
name:
type: string
description: Human-readable language name.
example: English (United States)
language_code:
type: string
description: BCP 47 (RFC 5646) locale code.
example: en-US
LanguagesResponse:
type: object
properties:
success:
type: boolean
code:
type: integer
data:
type: array
items:
$ref: '#/components/schemas/Language'
req_id:
type: string
SdkVersion:
type: object
properties:
id:
type: integer
version:
type: string
example: 1.3.4
display_name:
type: string
example: VIVA
os:
type: string
example: windows_x64
platform:
type: string
example: server
technologies:
type: array
items:
type: string
filename:
type: string
example: release.zip
download_url:
type: string
description: Short-lived S3 download URL.
SdkModel:
type: object
properties:
id:
type: integer
technology:
type: string
example: voice_isolation
product:
type: string
example: viva
filename:
type: string
example: model.zip
download_url:
type: string
SdkDownloadUrlsResponse:
type: object
properties:
success:
type: boolean
description: Indicates whether the API request was successful.
data:
type: object
properties:
expires_in:
type: integer
description: Lifespan of the generated download URLs in seconds.
example: 300
version:
$ref: '#/components/schemas/SdkVersion'
models:
type: array
items:
$ref: '#/components/schemas/SdkModel'
Error:
type: object
description: Krisp error payload. Not RFC 9457 problem+json.
properties:
error:
type: object
properties:
code:
type: integer
description: HTTP-style status code.
reason:
type: string
description:
type: string
reference_id:
type: string