Risposte multimodali OpenAI

API Responses compatibile con OpenAI. Questo endpoint usa input nello stile OpenAI e supporta testo, URL pubblici di immagini, input PDF, chiamate agli strumenti, opzioni di ragionamento e parametri di streaming.

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

Autenticazione

Tutte le richieste richiedono l’autenticazione con token Bearer.

Authorization: Bearer YOUR_API_KEY

Corpo della richiesta

Differenze tra parametri dei modelli

• L’inoltro Responses nativo compatibile con OpenAI conserva top_p nella richiesta al fornitore; validazione e comportamento di campionamento dipendono dal modello e dal fornitore scelti. Le verifiche del 2026-09-26 hanno accettato top_p: 0.9 per gpt-5.5, gpt-5.6-sol e gpt-5.6-terra. Accettazione e inoltro non dimostrano un effetto sul campionamento né garantiscono supporto per altri valori, modelli o richieste future. Inizia con una richiesta minima.
• Il supporto descritto qui vale solo per l’endpoint normale /openai/responses. Non implica che lo stesso modello supporti /openai/responses/compact, WebSocket o previous_response_id con stato.
• I cinque modelli GPT elencati sopra non hanno attualmente un canale Compact verificato. Le richieste Compact vengono rifiutate prima della fatturazione se non è disponibile un canale esplicitamente abilitato. Responses ordinario e Responses WebSocket restano disponibili.

Esempi di richiesta

Gli esempi seguenti forniscono input. Una continuazione può omettere input se fornisce un previous_response_id valido e il canale scelto supporta la continuazione con stato. Un ID di risposta non abilita questa capacità su un canale non supportato. I risultati degli strumenti restano elementi di input validi, incluso function_call_output.

Testo

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

Parametri nello stile Codex CLI

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

Comprensione delle immagini

{
  "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"
        }
      ]
    }
  ]
}

Input di file

Usa file_data insieme a filename per inviare contenuto PDF. file_data deve essere un URL dati completo.

{
  "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"
        }
      ]
    }
  ]
}

Input di immagini e file

{
  "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"
        }
      ]
    }
  ]
}

Output in 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"
        }
      ]
    }
  ]
}

Risposta

Le risposte senza streaming seguono lo stile OpenAI Responses. I campi effettivi possono variare secondo le capacità del modello scelto.

Esempio di successo

{
  "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
  }
}

Risposta in streaming

Quando stream=true, l’endpoint restituisce Server-Sent Events.

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"}}

Leggi gli eventi fino a response.completed o alla chiusura della connessione.

Risposta di errore

Consulta Codici di errore e risoluzione dei problemi per il riferimento completo, le differenze tra protocolli e i passaggi diagnostici.

Gli errori HTTP generati dalla piattaforma usano i campi piatti seguenti invece di un involucro error. Alcuni errori del fornitore possono conservare la struttura originale; gli errori in uno stream SSE già avviato non seguono questo esempio di risposta HTTP.

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

Note

• L’endpoint Responses usa input, non messages. Se il client invia solo messages, usa /openai/v1/chat/completions.
• L’input immagine usa input_image; image_url deve essere un URL pubblico http:// o https://. Gli URL dati Base64 non sono supportati per le immagini.
• L’input di file usa input_file. Per i PDF usa file_data e filename; file_data dovrebbe essere un URL data:application/pdf;base64,... completo.
• Input/output audio, strumenti di generazione di immagini, ricerca di file e altre capacità avanzate dipendono dal modello scelto e dalle funzionalità disponibili.
• I campi elencati qui costituiscono l’attuale contratto pubblico delle richieste Responses; non presumere che i campi non elencati siano disponibili.
• /openai/responses è il percorso pubblico consigliato.
• /v1/responses segue lo stesso contratto pubblico di richiesta e risposta.
• /compat/v1/responses segue lo stesso contratto pubblico di richiesta e risposta.
• /openai/v1/responses segue lo stesso contratto pubblico di richiesta e risposta.