Processo di richiesta
Per utilizzare l’API OpenAI Images Generations, puoi prima andare alla pagina OpenAI Images Generations API e cliccare sul pulsante “Acquire” per ottenere le credenziali necessarie per la richiesta:
Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di accesso che ti invita a registrarti e accedere; dopo aver effettuato il login o la registrazione, verrai automaticamente riportato alla pagina corrente.
Alla prima richiesta, verrà fornito un credito gratuito, che ti consente di utilizzare gratuitamente questa API.
Utilizzo di base
Successivamente, puoi compilare i contenuti corrispondenti nell’interfaccia, come mostrato nell’immagine:
authorization, che puoi selezionare direttamente dal menu a discesa. Un altro parametro è model, model è la categoria del modello di OpenAI DALL-E che scegli di utilizzare; qui abbiamo principalmente 1 tipo di modello, i dettagli possono essere consultati nei modelli forniti. L’ultimo parametro è prompt, prompt è la parola chiave che inseriamo per generare l’immagine.
Puoi anche notare che a destra c’è il codice di chiamata corrispondente generato, puoi copiare il codice e eseguirlo direttamente, oppure cliccare direttamente sul pulsante “Try” per testare.
created, l’ID generato per questa generazione di immagini, utilizzato per identificare univocamente questo compito.data, contiene le informazioni sui risultati della generazione dell’immagine.
data contiene le informazioni specifiche sull’immagine generata dal modello, il cui url è il link ai dettagli dell’immagine generata, come mostrato nell’immagine.
Parametro di qualità dell’immagine quality
Successivamente, verrà descritto come impostare alcuni parametri dettagliati per i risultati della generazione dell’immagine, tra cui il parametro di qualità dell’immagine quality, che include due opzioni: la prima standard indica che l’immagine generata è standard, l’altra hd indica che l’immagine creata ha dettagli più fini e maggiore coerenza.
Impostiamo il parametro di qualità dell’immagine su standard, le impostazioni specifiche sono mostrate nell’immagine seguente:
standard è mostrata nell’immagine seguente:
hd, e puoi ottenere l’immagine mostrata nell’immagine seguente:
hd ha dettagli più fini e maggiore coerenza rispetto a quella generata con standard.
Parametro delle dimensioni dell’immagine size
Possiamo anche impostare le dimensioni delle immagini generate, possiamo effettuare le seguenti impostazioni.
Impostiamo le dimensioni dell’immagine a 1024 * 1024, le impostazioni specifiche sono mostrate nell’immagine sottostante:
1024 * 1024, come mostrato nell’immagine sottostante:
1792 * 1024, e possiamo ottenere l’immagine mostrata qui sotto:
Possiamo vedere che le dimensioni dell’immagine sono chiaramente diverse, inoltre è possibile impostare ulteriori dimensioni, per maggiori dettagli fare riferimento alla nostra documentazione ufficiale.
Parametro di stile dell’immagine style
Il parametro di stile dell’immagine style contiene due parametri, il primo vivid indica che l’immagine generata è più vivace, l’altro natural indica che l’immagine generata è più naturale.
Impostiamo il parametro di stile dell’immagine a vivid, le impostazioni specifiche sono mostrate nell’immagine sottostante:
vivid è mostrata nell’immagine sottostante:
natural, e possiamo ottenere l’immagine mostrata qui sotto:
vivid genera immagini più vivaci e realistiche rispetto a natural.
Parametro di formato del link dell’immagine response_format
L’ultimo parametro di formato del link dell’immagine response_format ha anche due opzioni, la prima b64_json è la codifica Base64 del link dell’immagine, l’altra url è il normale link dell’immagine, che può essere visualizzato direttamente.
Impostiamo il parametro di formato del link dell’immagine a url, le impostazioni specifiche sono mostrate nell’immagine sottostante:
url, il link dell’immagine generata è Immagine URL questo è accessibile direttamente, il contenuto dell’immagine è mostrato qui sotto:
b64_json, il risultato specifico è mostrato qui sotto:
Callback asincrono
Poiché il tempo di generazione delle immagini dell’API OpenAI potrebbe essere relativamente lungo, se l’API non risponde per un lungo periodo, la richiesta HTTP manterrà la connessione, causando un consumo aggiuntivo di risorse di sistema, quindi questa API offre anche supporto per callback asincroni. Il flusso complessivo è: quando il client invia la richiesta, specifica un campocallback_url aggiuntivo, dopo che il client ha inviato la richiesta API, l’API restituirà immediatamente un risultato, contenente un campo task_id, che rappresenta l’ID del compito corrente. Quando il compito è completato, il risultato dell’immagine generata verrà inviato al callback_url specificato dal client in formato JSON POST, che include anche il campo task_id, in modo che il risultato del compito possa essere associato tramite l’ID.
Di seguito, vediamo un esempio per capire come operare concretamente.
Innanzitutto, il callback Webhook è un servizio in grado di ricevere richieste HTTP, gli sviluppatori dovrebbero sostituirlo con l’URL del server HTTP che hanno costruito. Qui, per comodità di dimostrazione, utilizziamo un sito Web pubblico di esempio per Webhook https://webhook.site/, aprendo questo sito si ottiene un URL Webhook, come mostrato nell’immagine:
Copia questo URL e puoi usarlo come Webhook, l’esempio qui è https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab.
Successivamente, possiamo impostare il campo callback_url su questo URL Webhook, insieme ai parametri corrispondenti, come mostrato nel seguente codice:
task_id, il campo data contiene i risultati della generazione dell’immagine come nella chiamata sincrona, tramite il campo task_id è possibile realizzare l’associazione del compito.
Gestione degli errori
Quando si chiama 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.