Skip to main content
Denna artikel kommer att introducera en Flux Images Generation API integrationsbeskrivning, som kan generera Flux officiella bilder genom att ange anpassade parametrar.

​
Ansökningsprocess

För att använda Flux Images Generation API, börja med att gå till Ace Data Cloud-konsolen för att hämta din API-token, som du ska spara. Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan som bjuder in dig att registrera dig och logga in, och efter att du har slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token räcker för att anropa alla tjänster på plattformen, du behöver inte ansöka separat för varje tjänst. Första ansökan ger en gratis kvot, så att du kan prova gratis; när kvoten är otillräcklig kan du ladda på allmän balans i konsolen.
📘 Fullständig dokumentation: Flux Images Generation API →

​
Grundläggande användning

Först bör du förstå den grundläggande användningen, vilket innebär att du anger en prompt prompt, en åtgärd action, och bildstorlek size, för att få det bearbetade resultatet. Först behöver du enkelt skicka ett action-fält, vars värde är generate, och sedan behöver vi också ange en prompt, den specifika informationen är som följer:

Här kan vi se att vi har ställt in Request Headers, inklusive:
  • accept: vilken typ av format du vill ta emot som svar, här anges application/json, det vill säga JSON-format.
  • authorization: nyckeln för att anropa API:et, efter ansökan kan du direkt välja från en rullgardinsmeny.
Dessutom har vi ställt in Request Body, inklusive:
  • action: åtgärden för denna bildgenereringsuppgift.
  • size: storleken på bildgenereringsresultatet. flux-2-flex / flux-2-pro / flux-2-max-serien måste ange bildförhållande (t.ex. 1:1, 16:9), pixelstorlekar som 1024x1024 accepteras inte, och om det utelämnas returneras 400.
  • count: antalet bilder som ska genereras, standardvärdet är 1, detta parameter är endast giltigt för bildgenereringsuppgifter, inte för redigeringsuppgifter.
  • prompt: prompten.
  • model: genereringsmodellen, standard flux-dev; den senaste flaggskeppsmodellen är flux-2-pro, flux-2-max (högre bildkvalitet, måste kombineras med bildförhållande size).
  • callback_url: URL:en för att få tillbaka resultatet.
  • async: valfritt, om det sätts till true returnerar gränssnittet omedelbart task_id, utan att behöva ange callback_url, och sedan kan du använda motsvarande uppgiftsfrågegränssnitt för att hämta resultatet.
Parametern size har vissa speciella begränsningar, som huvudsakligen delas in i width x height bildförhållande och x:y bildförhållande, specifikt som följer: Referensbildförhållanden: “21:9”, “16:9”, “4:3”, “3:2”, “1:1”, “2:3”, “3:4”, “9:16”, “9:21”. När parametrarna har valts kommer motsvarande kod att genereras automatiskt till höger. Kontrollera att auktoriseringshuvudet använder din egen API-nyckel innan du kopierar, dokument och skärmdumpar bör inte innehålla verkliga referenser. Klicka på “Try” knappen för att testa, här fick vi följande resultat:
Det returnerade resultatet har flera fält, som beskrivs nedan:
  • success, statusen för videogenereringsuppgiften.
  • task_id, ID för videogenereringsuppgiften.
  • trace_id, spårnings-ID för videogenereringen.
  • data, resultatlistan för bildgenereringsuppgiften.
    • image_url, länken till bildgenereringsuppgiften.
    • prompt, prompten.
Vi kan se att vi har fått tillfredsställande bildinformation, vi behöver bara hämta den genererade Flux-bilden baserat på bildlänken i data. Om du vill generera motsvarande integrationskod kan du direkt kopiera den, till exempel CURL-koden är som följer:

​
Redigera bilduppgift

Om du vill redigera en viss bild, måste parametern image_url ange länken till den bild som ska redigeras, vid denna tidpunkt stöder action endast edit, och du kan specificera följande innehåll:
  • model: modellen som används för denna redigeringsuppgift, stöder flux-dev, flux-pro, flux-kontext-pro, flux-kontext-max, flux-2-flex, flux-2-pro, flux-2-max.
  • image_url: länken till bilden som ska redigeras.
Exempel på ifyllning är som följer:

När du har fyllt i det kommer koden att genereras automatiskt som följer:

Motsvarande kod:
Klicka på kör, och du kan se att du omedelbart får ett resultat, som följer:
Det kan ses att den genererade effekten är en redigering av den ursprungliga bilden, och resultatet liknar det som nämndes ovan.

​
Asynkron återkoppling

Eftersom Flux Images Generation API:s genereringstid är relativt lång, cirka 1-2 minuter, om API:t inte svarar under en längre tid, kommer HTTP-förfrågan att hålla anslutningen öppen, vilket leder till extra systemresursförbrukning. Därför erbjuder detta API också stöd för asynkron återkoppling. Den övergripande processen är: När klienten initierar en begäran, specificeras ett extra callback_url-fält. Efter att klienten har initierat API-förfrågan kommer API:t 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 uppdragsresultatet kan kopplas ihop med ID:t. Nedan går vi igenom ett exempel för att förstå hur man gör detta. Först är Webhook-återkopplingen 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, exemplet här ä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, det specifika innehållet visas i bilden:

Klicka på kör, och du kan se att ett resultat omedelbart erhålls, som följer:
Vänta en stund, så kan vi observera resultatet av den genererade bilden på https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab, som visas i bilden: Innehållet är som följer:
Det kan ses att resultatet innehåller ett task_id-fält, och de andra fälten liknar de som nämndes ovan, genom detta fält kan uppdraget kopplas ihop.

​
Felhantering

Vid anrop av API:t, om ett fel uppstår, kommer API:t att returnera motsvarande felkod och information. Till exempel:
  • 400 token_mismatched: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 401 invalid_token: Obehörig, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många förfrågningar, du har överskridit hastighetsgränsen.
  • 500 api_error: Internt serverfel, något gick fel på servern.

​
Exempel på felrespons

​
Slutsats

Genom detta dokument har du fått en förståelse för hur man använder Flux Images Generation API för att generera bilder genom att ange ledande ord. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda detta API. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.