Usare l'API REST di OpenAI di Azure per usare i modelli DALL-E

Completato

È possibile usare l'API REST del servizio OpenAI di Azure per usare i modelli DALL-E dalle applicazioni.

Per eseguire una chiamata REST al servizio, è necessario conoscere l'endpoint e la chiave di autorizzazione per la risorsa del Servizio OpenAI di Azure di cui è stato effettuato il provisioning in Azure. Il processo di generazione dell'immagine inizia con l'invio di una richiesta POST all'endpoint del servizio con la chiave di autorizzazione nell'intestazione. La richiesta deve contenere i parametri seguenti in un corpo JSON:

• prompt: descrizione dell'immagine da generare.
• n: numero di immagini da generare. DALL-E 3 supporta solo n=1.
• size: risoluzione delle immagini da generare (1024x1024, 1792x1024 o 1024x1792).
• quality Facoltativo: qualità dell'immagine (standard o hd). Il valore predefinito è standard.
• style Facoltativo: stile visivo dell'immagine (naturale o vivido). Il valore predefinito è vivido.

Ad esempio, è possibile usare il codice JSON seguente per generare un'immagine 512 x 512 di un tasso che indossa uno smoking:

{
    "prompt": "A badger wearing a tuxedo",
    "n": 1,
    "size": "512x512",
    "quality": "hd", 
    "style": "vivid"
}

Se si usa un modello di generazione precedente, ad esempio DALL-E 2, la richiesta iniziale non restituisce immediatamente i risultati del processo di generazione dell'immagine. La risposta include invece un'intestazione operation-location con un URL per un servizio di callback di cui il codice dell'applicazione può eseguire il polling fino a quando non sono pronti i risultati della generazione di immagini.

Con DALL-E 3, il risultato della richiesta viene elaborato in modo sincrono con la risposta contenente l'URL per l'immagine generata. La risposta restituita è simile al codice JSON seguente:

{
    "created": 1686780744,
    "data": [
        {
            "url": "<URL of generated image>",
            "revised_prompt": "<prompt that was used>"
        }
    ]
}

L'elemento dati include il valore url , che fa riferimento a un file di immagine PNG generato dal prompt che è quindi possibile visualizzare o scaricare. La risposta contiene anche una richiesta modificata usata per generare l'immagine, che è stata aggiornata dal sistema per ottenere i risultati più auspicabili. In questo esempio l'immagine potrebbe essere simile all'immagine seguente: