Récupérez une réponse de modèle terminée à l'aide de son Response ID.
Remplacez
La valeur
Retournée lorsque le Response ID spécifié n'existe pas :
{WorkspaceId} par votre véritable workspace ID.
China (Beijing)
La valeur base_url pour les appels SDK est : https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
URL de la requête HTTP : GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/responses/{response_id}
- China (Beijing)
La valeur
base_url pour les appels SDK est : https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1URL de la requête HTTP : GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/responses/{response_id}Paramètres de cheminresponse_idstring(obligatoire)Response ID à récupérer, au format resp_xxx. Obtenez-le via la réponse de l'API Create response. Seuls les Response ID retournés lorsque store=true était défini dans la requête de création initiale sont récupérables. | Python |
RéponseRetourne le même objet Response que l'API Create response. Les champs sont décrits ci-dessous : | |
id stringIdentifiant unique de cette réponse, au format resp_xxx. | |
object stringType d'objet. Toujours response. | |
status stringÉtat de la réponse. Valeurs possibles : completed, failed, in_progress, cancelled, queued, incomplete. | |
created_at integerHorodatage Unix (en secondes) indiquant la date de création de la réponse. | |
completed_at integerHorodatage Unix (en secondes) marquant la fin de la génération de la réponse. Valeur null si la réponse n'est pas terminée. | |
error objectObjet d'erreur retourné lorsque le modèle ne parvient pas à générer une réponse. Valeur null en cas de succès. | |
model stringID du modèle utilisé pour produire la réponse. | |
output arrayÉléments de sortie générés par le modèle. Le type et l'ordre des éléments dépendent de la réponse du modèle.
Propriétés des éléments du tableau type stringType d'élément de sortie. Valeurs possibles :
stringIdentifiant unique de l'élément de sortie. Présent pour tous les types de sortie.role stringRôle du message. Toujours assistant. Présent uniquement lorsque type vaut message.status stringÉtat de l'élément de sortie. Valeurs possibles : completed, in_progress. Présent lorsque type diffère de reasoning.name stringNom de l'outil ou de la fonction. Présent lorsque type vaut function_call, web_search_image_call, image_search_call ou mcp_call.Pour web_search_image_call et image_search_call, la valeur est fixée respectivement à "web_search_image" et "image_search".Pour mcp_call, la valeur correspond au nom spécifique de la fonction appelée dans le service MCP (par exemple, amap-maps-maps_geo).arguments stringArguments de l'appel d'outil, formatés sous forme de chaîne JSON. Présent lorsque type vaut function_call, web_search_image_call, image_search_call ou mcp_call. Analysez-les avec JSON.parse() avant utilisation. Le contenu varie selon le type d'outil :
stringIdentifiant unique de l'appel de fonction. Présent uniquement lorsque type vaut function_call. Utilisez cet ID pour associer la requête à la réponse lors du retour des résultats d'appel de fonction.content arrayTableau du contenu du message. Présent uniquement lorsque type vaut message.
Propriétés des éléments du tableau type stringType de contenu. Toujours output_text.text stringContenu textuel généré par le modèle.annotations arrayAnnotations de texte. Généralement un tableau vide.arrayRésumés de raisonnement. Présents uniquement lorsque type vaut reasoning. Chaque élément contient un champ type (valeur summary_text) et un champ text (le texte du résumé).action objectInformations sur l'action de recherche. Présentes uniquement lorsque type vaut web_search_call.
Propriétés query stringMot-clé de la requête de recherche.type stringType de recherche. Toujours search.sources arraySources de la recherche. Chaque élément contient un champ type et un champ url.stringCode généré et exécuté par le modèle. Présent uniquement lorsque type vaut code_interpreter_call.outputs arraySorties de l'exécution du code. Présentes uniquement lorsque type vaut code_interpreter_call. Chaque élément contient un champ type (valeur logs) et un champ logs (journaux d'exécution du code).container_id stringIdentifiant du conteneur de l'interpréteur de code. Présent uniquement lorsque type vaut code_interpreter_call. Utilisez-le pour associer plusieurs exécutions de code au sein de la même session.goal stringDescription de l'objectif d'extraction, précisant les informations à extraire de la page web. Présent uniquement lorsque type vaut web_extractor_call.output stringRésultat de l'appel d'outil, formaté sous forme de chaîne.
arrayURL des pages web extraites. Présentes uniquement lorsque type vaut web_extractor_call.server_label stringLibellé du service MCP. Présent uniquement lorsque type vaut mcp_call. Identifie le service MCP utilisé pour cet appel.queries arrayRequêtes utilisées pour la récupération dans la base de connaissances. Présentes uniquement lorsque type vaut file_search_call. Chaque élément est une requête de recherche générée par le modèle.results arrayRésultats de la récupération depuis la base de connaissances. Présents uniquement lorsque type vaut file_search_call.
Propriétés des éléments du tableau file_id stringID du fichier correspondant au document.filename stringNom du fichier correspondant au document.score floatScore de pertinence, compris entre 0 et 1. Une valeur plus élevée indique une meilleure pertinence.text stringExtrait du contenu du document correspondant. | |
usage objectInformations sur l'utilisation des tokens pour cette requête.
Propriétés input_tokens integerNombre de tokens d'entrée.output_tokens integerNombre de tokens de sortie générés par le modèle.total_tokens integerTotal des tokens utilisés (input_tokens + output_tokens).input_tokens_details objectDétail des tokens d'entrée.
Propriétés cached_tokens integerNombre de tokens mis en cache.objectDétail des tokens de sortie.
Propriétés reasoning_tokens integerNombre de tokens de raisonnement.arrayDétails de facturation.
Propriétés input_tokens integerTokens d'entrée pour ce type de facturation.output_tokens integerTokens de sortie pour ce type de facturation.total_tokens integerTotal des tokens pour ce type de facturation.x_billing_type stringToujours response_api.prompt_tokens_details objectRetourné lorsque la mise en cache de session est activée. Contient un champ cached_tokens (nombre de tokens mis en cache).objectStatistiques d'utilisation des outils. Lorsque des outils intégrés sont utilisés, ce champ contient le nombre d'appels pour chaque outil. Exemple : {"web_search": {"count": 1}} | |
tools arrayReprend le paramètre tools de la requête de création. La structure correspond au paramètre tools du corps de la requête. Tableau vide [] si aucun outil n'a été utilisé. | |
tool_choice stringReprend le paramètre tool_choice de la requête de création. Valeurs possibles : auto, none, required. | |
parallel_tool_calls booleanReprend le paramètre parallel_tool_calls de la requête de création. Indique si le modèle peut appeler plusieurs outils en parallèle. | |
temperature floatReprend le paramètre temperature de la requête de création. Contrôle la diversité de la sortie du modèle. Plage valide : [0, 2). Retourne la valeur par défaut du modèle si non défini. | |
top_p floatReprend le paramètre top_p de la requête de création. Seuil de probabilité pour l'échantillonnage par noyau. Plage valide : (0, 1,0]. Retourne la valeur par défaut du modèle si non défini. | |
frequency_penalty floatReprend le paramètre frequency_penalty de la requête de création. Des valeurs positives réduisent la probabilité de répétition des mots. | |
presence_penalty floatReprend le paramètre presence_penalty de la requête de création. Des valeurs positives augmentent la probabilité d'introduire de nouveaux sujets. | |
top_logprobs integerReprend le paramètre top_logprobs de la requête de création. Nombre de tokens les plus probables retournés à chaque position. Valeur 0 si non activé. | |
store booleanReprend le paramètre store de la requête de création. La valeur true signifie que la réponse est stockée et peut être référencée par previous_response_id. La valeur false signifie qu'elle n'est pas stockée. | |
service_tier stringNiveau de service. Toujours default. | |
background booleanIndique si la réponse a été exécutée de manière asynchrone. Model Studio ne prenant actuellement en charge que les appels synchrones, cette valeur est toujours false. | |
metadata objectReprend le paramètre metadata de la requête de création. Paires clé-valeur personnalisées attachées à la réponse. Objet vide {} si non défini. |