Créer une réponse

API OpenAI Responses permettant de créer une réponse de modèle. Prend notamment en charge les conversations à plusieurs tours, les appels d’outils et le raisonnement.

POST /v1/responses

Racine du service: https://getrouter.ai

Protocole: OpenAI Responses

Authentification: Authorization: Bearer YOUR_API_KEY

Corps de la requête

Le corps de la requête est obligatoire. Type de média: application/json

Champs de la requête

ChampTypeObligatoireDescription
modelstringOui
inputstring or array<object>NonContenu d’entrée, sous forme de chaîne ou de tableau de messages
instructionsstringNon
max_output_tokensintegerNon
temperaturenumberNon
top_pnumberNon
streambooleanNon
toolsarray<object>Non
tool_choicestring or objectNon
reasoningobjectNon
previous_response_idstringNon
truncationstringNonValeurs autorisées: auto, disabled

Exemple de requête

curl --request POST \
  --url https://getrouter.ai/v1/responses \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "stream": false,
  "temperature": 1,
  "max_output_tokens": 1
}'

Réponses

StatutDescription
200Réponse créée

Champs d’une réponse réussie

ChampTypeObligatoireDescription
idstringNon
objectstringNon
created_atintegerNon
statusstringNonValeurs autorisées: completed, failed, in_progress, incomplete
modelstringNon
outputarray<object>Non
usageobjectNon

Exemple de réponse

{
  "id": "string",
  "object": "object",
  "created_at": 1,
  "status": "completed",
  "model": "MODEL_ID",
  "output": [
    {
      "type": "string",
      "id": "string",
      "status": "completed",
      "role": "user",
      "content": [
        {
          "type": "string",
          "text": "string"
        }
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1,
    "prompt_tokens_details": {
      "cached_tokens": 1,
      "text_tokens": 1,
      "audio_tokens": 1,
      "image_tokens": 1
    },
    "completion_tokens_details": {
      "text_tokens": 1,
      "audio_tokens": 1,
      "reasoning_tokens": 1
    }
  }
}

Guide associé

Pour les flux de travail et exemples complets, consultez le guide de l’API Responses.


Cette page est générée à partir de la spécification OpenAPI Relay publique. Consultez la spécification complète dans l’API Explorer.