Skip to main content
Il servizio di vettori di parole di OpenAI è utilizzato per generare risultati di vettori di parole che rappresentano il testo di input. Questo documento descrive principalmente il processo di utilizzo dell’API OpenAI Embeddings, grazie al quale possiamo creare vettori di embedding che rappresentano il testo di input.

Processo di richiesta

Per utilizzare l’API OpenAI Embeddings, prima di tutto vai al Pannello di controllo di Ace Data Cloud per ottenere il tuo API Token, 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 API Token è sufficiente per accedere a tutti i servizi della piattaforma, senza dover richiedere separatamente per ogni servizio. La prima richiesta ti darà un credito gratuito, per un’esperienza senza costi; se il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: OpenAI Embeddings API →

Utilizzo di base

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

Quando utilizzi per la prima volta questa interfaccia, 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; qui abbiamo principalmente 3 modelli, i dettagli possono essere consultati nei modelli forniti. L’ultimo parametro è input, input è il testo del vettore di parole che desideriamo convertire. Puoi anche notare che a destra c’è un codice di chiamata corrispondente generato, puoi copiare il codice e eseguirlo direttamente, oppure puoi semplicemente cliccare sul pulsante “Try” per testarlo. Parametri opzionali:
  • dimensions: ridimensiona la dimensione del vettore, l’output predefinito è la dimensione completa.
  • encoding_format: formato di ritorno, opzioni float o base64.

Esempio di codice di chiamata in Python:
Dopo la chiamata, abbiamo trovato il risultato di ritorno come segue:
Il risultato di ritorno ha diversi campi, descritti come segue:
  • model, il modello utilizzato per convertire il testo in vettori di parole.
  • usage, le informazioni sui token utilizzati per convertire il testo in vettori di parole.
  • data, il risultato dei vettori di parole dopo la conversione del testo.
Dove data contiene le informazioni specifiche sui vettori di parole corrispondenti al testo, e embedding è il risultato specifico dei vettori di parole generati.

Gestione degli errori

Quando chiami l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
  • 400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
  • 429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.
  • 500 api_error: Errore interno del server, qualcosa è andato storto sul server.

Esempio di risposta di errore

Conclusione

Attraverso questo documento, hai appreso come utilizzare facilmente l’API OpenAI Embeddings per generare vettori di parole ufficiali di OpenAI. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.