Skip to main content
POST
Transcribes and translates input audio into English text.
Choose an exact compatible ID from the model list. Supported parameters and output formats vary by model and connection; this schema does not guarantee every upstream feature. See endpoint availability.

Authorizations

api-key
string
header
required

Your Hicap API key.

Headers

x-hicap-tags
string

One JSON object mapping dimension keys to short string values. Never include secrets or direct personal identifiers. Opaque identity references require approved policy and verified destination handling; see the identity attribution guide.

Body

multipart/form-data

Translation request.

file
file
required

The audio file to translate.

model
string
required

Exact compatible Hicap model ID from GET /v1/models.

Minimum string length: 1
prompt
string

An optional text to guide the model's style or continue a previous audio segment. The prompt should be in English.

response_format
enum<string>

Defines the format of the output.

Available options:
json,
text,
srt,
verbose_json,
vtt
temperature
number
default:0

The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.

Response

OK

Translation or transcription response when response_format was json

text
string
required

Translated or transcribed text.