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"
}

Modèles & Génération IA

Durée de la session S2S

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"
}

Journaliser la durée de la session S2S

Enregistrez la durée d’une session Speech-to-Speech terminée et déduisez le temps du quota de temps S2S de l’utilisateur.

Point de terminaison

POST /speech/s2s/log-session

Description

Enregistrez la durée d’une session Speech-to-Speech terminée et déduisez le temps du quota de temps S2S de l’utilisateur. Cela doit être appelé après la fin d’une session pour suivre l’utilisation avec précision.

Suivi de l’utilisation

La durée est spécifiée en millisecondes
automatiquement converti en minutes et déduit du quota de l’utilisateur
Le temps est suivi par utilisateur en fonction du niveau de licence
Les journaux d’activité sont créés à des fins d’audit

Authentification

Obligatoire : clé API

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

Corps de la demande

Paramètre	Tapez	Obligatoire	Descriptif
`durationMs`	entier	Oui	Durée de la session en millisecondes (minimum : 0)
`user_id`	chaîne	Non	ID utilisateur à qui facturer cette session (par défaut, propriétaire de la clé API)

Exemple de demande

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);

###Python

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'])

Réponse

Réponse réussie (200)

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

Champs de réponse

Champ	Tapez	Descriptif
`success`	booléen	Toujours vrai pour les demandes réussies
`message`	chaîne	Message de réussite
`request_id`	chaîne	Demander un identifiant pour le suivi

Réponses d’erreur

400 Requête incorrecte

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

401 Non autorisé

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

500 Erreur de serveur interne

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

Remarques

Appelez ce point de terminaison après la fin de chaque session S2S pour suivre avec précision l’utilisation
La durée doit être calculée à partir du moment où la connexion WebRTC est établie jusqu’à sa fermeture
Le temps est automatiquement converti de millisecondes en minutes et déduit du quota de l’utilisateur
Le paramètre user_id permet la facturation sur un autre compte utilisateur
Les journaux d’activité sont automatiquement créés à des fins d’audit
Assurez-vous d’avoir suffisamment de temps restant avant de démarrer une session (vérifiez auprès de /speech/s2s/status)

Autorisations

Authorization

string

header

requis

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

Corps

application/json

durationMs

integer

Session duration in milliseconds

Plage requise: x >= 0

Exemple:

42624

user_id

string

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

Exemple:

"60a7c8f5e8b4f5001f7a8c23"

Réponse

Session logged successfully

success

boolean

Exemple:

true

message

string

Exemple:

"S2S session logged successfully"

request_id

string

Request ID for tracking

Exemple:

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

Premiers Pas & Configuration

Modèles & Génération IA

Base de Connaissances & RAG

Sécurité, Guardrails & Audit

Utilisateurs & Accès (IAM)

Facturation, Quotas & Webhooks

Durée de la session S2S

Journaliser la durée de la session S2S

Point de terminaison

Description

Suivi de l’utilisation

Authentification

Corps de la demande

Exemple de demande

JavaScript/Node.js

Réponse

Réponse réussie (200)

Champs de réponse

Réponses d’erreur

400 Requête incorrecte

401 Non autorisé

500 Erreur de serveur interne

Remarques

Autorisations

Corps

Réponse

​Journaliser la durée de la session S2S

​Point de terminaison

​Description

​Suivi de l’utilisation

​Authentification

​Corps de la demande

​Exemple de demande

​JavaScript/Node.js

​Réponse

​Réponse réussie (200)

​Champs de réponse

​Réponses d’erreur

​400 Requête incorrecte

​401 Non autorisé

​500 Erreur de serveur interne

​Remarques

Autorisations

Corps

Réponse

Journaliser la durée de la session S2S

Point de terminaison

Description

Suivi de l’utilisation

Authentification

Corps de la demande

Exemple de demande

JavaScript/Node.js

Réponse

Réponse réussie (200)

Champs de réponse

Réponses d’erreur

400 Requête incorrecte

401 Non autorisé

500 Erreur de serveur interne

Remarques