Ansökningsprocess
För att använda OpenAI Images Generations API kan du först gå till OpenAI Images Generations API sidan och klicka på “Acquire”-knappen för att få de nödvändiga autentiseringsuppgifterna:
Om du inte är inloggad eller registrerad kommer du automatiskt att omdirigeras till inloggningssidan där du blir inbjuden att registrera dig och logga in. Efter att du har loggat in eller registrerat dig kommer du automatiskt att återvända till den aktuella sidan.
Vid första ansökan kommer du att få en gratis kvot som gör att du kan använda API:et kostnadsfritt.
Grundläggande Användning
Därefter kan du fylla i motsvarande innehåll på gränssnittet, som visas i bilden:
authorization, som du enkelt kan välja från rullgardinsmenyn. Den andra parametern är model, där model är den modelltyp vi väljer att använda från OpenAI DALL-E:s officiella webbplats. Här har vi huvudsakligen 1 typ av modell, detaljer kan ses i de modeller vi tillhandahåller. Den sista parametern är prompt, där prompt är den text vi anger för att generera bilden.
Samtidigt kan du notera att det finns motsvarande kod för anrop på höger sida, som du kan kopiera och köra direkt, eller så kan du klicka på “Try”-knappen för att testa.
created, ID för den genererade bilden, som används för att unikt identifiera denna uppgift.data, som innehåller information om bildgenereringen.
data innehåller den specifika informationen om den bild som modellen har genererat, där url är länken till den genererade bilden, som kan ses i bilden nedan.
Bildkvalitetsparameter quality
Nästa steg är att beskriva hur man ställer in några detaljerade parametrar för bildgenereringsresultatet, där bildkvalitetsparametern quality innehåller två alternativ, den första standard som representerar en standardbild, och den andra hd som innebär att den skapade bilden har mer detaljer och större konsekvens.
Nedan ställer vi in bildkvalitetsparametern till standard, med specifikationen som visas i bilden:
standard ser ut som bilden nedan:
hd, vilket ger oss bilden som visas nedan:
hd-bilden har mer detaljer och större konsekvens än standard-bilden.
Bildstorleksparameter size
Vi kan också ställa in storleken på de genererade bilderna, vi kan göra följande inställningar.
Nedan ställer vi in storleken på bilden till 1024 * 1024, specifika inställningar visas i bilden nedan:
1024 * 1024, som visas i bilden nedan:
1792 * 1024, så kan vi få bilden som visas nedan:
Vi kan se att storleken på bilden är tydligt annorlunda, och vi kan också ställa in fler storlekar, för mer information, se vår officiella dokumentation.
Bildstilparameter style
Bildstilparameter style innehåller två parametrar, den första vivid innebär att den genererade bilden är mer livfull, den andra natural innebär att den genererade bilden är mer naturlig.
Nedan ställer vi in bildstilparameter till vivid, specifika inställningar visas i bilden nedan:
vivid, den genererade bilden visas nedan:
natural, så kan vi få bilden som visas nedan:
vivid genererar bilder som är mer livfulla och verklighetstrogna än natural.
Bildlänkens formatparameter response_format
Den sista bildlänkens formatparameter response_format har också två alternativ, den första b64_json är en Base64-kodning av bildlänken, den andra url är en vanlig bildlänk som kan ses direkt.
Nedan ställer vi in bildlänkens formatparameter till url, specifika inställningar visas i bilden nedan:
url 的生成图片的链接为 图片 URL 这是可以直接访问的，图片内容如下图所示：
b64_json ，可以得到结果 Base64 编码后的图片链接，具体结果如下图所示：
Asynkron återkoppling
Eftersom OpenAI Images Generations API:s bildgenerering kan ta relativt lång tid, om API:n inte svarar under en längre tid, kommer HTTP-förfrågan att hålla anslutningen öppen, vilket leder till extra systemresursförbrukning, så detta API erbjuder också stöd för asynkron återkoppling. Den övergripande processen är: när klienten initierar en begäran, specificerar den dessutom ettcallback_url-fält, efter att klienten har initierat API-förfrågan kommer API:n omedelbart att returnera ett resultat som innehåller ett task_id-fält, vilket representerar det aktuella uppdragets ID. När uppdraget är slutfört kommer resultatet av den genererade bilden att skickas till klientens angivna callback_url i POST JSON-format, vilket också inkluderar task_id-fältet, så att uppdragets resultat kan kopplas ihop med ID:t.
Nedan går vi igenom ett exempel för att förstå hur man gör.
Först är Webhook-återkoppling en tjänst som kan ta emot HTTP-förfrågningar, utvecklaren bör ersätta med URL:en till sin egen byggda HTTP-server. Här för att underlätta demonstration använder vi en offentlig Webhook-exempelsida https://webhook.site/, öppna denna webbplats för att få en Webhook-URL, som visas i bilden:
Kopiera denna URL, så kan den användas som Webhook, detta exempel är https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab.
Därefter kan vi ställa in fältet callback_url till ovanstående Webhook-URL, samtidigt som vi fyller i motsvarande parametrar, som i följande kod:
task_id-fält, data-fältet innehåller samma bildgenereringsresultat som vid synkron anrop, genom task_id-fältet kan uppdraget kopplas ihop.
Felhantering
Vid anrop av API:t, om det uppstår fel, kommer API:t att returnera motsvarande felkod och information. Till exempel:400 token_mismatched: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.400 api_not_implemented: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.401 invalid_token: Obefogad, ogiltig eller saknad auktoriseringstoken.429 too_many_requests: För många förfrågningar, du har överskridit hastighetsgränsen.500 api_error: Intern serverfel, något gick fel på servern.