Распознавание речи (STT)
curl --request POST \
--url https://api.example.com/api/v2/sttimport requests
url = "https://api.example.com/api/v2/stt"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.example.com/api/v2/stt', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v2/stt",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v2/stt"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/api/v2/stt")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v2/stt")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyГенерация (результаты)
Распознавание речи (STT)
Распознавание загруженной записи с GPT-Transcribe и серверной котировкой
POST
/
api
/
v2
/
stt
Распознавание речи (STT)
curl --request POST \
--url https://api.example.com/api/v2/sttimport requests
url = "https://api.example.com/api/v2/stt"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.example.com/api/v2/stt', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v2/stt",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v2/stt"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/api/v2/stt")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v2/stt")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodygpt-transcribe распознаёт речь из загруженной записи. Используйте отдельный multipart-маршрут
POST /api/v2/stt; поле audio_url в /generate его не заменяет.
Доступные вашему аккаунту STT-модели возвращает каталог GET /api/v2/models.
Файл и язык
audio: непустой файл до 25 МиБ (25 * 1024 * 1024байт).- Форматы GPT-Transcribe: MP3, MPGA, MPEG, WAV, M4A, OGG, WEBM, MP4 и FLAC.
model:gpt-transcribe; если не указан, сервер выбирает текущую доступную OpenAI STT-модель.language:autoили один двухбуквенный код, напримерruилиen.
Цена перед запуском
POST /api/v2/stt/quote принимает те же audio, model и language.
Этот запрос не вызывает модель и не списывает токены. Ответ содержит model,
duration_seconds, token_cost и непрозрачный quote_fingerprint.
Передайте полученные значения в платный запрос как expected_token_cost и
quote_fingerprint. Если файл, модель, настройки или цена изменились, сервер
вернёт 409 до генерации и списания. Получите новую цену и подтвердите запуск заново;
не повторяйте платный запрос автоматически.
import requests
base = "https://elumenta.ru/api/v2"
headers = {"Authorization": "Bearer nb_YOUR_API_KEY"}
fields = {"model": "gpt-transcribe", "language": "ru"}
with open("recording.mp3", "rb") as audio:
response = requests.post(
base + "/stt/quote", headers=headers,
files={"audio": ("recording.mp3", audio, "audio/mpeg")}, data=fields,
)
response.raise_for_status()
quote = response.json()
print("Стоимость:", quote["token_cost"], "токенов")
# Продолжайте только после согласия с показанной ценой.
with open("recording.mp3", "rb") as audio:
response = requests.post(
base + "/stt", headers=headers,
files={"audio": ("recording.mp3", audio, "audio/mpeg")},
data={**fields, "expected_token_cost": quote["token_cost"],
"quote_fingerprint": quote["quote_fingerprint"]},
)
response.raise_for_status()
print(response.json()["result_text"])
Ответ
{
"id": 18510,
"status": "completed",
"result_text": "Привет и добро пожаловать в сегодняшний выпуск.",
"tokens_spent": 1
}
id — идентификатор записи в истории. В ответе STT текст находится в result_text.
Прямой запрос без полей котировки остаётся допустимым: сервер проверит файл и рассчитает
актуальную стоимость перед запуском. Для интерфейса подтверждения цены используйте котировку.
После перехода каталога whisper и gpt-4o-transcribe исключены из новых выборов.
Их исторические записи, цены и результаты сохраняются; явный запрос к снятой модели
не перенаправляется на другую без согласования. Параметры других STT-моделей сверяйте
с их текущим контрактом; дополнительные поля не становятся поддержанными от передачи в форму.
