Skip to main content
OpenAI ha recentemente fornito un’interfaccia per creare risposte dai modelli. Fornisci input di testo o immagine per generare output di testo o immagine. Consenti al modello di chiamare il tuo codice personalizzato o di utilizzare strumenti integrati, come la ricerca web o la ricerca di file, per utilizzare i tuoi dati come input per le risposte del modello. Questo documento descrive principalmente il processo di utilizzo dell’API OpenAI Responses, che ci consente di utilizzare facilmente la funzionalità di creazione di risposte dai modelli ufficiali di OpenAI.

Processo di richiesta

Per utilizzare l’API OpenAI Responses, prima vai al Pannello di controllo di Ace Data Cloud per ottenere il tuo token API, da conservare per uso futuro. Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere; una volta completato, verrai riportato automaticamente alla pagina corrente. Un token API è sufficiente per chiamare tutti i servizi della piattaforma, senza dover richiedere separatamente per ogni servizio. La prima richiesta ti darà un credito gratuito, che puoi utilizzare per un’esperienza gratuita; quando il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: OpenAI Responses API →

Utilizzo di base

Ora puoi compilare i contenuti corrispondenti nell’interfaccia, come mostrato nell’immagine:

Quando utilizzi questa interfaccia per la prima volta, devi compilare almeno tre contenuti: uno è authorization, che puoi selezionare direttamente dal menu a discesa. Un altro parametro è model, model è la categoria del modello che scegli di utilizzare dal sito ufficiale di OpenAI ChatGPT; qui abbiamo principalmente 20 modelli, i dettagli possono essere consultati nei modelli forniti. L’ultimo parametro è input, input è un array di domande che inseriamo, rappresenta un array che consente di caricare più domande contemporaneamente, ogni domanda contiene role e content, dove role indica il ruolo del richiedente; abbiamo fornito tre identità: user, assistant, system. L’altro content è il contenuto specifico della nostra domanda. Puoi anche notare che a destra c’è il codice di chiamata corrispondente generato, puoi copiare il codice e eseguirlo direttamente, oppure puoi semplicemente fare clic sul pulsante “Prova” per testare. Parametri opzionali comuni:
  • max_tokens: limita il numero massimo di token per una singola risposta.
  • temperature: genera casualità, tra 0-2, valori più alti portano a maggiore dispersione.
  • n: quante risposte candidate generare in una volta.
  • response_format: impostazione del formato di ritorno.
  • tools: definizione delle chiamate a funzioni/strumenti.
  • background: se eseguire in modo asincrono in background.

Dopo la chiamata, scopriamo che il risultato restituito è il seguente:
Il risultato restituito ha diversi campi, descritti come segue:
  • id, l’ID generato per questo compito di dialogo, utilizzato per identificare univocamente questo compito di dialogo.
  • model, il modello scelto dal sito ufficiale di OpenAI ChatGPT.
  • output, le informazioni di risposta fornite da ChatGPT per la domanda.
  • usage: informazioni statistiche sui token per questa domanda e risposta.
Tra cui output contiene le informazioni di risposta di ChatGPT, all’interno di output è presente la risposta di ChatGPT, come mostrato nell’immagine.

Puoi vedere che il campo content all’interno di output contiene il contenuto specifico della risposta di ChatGPT.

Risposta in streaming

Questa interfaccia supporta anche le risposte in streaming, il che è molto utile per l’integrazione web, consentendo di visualizzare il contenuto parola per parola. Se desideri restituire una risposta in streaming, puoi modificare il parametro stream nell’intestazione della richiesta, impostandolo su true. Modifica come mostrato nell’immagine, ma il codice di chiamata deve avere le modifiche corrispondenti per supportare le risposte in streaming.

Dopo aver modificato stream in true, l’API restituirà i dati JSON riga per riga; a livello di codice, dobbiamo apportare le modifiche necessarie per ottenere i risultati riga per riga. Esempio di codice di chiamata in Python:
L’output appare come segue:
Si può vedere che nella risposta ci sono molti data, e data contiene il delta che è il contenuto della risposta più recente, coerente con quanto descritto in precedenza. Il delta è il contenuto della risposta aggiunto, e puoi integrarlo nel tuo sistema in base ai risultati. Inoltre, la fine della risposta in streaming è determinata dal contenuto di data; se il contenuto di type è response.completed, significa che la risposta in streaming è completamente terminata. I risultati di data restituiti contengono diversi campi, descritti di seguito:
  • item_id, l’ID generato per questo compito di dialogo, utilizzato per identificare univocamente questo compito di dialogo.
  • type, il tipo di compito di generazione delle risposte.
  • model, il modello scelto dal sito ufficiale di OpenAI ChatGPT.
  • delta, le informazioni di risposta fornite da ChatGPT in base alla domanda.
JavaScript è supportato, ad esempio, il codice per la chiamata in streaming di Node.js è il seguente:
Esempio di codice Java:
Altri linguaggi possono essere riscritti separatamente, il principio è lo stesso.

Conversazione a più turni

Se desideri integrare la funzionalità di conversazione a più turni, devi caricare più domande nel campo input, un esempio specifico di più domande è mostrato nell’immagine sottostante:

Esempio di codice Python per la chiamata:
Caricando più domande, puoi facilmente realizzare una conversazione a più turni e ottenere la seguente risposta:
Si può vedere che le informazioni contenute in output sono coerenti con il contenuto di utilizzo di base, che include il contenuto specifico della risposta di ChatGPT a più conversazioni, in modo da poter rispondere alle domande corrispondenti in base ai contenuti di più conversazioni.

Modello visivo

gpt-4o è un grande modello linguistico multimodale sviluppato da OpenAI, che ha aggiunto capacità di comprensione visiva sulla base di GPT-4. Questo modello può gestire simultaneamente input di testo e immagini, realizzando una comprensione e generazione multimodale. L’elaborazione del testo utilizzando il modello gpt-4o è coerente con il contenuto di utilizzo di base descritto in precedenza; di seguito verrà brevemente introdotto come utilizzare la capacità di elaborazione delle immagini del modello. L’uso della capacità di elaborazione delle immagini del modello gpt-4o avviene principalmente aggiungendo un campo type al contenuto originale content, attraverso il quale è possibile sapere se ciò che viene caricato è testo o immagine, in modo da utilizzare la capacità di elaborazione delle immagini del modello gpt-4o. Di seguito si parlerà principalmente di come chiamare questa funzionalità utilizzando Curl e Python.
  • Metodo dello script Curl
  • Metodo dello script Python
Poi si può ottenere il seguente risultato, le informazioni dei campi nel risultato sono coerenti con quelle sopra, nello specifico come segue:
Si può vedere che il contenuto della risposta è basato sull’immagine, quindi attraverso i due metodi sopra si può facilmente utilizzare la capacità di elaborazione di testo e immagini del modello gpt-4.1. Oltre a gpt-4.1, c’è un modello a costo inferiore, chiamato gpt-4o-mini. gpt-4o-mini è l’ultima generazione di modelli di linguaggio di grandi dimensioni sviluppati da OpenAI, che non solo ha una velocità di risposta rapida, ma è anche più economico e supporta il multimodale. L’uso della funzione vision può fare riferimento al contenuto dell’uso del modello gpt-4.1 sopra.

Creazione del modello di elaborazione dei file

Esempio di richiesta:
Esempio di risultato: