Aller au contenu principal

endpoints_v11.go (package eai)

Source : sdks/go/endpoints_v11.go. Retour à l'index de la référence du SDK Go.

remarque

Cette page est générée par tools/docs/gen_sdk_reference.py depuis les sources du SDK et les dossiers de textes OpenAPI. Ne la modifiez pas à la main : changez la source et régénérez.

Classe MetaService​

MetaService regroupe les points d'accès suivants : points d'accès système, santé, disponibilité, métadonnées de la plateforme et principal courant.

MetaService.Metrics​

Metrics(ctx context.Context, opts ...CallOption) (json.RawMessage, error)

Metrics appelle GET /metrics et renvoie le format texte Prometheus.

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Le texte Prometheus de /metrics encodé en une chaîne JSON. L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error.

Classe RiskService​

Risques et conformité. Gestion des risques des systèmes d'IA du tenant : évaluations au titre de l'AI Act européen, contrôles rattachés à l'ISO/IEC 42001, au NIST AI RMF, au RGPD et à l'AI Act, preuves et dérogations limitées dans le temps.

RiskService.ListExceptions​

ListExceptions(ctx context.Context, opts ...CallOption) (*Page, error)

Lister les dérogations. Liste les dérogations du tenant triées par expiration, chacune avec son status calculé : active, expired ou revoked. Ouvert à tout membre du tenant. next_cursor vaut toujours null.

Route : /v1/risk/exceptions (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (*Page, error). Réponse JSON décodée de l'opération « Lister les dérogations ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

Classe ModelsService​

LLM et passerelle de modèles. Fournisseurs de modèles, registre des modèles, règles de routage et passerelle de modèles (Model Gateway) : le seul chemin par lequel agents et applications appellent les modèles.

ModelsService.ApproveVersion​

ApproveVersion(ctx context.Context, modelID string, version string, body any, opts ...CallOption) (json.RawMessage, error)

Demander l'approbation d'une version. Ouvre une demande d'approbation (action model_version_activation) pour une version draft et répond 202 avec son identifiant ; la version passe à pending_approval. Les approbateurs sont tenant_admin et security_officer, et le demandeur ne peut pas approuver sa propre demande (séparation des tâches). Une version qui n'est pas un brouillon répond 409 model_version_state. Audité. Demande un principal de tenant avec tenant_admin ou platform_admin.

Route : /v1/models/{model_id}/versions/{version}/approval (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
modelIDstringouiIdentifiant du modèle dans le registre.
versionstringouiVersion à approuver, telle qu'enregistrée.
bodyanyoui{reason} facultatif, présenté aux approbateurs.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Demander l'approbation d'une version ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.CreateCategory​

CreateCategory(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)

Créer une catégorie de modèles. Crée une catégorie pour le tenant, ou une catégorie partagée avec scope: platform (platform_admin seulement, 403 platform_only), et répond 201. Un slug déjà utilisé répond 409 category_exists ; des champs invalides 422 parameter_invalid. Audité. Demande tenant_admin, platform_admin ou ai_platform_engineer.

Route : /v1/llm/categories (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
bodyanyouislug (lettres minuscules, chiffres, tirets et soulignés, de 1 à 40 caractères, obligatoire), label (texte ou {en, fr}, 80 caractères au plus, obligatoire), description (500 caractères au plus), icon, sort_order (de 0 à 10000, 100 par défaut), scope (platform pour une catégorie partagée).
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Créer une catégorie de modèles ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.CreateVersion​

CreateVersion(ctx context.Context, modelID string, body any, opts ...CallOption) (json.RawMessage, error)

Enregistrer une version de modèle. Enregistre une version du modèle dans le tenant au statut draft et répond 201. La version demande une licence (expression SPDX, ou référence de conditions commençant par https:// ou LicenseRef-) et la provenance des poids ; des champs invalides répondent 422 model_version_invalid avec leurs noms, une version existante 409 model_version_exists. Audité (model.version.create). Demande un principal de tenant avec tenant_admin ou platform_admin.

Route : /v1/models/{model_id}/versions (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
modelIDstringouiIdentifiant du modèle dans le registre.
bodyanyouiversion (de 1 à 64 caractères : lettres, chiffres, points, tirets, soulignés, plus), licence_spdx ou licence_terms_ref, weights avec source (https://, oci://, hf://, s3:// ou registry://), digest (sha256: et 64 caractères hexadécimaux) et size_bytes (entier positif), capabilities facultatif (liste de textes).
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Enregistrer une version de modèle ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.DeleteCategory​

DeleteCategory(ctx context.Context, slug string, opts ...CallOption) error

Supprimer une catégorie de modèles. Supprime une catégorie créée par le tenant ou la plateforme et répond 204. Une catégorie prédéfinie ne peut pas être supprimée (409 category_builtin), ni une catégorie encore utilisée par un modèle (409 category_in_use) ; une catégorie partagée demande platform_admin (403 platform_only). Audité. Demande tenant_admin, platform_admin ou ai_platform_engineer.

Route : /v1/llm/categories/{slug} (DELETE).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
slugstringouiSlug de la catégorie : lettres minuscules, chiffres, tirets et soulignés, de 1 à 40 caractères.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : error. Erreur de l'appel (une erreur typée du SDK), nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.Enable​

Enable(ctx context.Context, modelID string, opts ...CallOption) (json.RawMessage, error)

Réactiver un modèle désactivé. Lève le kill switch du modèle pour le tenant. Audité (model.enable). Demande tenant_admin, platform_admin ou ai_platform_engineer.

Route : /v1/models/{model_id}/enable (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
modelIDstringouiIdentifiant du modèle dans le registre.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Réactiver un modèle désactivé ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.GetCategory​

GetCategory(ctx context.Context, slug string, opts ...CallOption) (json.RawMessage, error)

Lire une catégorie de modèles. Une catégorie de modèles avec son nombre de modèles. Slug inconnu : 404 category_not_found. Demande un rôle de lecteur.

Route : /v1/llm/categories/{slug} (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
slugstringouiSlug de la catégorie.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire une catégorie de modèles ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.Import​

Import(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)

Importer des modèles découverts. Enregistre les modèles choisis lors d'une découverte. Idempotent : ceux déjà enregistrés (même identifiant, ou même fournisseur et même identifiant chez le fournisseur) sont ignorés et listés avec already_registered. Chaque élément est contrôlé d'abord ; un seul élément invalide refuse tout l'import avec 422 import_invalid et le problème de chaque élément. Chaque modèle et l'import sont audités. Demande tenant_admin, platform_admin ou ai_platform_engineer.

Route : /v1/models/import (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
bodyanyouiprovider_id (identifiant ou nom du fournisseur, obligatoire), models (de 1 à 200 objets issus de la découverte : provider_model_id et, facultativement, l'identifiant du registre, la catégorie et les champs de la fiche), scope facultatif (platform).
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Importer des modèles découverts ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.ListCategories​

ListCategories(ctx context.Context, opts ...CallOption) (*Page, error)

Lister les catégories de modèles. Catégories de modèles visibles par l'appelant (prédéfinies, partagées et propres au tenant) avec leur libellé et leur description en anglais et en français, leur icône, leur ordre et le nombre de modèles qui les utilisent. Une seule page. Demande un rôle de lecteur.

Route : /v1/llm/categories (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (*Page, error). Réponse JSON décodée de l'opération « Lister les catégories de modèles ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.ListVersions​

ListVersions(ctx context.Context, modelID string, opts ...CallOption) (json.RawMessage, error)

Lister les versions d'un modèle. Versions du modèle dans le tenant, de la plus ancienne à la plus récente, avec licence, source, empreinte et taille des poids, capacités, statut (draft, pending_approval, canary, active, superseded, rolled_back) et approbation. Demande un principal de tenant avec tenant_admin, platform_admin, security_officer, finops, developer, auditor ou viewer.

Route : /v1/models/{model_id}/versions (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
modelIDstringouiIdentifiant du modèle dans le registre.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les versions d'un modèle ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.Rollback​

Rollback(ctx context.Context, modelID string, body any, opts ...CallOption) (json.RawMessage, error)

Revenir à la version précédente d'un modèle. Pendant un canari, l'interrompt : la version active garde tout le trafic. Sinon, rétablit la version qui était active avant la dernière publication complète. La version quittée devient rolled_back, l'étape est ajoutée à l'historique de déploiement et auditée (model.rollout.rollback). Rien à annuler : 409 model_rollback_unavailable. Demande un principal de tenant avec tenant_admin ou platform_admin.

Route : /v1/models/{model_id}/rollback (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
modelIDstringouiIdentifiant du modèle dans le registre.
bodyanyoui{reason} facultatif, inscrit dans l'historique de déploiement et le journal d'audit.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Revenir à la version précédente d'un modèle ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.Rollout​

Rollout(ctx context.Context, modelID string, opts ...CallOption) (json.RawMessage, error)

Lire le déploiement d'un modèle. Version active, version canari et part du canari du modèle dans le tenant, avec tout l'historique de déploiement (publication, canari, retour arrière, acteur, raison, approbation). Demande un principal de tenant avec tenant_admin, platform_admin, security_officer, finops, developer, auditor ou viewer.

Route : /v1/models/{model_id}/rollout (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
modelIDstringouiIdentifiant du modèle dans le registre.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire le déploiement d'un modèle ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.RolloutVersion​

RolloutVersion(ctx context.Context, modelID string, version string, body any, opts ...CallOption) (json.RawMessage, error)

Publier une version de modèle. Publie une version approuvée entièrement (canary_percent à 100, par défaut) ou en canari pour 1 à 99 pour cent du trafic, choisi de façon déterministe selon l'appelant (même session ou même principal, même version). Demande un principal de tenant avec tenant_admin ou platform_admin.

Route : /v1/models/{model_id}/versions/{version}/rollout (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
modelIDstringouiIdentifiant du modèle dans le registre.
versionstringouiVersion approuvée à publier.
bodyanyouicanary_percent (entier de 1 à 100, 100 par défaut) et une reason facultative.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Publier une version de modèle ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

ModelsService.UpdateCategory​

UpdateCategory(ctx context.Context, slug string, body any, opts ...CallOption) (json.RawMessage, error)

Modifier une catégorie de modèles. Modifie le libellé, la description, l'icône ou l'ordre d'une catégorie ; le slug ne change jamais. Une catégorie prédéfinie répond 409 category_builtin ; une catégorie partagée demande platform_admin. Des valeurs invalides répondent 422 parameter_invalid. Audité. Demande tenant_admin, platform_admin ou ai_platform_engineer.

Route : /v1/llm/categories/{slug} (PATCH).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
slugstringouiSlug de la catégorie.
bodyanyouiChamps à modifier : label et description (un texte, ou {en, fr} ; libellé de 80 caractères au plus, description de 500), icon (nom en minuscules de 1 à 48 caractères, ou null), sort_order (de 0 à 10000).
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Modifier une catégorie de modèles ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

Classe MediaService​

Multimodal. Médias et traitement multimodal : stockage chiffré de médias et travaux de vision, génération et retouche d'images, traitement et génération de vidéos, transcription de la parole, diarisation, synthèse vocale et DLP multimodale.

MediaService.List​

List(ctx context.Context, opts ...CallOption) (*Page, error)

Lister les médias. Médias du tenant (documents Multimodal Contract), paginés par clé avec cursor, filtrés par media_type et classification (400 invalid_request pour une valeur inconnue).

Route : /v1/media (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (*Page, error). Réponse JSON décodée de l'opération « Lister les médias ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

Classe MultimodalService​

Multimodal. Médias et traitement multimodal : stockage chiffré de médias et travaux de vision, génération et retouche d'images, traitement et génération de vidéos, transcription de la parole, diarisation, synthèse vocale et DLP multimodale.

MultimodalService.CompleteJob​

CompleteJob(ctx context.Context, id string, body any, opts ...CallOption) (json.RawMessage, error)

Signaler le résultat d'un travail en file. Appelé par les workers GPU (identités d'agent ou de service) pour signaler le résultat d'un travail en file : statut running, succeeded, failed ou cancelled (sinon 400 invalid_request), avec sortie, erreur et unités mesurées ; la réservation de quota est validée ou libérée. Un travail terminé répond 409 conflict. Demande agent ou tenant_admin. 404 not_found.

Route : /v1/multimodal/jobs/{job_id}/complete (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
idstringouiIdentifiant (UUID) du travail.
bodyanyouiStatut, sortie, erreur et unités mesurées du travail.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Signaler le résultat d'un travail en file ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

Classe RealtimeService​

Voix en temps réel. Sessions de voix en temps réel : un jeton de salle LiveKit et un protocole d'événements WebSocket pour diffuser de l'audio vers un agent, avec consentement des participants, tours de parole, transcriptions filtrées par la DLP, enregistrements facultatifs et comptage d'usage.

RealtimeService.CreateToken​

CreateToken(ctx context.Context, id string, opts ...CallOption) (json.RawMessage, error)

Obtenir un nouveau jeton WebSocket. Nouveau jeton WebSocket à usage unique pour une session ouverte (reconnexion), lu sous RLS : ws_url, ws_token, ws_token_expires_at. 409 session_ended ; 404 not_found. Demande tenant_admin, developer ou agent. Audité sous realtime.session.token.

Route : /v1/realtime/sessions/{session_id}/token (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
idstringouiIdentifiant (UUID) de la session temps réel.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Obtenir un nouveau jeton WebSocket ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

RealtimeService.GetSession​

GetSession(ctx context.Context, id string, opts ...CallOption) (json.RawMessage, error)

Lire une session temps réel. Renvoie la session : salle, identités, agent, pipeline, configuration, statut, secondes d'audio, jetons et usage. 404 not_found.

Route : /v1/realtime/sessions/{session_id} (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
idstringouiIdentifiant (UUID) de la session temps réel.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire une session temps réel ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

RealtimeService.ListConsents​

ListConsents(ctx context.Context, sessionID string, opts ...CallOption) (json.RawMessage, error)

Lister les consentements d'une session. Consentements enregistrés pour la session, dans l'ordre de recueil, avec leur révocation le cas échéant. Une seule page.

Route : /v1/realtime/sessions/{session_id}/consents (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
sessionIDstringouiIdentifiant (UUID) de la session temps réel.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les consentements d'une session ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

RealtimeService.RecordConsent​

RecordConsent(ctx context.Context, sessionID string, body any, opts ...CallOption) (json.RawMessage, error)

Enregistrer le consentement d'un participant. Consentement d'un participant (finalité, enregistrement, transcription, conservation, méthode), recueilli par l'appelant (201). Le participant est par défaut celui de la session. La méthode doit être verbal, click, written ou api (422 parameter_invalid) ; la session ne doit pas être terminée (409 session_ended) ; la politique realtime.consent.record est évaluée. Demande tenant_admin, developer ou agent. Audité sous realtime.consent.record.

Route : /v1/realtime/sessions/{session_id}/consents (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
sessionIDstringouiIdentifiant (UUID) de la session temps réel.
bodyanyouiLe consentement du participant.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Enregistrer le consentement d'un participant ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

RealtimeService.RevokeConsent​

RevokeConsent(ctx context.Context, sessionID string, consentID string, opts ...CallOption) (json.RawMessage, error)

Révoquer un consentement. La révocation prend effet au prochain événement audio : transcription et enregistrement sont de nouveau refusés. Un consentement déjà révoqué ou inconnu répond 404 not_found. Demande tenant_admin, developer ou agent. Audité sous realtime.consent.revoke.

Route : /v1/realtime/sessions/{session_id}/consents/{consent_id}/revoke (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
sessionIDstringouiIdentifiant (UUID) de la session temps réel.
consentIDstringouiIdentifiant (UUID) du consentement.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Révoquer un consentement ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

RealtimeService.Transcripts​

Transcripts(ctx context.Context, sessionID string, opts ...CallOption) (json.RawMessage, error)

Lister les transcriptions d'une session. Transcriptions conservées, déjà filtrées par la DLP (la transcription brute n'est jamais conservée), avec tour, consentement, participant, détections DLP et expiration. Demande tenant_admin, developer, auditor ou security_officer.

Route : /v1/realtime/sessions/{session_id}/transcripts (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
sessionIDstringouiIdentifiant (UUID) de la session temps réel.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les transcriptions d'une session ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

RealtimeService.Turns​

Turns(ctx context.Context, sessionID string, opts ...CallOption) (json.RawMessage, error)

Lister les tours d'une session. Tours avec le participant, l'utilisateur, l'agent, l'identifiant de trace, le statut (une interruption enregistre cancelled) et la latence mesurée, dans l'ordre. Une seule page.

Route : /v1/realtime/sessions/{session_id}/turns (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
sessionIDstringouiIdentifiant (UUID) de la session temps réel.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les tours d'une session ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

RealtimeService.WebSocketURL​

WebSocketURL(sessionID string) (string, error)

WebSocketURL renvoie l'URL ws(s) du WebSocket /v1/realtime/ws/{session_id} ; s'y connecter avec les en-têtes de Client.Headers (voir le paquet realtime).

NomTypeDéfautRequisDescription
sessionIDstringouiIdentifiant de la session temps réel, placé à la place de {session_id}.

Retour : (string, error). L'URL wss:// (ou ws:// pour localhost et 127.0.0.1) construite depuis l'URL de base ; l'error est renseignée quand l'identifiant ou l'URL est refusé par ValidateWebSocketURL.

Erreurs levées : error.

Classe FinOpsService​

FinOps. Gestion des coûts de l'usage de l'IA : grilles tarifaires, événements d'usage, estimations, quotas et réservations, répartition du coût des GPU, rapprochement de la facturation et alertes.

FinOpsService.CheckBudget​

CheckBudget(ctx context.Context, opts ...CallOption) (json.RawMessage, error)

Lire la consommation des quotas. Chaque quota du tenant avec sa fenêtre courante et le coût et les jetons consommés et réservés dans celle-ci. Les quotas par exécution demandent run pour trouver leur fenêtre. Demande un rôle de lecteur et un principal de tenant.

Route : /v1/quotas/usage (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire la consommation des quotas ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

FinOpsService.CreateMediaPrice​

CreateMediaPrice(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)

Ajouter une révision de prix de média. Ajoute une révision de prix datée pour une unité de média et répond 201. Une révision ne réécrit jamais une révision plus ancienne. Les mêmes unité, fournisseur, ressource et date de début répondent 409 media_price_exists ; un champ invalide 422 media_price_invalid. Audité. Demande finops ou tenant_admin, et un principal de tenant.

Route : /v1/finops/media-prices (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
bodyanyouiunit (audio_second, image, video_second, gpu_second, storage_gb_month), provider, unit_price (nombre, au moins 0), currency (ISO 4217), source (origine du prix, obligatoire), et facultativement resource (* par défaut, tout le fournisseur) et effective_from (ISO 8601, maintenant par défaut).
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Ajouter une révision de prix de média ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

FinOpsService.EstimateMediaCost​

EstimateMediaCost(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)

Estimer des coûts de médias. Valorise jusqu'à 100 éléments de médias avec la révision en vigueur à leur date (ressource exacte d'abord, puis la révision * du fournisseur). Un élément sans prix revient avec amount: null, status: unavailable et reason: price_unknown ; total n'est donné que si tous les éléments sont valorisés dans une seule devise (complete: true). Des éléments invalides répondent 422 media_price_invalid avec le champ. Demande un rôle de lecteur ou agent, et un principal de tenant.

Route : /v1/finops/media-costs/estimate (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
bodyanyouiitems : de 1 à 100 objets avec unit (audio_second, image, video_second, gpu_second, storage_gb_month), provider, quantity (nombre positif), et facultativement resource (* par défaut) et at (ISO 8601, maintenant par défaut).
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Estimer des coûts de médias ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

FinOpsService.ListMediaPrices​

ListMediaPrices(ctx context.Context, opts ...CallOption) (json.RawMessage, error)

Lister les prix des médias. Révisions datées des prix des médias du tenant par unité, fournisseur, ressource et date, avec la liste des unités prises en charge. Une unité inconnue répond 422 media_price_invalid. Demande un rôle de lecteur et un principal de tenant.

Route : /v1/finops/media-prices (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lister les prix des médias ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

FinOpsService.RecordUsage​

RecordUsage(ctx context.Context, event any, opts ...CallOption) (json.RawMessage, error)

Ingérer un événement d'usage. Valide un Usage Event v1, le valorise (coût mesuré dans la devise du tenant) et l'enregistre ; répond 201, ou 200 avec duplicate: true si le même event_id était déjà enregistré. Un événement invalide répond 422 usage_event_invalid avec les erreurs ; un événement d'un autre tenant 403 usage_tenant_mismatch. Un événement d'audit par appel, jamais le contenu. Demande finops, tenant_admin, agent ou developer, et un principal de tenant.

Route : /v1/finops/usage (POST).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
eventanyouiUsage Event à enregistrer, toute valeur sérialisable en JSON ; transmise telle quelle à IngestUsage.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Ingérer un événement d'usage ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

FinOpsService.Settings​

Settings(ctx context.Context, opts ...CallOption) (json.RawMessage, error)

Lire les paramètres FinOps. Devise, budget mensuel, seuil d'écart et durée de vie des réservations du tenant (valeurs par défaut : USD, pas de budget, 10 pour cent, 900 secondes). Demande un rôle de lecteur et un principal de tenant.

Route : /v1/finops/settings (GET).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Lire les paramètres FinOps ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).

FinOpsService.UpdateSettings​

UpdateSettings(ctx context.Context, body any, opts ...CallOption) (json.RawMessage, error)

Modifier les paramètres FinOps. Modifie les paramètres fournis du tenant ; les champs omis ou null gardent leur valeur. Audité (finops.settings.update). Demande finops ou tenant_admin, et un principal de tenant.

Route : /v1/finops/settings (PUT).

NomTypeDéfautRequisDescription
ctxcontext.ContextouiContexte de l'appel : annulation et échéance.
bodyanyouiParamètres à modifier.
opts...CallOptionnonOptions de l'appel (requête, clé d'idempotence, traceparent, en-têtes).

Retour : (json.RawMessage, error). Réponse JSON décodée de l'opération « Modifier les paramètres FinOps ». L'error est une erreur typée du SDK, nil en cas de succès.

Erreurs levées : error, les erreurs typées du transport (Erreurs).