Log S2S Session Duration

curl --request POST \
  --url https://secureai.hiperai.ai/api/external/speech/s2s/log-session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "durationMs": 42624,
  "user_id": "60a7c8f5e8b4f5001f7a8c23"
}
'

import requests

url = "https://secureai.hiperai.ai/api/external/speech/s2s/log-session"

payload = {
    "durationMs": 42624,
    "user_id": "60a7c8f5e8b4f5001f7a8c23"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({durationMs: 42624, user_id: '60a7c8f5e8b4f5001f7a8c23'})
};

fetch('https://secureai.hiperai.ai/api/external/speech/s2s/log-session', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "message": "S2S session logged successfully",
  "request_id": "3fb8d444-2242-4764-9202-8e9e72464192"
}

{
  "success": false,
  "error": "Invalid user_id",
  "message": "The specified user_id does not exist",
  "request_id": "3fb8d444-2242-4764-9202-8e9e72464192"
}

{
  "success": false,
  "error": "Failed to log S2S session",
  "message": "An error occurred while logging the session",
  "request_id": "3fb8d444-2242-4764-9202-8e9e72464192"
}

Modelos & Geração de IA

Registrar Sessão Speech-to-Speech

Log the duration of a completed Speech-to-Speech session and deduct the time from the user’s S2S time quota. This should be called after a session ends to track usage accurately.

Usage Tracking:

Duration is specified in milliseconds
Automatically converted to minutes and deducted from user’s quota
Time is tracked per-user based on license tier
Activity logs are created for audit purposes

POST

speech

s2s

log-session

Log S2S Session Duration

curl --request POST \
  --url https://secureai.hiperai.ai/api/external/speech/s2s/log-session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "durationMs": 42624,
  "user_id": "60a7c8f5e8b4f5001f7a8c23"
}
'

import requests

url = "https://secureai.hiperai.ai/api/external/speech/s2s/log-session"

payload = {
    "durationMs": 42624,
    "user_id": "60a7c8f5e8b4f5001f7a8c23"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({durationMs: 42624, user_id: '60a7c8f5e8b4f5001f7a8c23'})
};

fetch('https://secureai.hiperai.ai/api/external/speech/s2s/log-session', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "message": "S2S session logged successfully",
  "request_id": "3fb8d444-2242-4764-9202-8e9e72464192"
}

{
  "success": false,
  "error": "Invalid user_id",
  "message": "The specified user_id does not exist",
  "request_id": "3fb8d444-2242-4764-9202-8e9e72464192"
}

{
  "success": false,
  "error": "Failed to log S2S session",
  "message": "An error occurred while logging the session",
  "request_id": "3fb8d444-2242-4764-9202-8e9e72464192"
}

Registrar a duração da sessão S2S

Registre a duração de uma sessão de conversão de fala em fala concluída e deduza o tempo da cota de tempo S2S do usuário.

Ponto final

POST /speech/s2s/log-session

Descrição

Registre a duração de uma sessão de conversão de fala em fala concluída e deduza o tempo da cota de tempo S2S do usuário. Isso deve ser chamado após o término de uma sessão para rastrear o uso com precisão.

Rastreamento de uso

A duração é especificada em milissegundos
Convertido automaticamente em minutos e deduzido da cota do usuário
O tempo é rastreado por usuário com base no nível de licença
Os logs de atividades são criados para fins de auditoria

Autenticação

Obrigatório: Chave API

Authorization: Bearer sk-your-api-key-here

Corpo da solicitação

Parâmetro	Tipo	Obrigatório	Descrição
`durationMs`	inteiro	Sim	Duração da sessão em milissegundos (mínimo: 0)
`user_id`	corda	Não	ID do usuário para cobrar esta sessão (o padrão é o proprietário da chave de API)

Exemplo de solicitação

curl -X POST "https://{customer.name}.hiperai.ai/api/external/speech/s2s/log-session" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "durationMs": 42624,
    "user_id": "60a7c8f5e8b4f5001f7a8c23"
  }'

###JavaScript/Node.js

// Calculate session duration in milliseconds
const sessionStartTime = Date.now();
// ... session happens ...
const sessionEndTime = Date.now();
const durationMs = sessionEndTime - sessionStartTime;

const response = await fetch('https://{customer.name}.hiperai.ai/api/external/speech/s2s/log-session', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk-your-api-key-here',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    durationMs: durationMs,
    user_id: '60a7c8f5e8b4f5001f7a8c23'
  })
});

const data = await response.json();
console.log('Session logged:', data.message);

###Píton

import requests
import time

# Calculate session duration
session_start = time.time() * 1000  # Convert to milliseconds
# ... session happens ...
session_end = time.time() * 1000
duration_ms = int(session_end - session_start)

url = "https://{customer.name}.hiperai.ai/api/external/speech/s2s/log-session"
headers = {
    "Authorization": "Bearer sk-your-api-key-here",
    "Content-Type": "application/json"
}
data = {
    "durationMs": duration_ms,
    "user_id": "60a7c8f5e8b4f5001f7a8c23"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print('Session logged:', result['message'])

Resposta

Resposta de sucesso (200)

{
  "success": true,
  "message": "S2S session logged successfully",
  "request_id": "3fb8d444-2242-4764-9202-8e9e72464192"
}

Campos de resposta

Campo	Tipo	Descrição
`success`	booleano	Sempre verdadeiro para solicitações bem-sucedidas
`message`	corda	Mensagem de sucesso
`request_id`	corda	Solicitar ID para rastreamento

Respostas de erro

400 Solicitação incorreta

{
  "success": false,
  "error": "Invalid user_id",
  "message": "The specified user_id does not exist",
  "request_id": "3fb8d444-2242-4764-9202-8e9e72464192"
}

401 Não autorizado

{
  "success": false,
  "error": "Invalid API key",
  "message": "The provided API key is invalid or has been revoked"
}

500 Erro interno do servidor

{
  "success": false,
  "error": "Failed to log S2S session",
  "message": "An error occurred while logging the session",
  "request_id": "3fb8d444-2242-4764-9202-8e9e72464192"
}

Notas

Chame esse endpoint após o término de cada sessão S2S para rastrear o uso com precisão
A duração deve ser calculada desde o estabelecimento da conexão WebRTC até o fechamento
O tempo é convertido automaticamente de milissegundos para minutos e deduzido da cota do usuário
O parâmetro user_id permite o faturamento para uma conta de usuário diferente
Os logs de atividades são criados automaticamente para fins de auditoria
Certifique-se de ter tempo restante suficiente antes de iniciar uma sessão (verifique com /speech/s2s/status)

Autorizações

Authorization

string

header

obrigatório

API key authentication using Bearer token format. Example: Authorization: Bearer sk-your-api-key-here

Corpo

application/json

durationMs

integer

Session duration in milliseconds

Intervalo necessário: x >= 0

Exemplo:

42624

user_id

string

Optional user ID to bill this session to (defaults to API key owner)

Exemplo:

"60a7c8f5e8b4f5001f7a8c23"

Resposta

Session logged successfully

success

boolean

Exemplo:

true

message

string

Exemplo:

"S2S session logged successfully"

request_id

string

Request ID for tracking

Exemplo:

"3fb8d444-2242-4764-9202-8e9e72464192"

Primeiros Passos & Configuração

Modelos & Geração de IA

Knowledge Base & RAG

Segurança, Guardrails & Auditoria

Usuários & Acesso (IAM)

Faturamento, Cotas & Webhooks

Registrar Sessão Speech-to-Speech

Registrar a duração da sessão S2S

Ponto final

Descrição

Rastreamento de uso

Autenticação

Corpo da solicitação

Exemplo de solicitação

Resposta

Resposta de sucesso (200)

Campos de resposta

Respostas de erro

400 Solicitação incorreta

401 Não autorizado

500 Erro interno do servidor

Notas

Autorizações

Corpo

Resposta

​Registrar a duração da sessão S2S

​Ponto final

​Descrição

​Rastreamento de uso

​Autenticação

​Corpo da solicitação

​Exemplo de solicitação

​Resposta

​Resposta de sucesso (200)

​Campos de resposta

​Respostas de erro

​400 Solicitação incorreta

​401 Não autorizado

​500 Erro interno do servidor

​Notas

Autorizações

Corpo

Resposta

Registrar a duração da sessão S2S

Ponto final

Descrição

Rastreamento de uso

Autenticação

Corpo da solicitação

Exemplo de solicitação

Resposta

Resposta de sucesso (200)

Campos de resposta

Respostas de erro

400 Solicitação incorreta

401 Não autorizado

500 Erro interno do servidor

Notas