Documentation

Responses API

Mis à jour le 2026-08-29

/v1/responses est l’un des principaux points de terminaison natifs d’OpenAI. Il est recommandé d’évaluer en priorité Responses pour les nouveaux projets ; si votre client ou votre cadre utilise par défaut Chat Completions, utilisez l’appel compatible OpenAI.

Le Base URL reste https://api.rokoapi.com/v1.

Point de terminaison

POST /v1/responses

Démarrage rapide

curl https://api.rokoapi.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "input": "Présentez-vous en une phrase",
    "instructions": "Vous êtes un assistant concis"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.rokoapi.com/v1",
)

response = client.responses.create(
    model="gpt-4o",
    input="Présentez-vous en une phrase",
    instructions="Vous êtes un assistant concis",
)
print(response.output_text)

Pour extraire le texte, privilégiez output_text ; lors de l’itération manuelle sur output , notez que le premier élément peut être reasoning plutôt que message.

Paramètres courants

Paramètre	Description
`model`	Identifiant du modèle disponible et compatible avec Responses
`input`	Chaîne de caractères ou tableau de messages
`instructions`	Instructions système (équivalent du system prompt)
`max_output_tokens`	Nombre maximal de tokens en sortie
`stream`	Flux d’événements sémantiques
`tools` / `tool_choice`	Fonctions et outils intégrés (selon le support amont)

Indicateurs de capacité du modèle

La page de chaque modèle affiche les capacités Responses configurées dans la console d’administration. Vérifiez ces indicateurs avant tout appel :

Indicateur	Signification
`responses-native`	Le fournisseur amont prend nativement en charge le protocole Responses
`responses-compatible`	La passerelle convertit la requête vers un autre protocole amont ; seules les capacités déclarées sont garanties
`structured-outputs`	Les sorties structurées JSON Schema sont prises en charge
`previous-response-id`	`previous_response_id` permet de poursuivre une réponse
`conversation-state`	L’état de conversation géré par le fournisseur amont est pris en charge
`responses-compact`	`POST /v1/responses/compact` est pris en charge
`stored-responses`	L’option `store` est prise en charge
`parallel-tool-calls`	Les appels d’outils en parallèle sont pris en charge
`max-tool-calls`	La limite `max_tool_calls` est prise en charge

Le client ne doit pas présumer qu’une capacité absente est disponible. Les modèles en compatibilité convertie ne déclarent pas les fonctions dépendant du cycle de vie des ressources amont, comme l’état de conversation, le stockage des réponses ou la compaction.

Modèles actuellement compatibles par conversion

Modèle	Conversion	Comportements pris en charge
`deepseek-v4-flash`	Conversion bidirectionnelle entre Responses et DeepSeek Chat Completions	Texte, fonctions, résultats d’outils et événements en streaming
`deepseek-v4-pro`	Conversion bidirectionnelle entre Responses et DeepSeek Chat Completions	Texte, fonctions, résultats d’outils et événements en streaming
`glm-5.3`	Conversion bidirectionnelle entre Responses et Zhipu V4 Chat Completions	Texte, fonctions, résultats d’outils et événements en streaming
`glm-5.3-flash`	Conversion bidirectionnelle entre Responses et Zhipu V4 Chat Completions	Texte, fonctions, résultats d’outils et événements en streaming

Ces modèles utilisent une conversion de compatibilité sans état. Conservez côté client l’historique complet de la conversation et des appels d’outils, puis renvoyez-le dans le prochain input. Ils ne prennent pas en charge previous_response_id, conversation, compact ni le stockage des réponses.

Conversations multi-tours

Par défaut, gérez l’historique côté client et placez le contexte complet dans le tableau input. N’utilisez les paramètres avec état que si la page du modèle affiche explicitement previous-response-id ou conversation-state.

Sortie en flux continu

Le flux de Responses est composé d’événements sémantiques (par ex. response.output_text.delta), contrairement au comportement de Chat Completions pour choices[0].delta de Chat Completions. Après avoir défini stream: true , traitez les événements selon leur type.

Comparaison avec Chat Completions

Chat Completions	Responses
`messages`	`input`
Message system	`instructions`
`max_tokens`	`max_output_tokens`
`choices[0].message.content`	`output_text`

Remarques

Vérifiez d’abord sur la page des modèles ou dans la documentation des modèles disponibles si le modèle cible prend en charge Responses
Les outils intégrés et les tâches en arrière-plan dépendent de l’amont ; une capacité non déclarée sur la page du modèle ne fait pas partie du contrat de compatibilité