Responses multimodal OpenAI

API Responses compatible OpenAI. Cet endpoint utilise input au format OpenAI et prend en charge le texte, les URL publiques d’images, les fichiers PDF, les appels d’outils, les options de raisonnement et les paramètres de streaming.

POST https://api.apihop.ai/openai/responses

Authentification

Toutes les requêtes nécessitent une authentification par jeton Bearer.

Authorization: Bearer YOUR_API_KEY

Corps

Différences de paramètres entre modèles

• Le transfert natif compatible OpenAI Responses conserve top_p dans la requête au fournisseur ; validation et échantillonnage dépendent du modèle et du fournisseur choisis. Les contrôles du 2026-09-26 ont accepté top_p: 0.9 pour gpt-5.5, gpt-5.6-sol et gpt-5.6-terra. L’acceptation et le transfert ne prouvent pas un effet d’échantillonnage ni ne garantissent la prise en charge d’autres valeurs, modèles ou requêtes futures. Commencez par une requête minimale.
• La prise en charge décrite ici concerne uniquement l’endpoint normal /openai/responses. Elle n’implique pas que le même modèle accepte /openai/responses/compact, WebSocket ou previous_response_id avec état.
• Les cinq modèles GPT ci-dessus n’ont actuellement aucun canal Compact vérifié. Les requêtes Compact sont rejetées avant facturation sans canal explicitement activé. Responses ordinaire et Responses WebSocket restent disponibles.

Exemples de requêtes

Les exemples ci-dessous fournissent input. Une continuation peut omettre input lorsqu’elle fournit un previous_response_id valide et que le canal choisi prend en charge les continuations avec état. Un ID de réponse n’active pas cette capacité sur un canal non compatible. Les résultats d’outils restent des éléments d’entrée valides, y compris function_call_output.

Texte

{
  "model": "gpt-5.4",
  "input": "Hello, introduce yourself in one sentence."
}

Paramètres au style Codex CLI

{
  "model": "gpt-5.5",
  "input": "Reply with READY only.",
  "reasoning": {
    "effort": "xhigh"
  },
  "store": false,
  "text": {
    "verbosity": "low"
  },
  "stream": true
}

Compréhension d’images

{
  "model": "gpt-5.4",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "What is in this image?"
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/cat.png",
          "detail": "high"
        }
      ]
    }
  ]
}

Entrée de fichiers

Utilisez file_data et filename pour envoyer un PDF. file_data doit être une URL de données complète.

{
  "model": "gpt-5.4",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Summarize the key points in this PDF."
        },
        {
          "type": "input_file",
          "file_data": "data:application/pdf;base64,JVBERi0xLjQKJc...",
          "filename": "report.pdf"
        }
      ]
    }
  ]
}

Entrée d’images et de fichiers

{
  "model": "gpt-5.4",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Give three conclusions based on the image and attachment."
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/chart.png",
          "detail": "high"
        },
        {
          "type": "input_file",
          "file_data": "data:application/pdf;base64,JVBERi0xLjQKJc...",
          "filename": "notes.pdf"
        }
      ]
    }
  ]
}

Sortie en streaming

{
  "model": "gpt-5.4",
  "stream": true,
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Explain this diagram step by step."
        },
        {
          "type": "input_image",
          "image_url": "https://example.com/diagram.png"
        }
      ]
    }
  ]
}

Réponse

Les réponses sans streaming suivent le format OpenAI Responses. Les champs réels peuvent varier selon les capacités du modèle choisi.

Exemple réussi

{
  "id": "resp_123",
  "object": "response",
  "created_at": 1766534400,
  "model": "gpt-5.4",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "text": "The image shows a cat, and the attachment is a document about pet care."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 128,
    "output_tokens": 42,
    "total_tokens": 170
  }
}

Réponse en streaming

Avec stream=true, l’endpoint renvoie des événements envoyés par le serveur (SSE).

event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"The image"}

event: response.completed
data: {"type":"response.completed","response":{"id":"resp_123"}}

Lisez les événements jusqu’à response.completed ou la fermeture de la connexion.

Réponse d’erreur

Consultez Codes d’erreur et dépannage pour la référence complète des codes, les différences de protocole et les étapes de diagnostic.

Les erreurs HTTP générées par la plateforme utilisent les champs plats ci-dessous plutôt qu’une enveloppe error. Certaines erreurs fournisseur peuvent conserver leur structure d’origine ; les erreurs dans un flux SSE déjà commencé ne suivent pas cet exemple de réponse HTTP.

{
  "code": 40000,
  "message": "Insufficient credit. Required: 30000, Available: 20000",
  "type": "api_error"
}

Remarques

• L’endpoint Responses utilise input, pas messages. Si votre client envoie uniquement messages, utilisez /openai/v1/chat/completions.
• L’entrée d’image utilise input_image ; image_url doit être une URL publique http:// ou https://. Les URL de données Base64 ne sont pas acceptées pour les images.
• L’entrée de fichier utilise input_file. Pour les PDF, utilisez file_data et filename ; file_data doit être une URL complète data:application/pdf;base64,....
• Les entrées/sorties audio, outils de génération d’images, recherche de fichiers et autres capacités avancées dépendent du modèle choisi et des fonctions disponibles.
• Les champs de cette page constituent le contrat public actuel des requêtes Responses ; ne supposez pas que des champs non listés sont disponibles.
• /openai/responses est le chemin public recommandé.
• /v1/responses suit le même contrat public de requête et de réponse.
• /compat/v1/responses suit le même contrat public de requête et de réponse.
• /openai/v1/responses suit le même contrat public de requête et de réponse.