Integrering och användning av Flux Tasks API

Huvudfunktionen för Flux Tasks API är att fråga om exekveringsstatusen för en uppgift genom att ange det uppgifts-ID som returneras av Flux Images Generation API eller Flux Videos API. Detta dokument kommer att introducera integrationsanvisningarna för Flux Tasks API i detalj, för att hjälpa dig att enkelt integrera och fullt ut nyttja detta API:s kraftfulla funktioner. Genom Flux Tasks API kan du enkelt fråga om uppgiftsexekveringsstatusen för Flux Images Generation API. Se Integreringsguide för Flux Videos API för ett komplett exempel på videoinlämning och polling. Ingen ytterligare genereringsavgift tas ut för att fråga om befintliga uppgifter.

Ansökningsprocess

För att använda Flux Images Generation API ska du först hämta din API-token från Ace Data Cloud-konsolen och spara den för senare användning.

Om du ännu inte har loggat in eller registrerat dig omdirigeras du automatiskt till inloggningssidan där du uppmanas att registrera dig och logga in. När det är klart återgår du automatiskt till den aktuella sidan. En API-token kan anropa alla plattformens tjänster, utan att du behöver ansöka separat för varje tjänst. Vid den första ansökan får du gratis kredit som du kan använda för att prova tjänsten kostnadsfritt; när krediten är otillräcklig kan du fylla på det gemensamma saldot i konsolen.

📘 Fullständig dokumentation: Flux Images Generation API →

Begäransexempel

Flux Tasks API kan användas för att fråga om resultat från Flux Images Generation API. För information om hur du använder Flux Images Generation API, se dokumentationen Flux Images Generation API. Vi använder ett uppgifts-ID som returneras av tjänsten Flux Images Generation API som exempel för att visa hur detta API används. Anta att vi har ett uppgifts-ID: 2db0168c-2373-4367-8d9a-9dc778802e8a, därefter visar vi hur man genom att ange ett uppgifts-ID.

Exempelbild för uppgift

Ange begäranderubrik och begärandetext

Request Headers inkluderar:

accept: Anger att svar i JSON-format ska tas emot, fyll i application/json här.
authorization: Nyckeln för att anropa API:t, som kan väljas direkt från rullgardinsmenyn efter ansökan.

Request Body inkluderar:

id: Det uppladdade uppgifts-ID:t.
action: Åtgärden som ska utföras på uppgiften.

Inställningarna visas i bilden nedan:

Kodexempel

Du kan se att kod på olika språk redan har genererats automatiskt på höger sida av sidan, som visas i bilden:

Några kodexempel följer:

CURL

curl -X POST 'https://api.acedata.cloud/flux/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "2c454ff3-4f8f-47f0-8147-acb29a84d1c2",
  "action": "retrieve"
}'

Python

import requests

url = "https://api.acedata.cloud/flux/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "2c454ff3-4f8f-47f0-8147-acb29a84d1c2",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Svarsexempel

Efter att begäran har lyckats returnerar API:t detaljinformation om bilduppgiften här. Till exempel:

{
  "_id": "677de81d550a4144a5f4cf62",
  "id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
  "api_id": "deefc5d7-7f22-43e9-929e-f2b6afee60b7",
  "application_id": "001c2f84-2a4a-4c4d-ba3f-8a89f43b5be2",
  "created_at": 1736304669.779,
  "started_at": 1736304669.839,
  "finished_at": 1736304679.439,
  "elapsed": 9.6,
  "credential_id": "b00bddd3-140f-4343-a9a2-affb312b60de",
  "request": {
    "action": "generate",
    "size": "1024x1024",
    "prompt": "a white siamese cat"
  },
  "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "response": {
    "success": true,
    "task_id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
    "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
    "data": [
      {
        "prompt": "a white siamese cat",
        "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
        "seed": 281520112,
        "timings": {
          "inference": 3.193
        }
      }
    ]
  }
}

Det returnerade resultatet innehåller flera fält. Fältet request är request body när uppgiften startas, medan fältet response är response body som returneras efter att uppgiften har slutförts. Fältbeskrivningarna är följande.

id, ID:t för denna bildgenereringsuppgift, används för att unikt identifiera denna bildgenereringsuppgift.
request, begärandeinformationen i frågan om bilduppgiften.
response, returinformationen i frågan om bilduppgiften.
created_at, tidpunkten då uppgiften skapades, Unix-tidsstämpel (sekunder, flyttal).
started_at, tidpunkten då uppgiften började köras, Unix-tidsstämpel (sekunder, flyttal).
finished_at, tidpunkten då uppgiften slutfördes, Unix-tidsstämpel (sekunder, flyttal). Detta fält returneras inte när uppgiften inte är slutförd.
elapsed, tiden det tar att köra uppgiften, i sekunder (flyttal, med 3 decimaler). Detta fält returneras inte när uppgiften inte är slutförd.

Batchfrågeåtgärd

Detta används för att fråga om detaljinformation för bilduppgifter med flera uppgifts-ID:n. Skillnaden från ovan är att action måste väljas som retrieve_batch Request Body inkluderar:

ids: Arrayen med uppladdade uppgifts-ID:n.
action: Åtgärden som ska utföras på uppgiften.

Inställningarna visas i bilden nedan:

Kodexempel

Du kan se att kod på olika språk redan har genererats automatiskt på höger sida av sidan, som visas i bilden:

Några kodexempel följer:

Svarsexempel

Efter att begäran har lyckats returnerar API:t detaljinformation om alla batch-bilduppgifter denna gång. Till exempel:

{
  "items": [
    {
      "_id": "677de81d550a4144a5f4cf62",
      "id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
      "api_id": "deefc5d7-7f22-43e9-929e-f2b6afee60b7",
      "application_id": "001c2f84-2a4a-4c4d-ba3f-8a89f43b5be2",
      "created_at": 1736304669.779,
      "started_at": 1736304669.839,
      "finished_at": 1736304679.439,
      "elapsed": 9.6,
      "credential_id": "b00bddd3-140f-4343-a9a2-affb312b60de",
      "request": {
        "action": "generate",
        "size": "1024x1024",
        "prompt": "a white siamese cat"
      },
      "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
        "trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
        "data": [
          {
            "prompt": "a white siamese cat",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "seed": 281520112,
            "timings": {
              "inference": 3.193
            }
          }
        ]
      }
    },
    {
      "_id": "677de950550a4144a5f52963",
      "id": "72bdd69d-290d-4710-a6d4-60c78968865a",
      "api_id": "deefc5d7-7f22-43e9-929e-f2b6afee60b7",
      "application_id": "001c2f84-2a4a-4c4d-ba3f-8a89f43b5be2",
      "created_at": 1736304976.278,
      "started_at": 1736304976.338,
      "finished_at": 1736304985.938,
      "elapsed": 9.6,
      "credential_id": "b00bddd3-140f-4343-a9a2-affb312b60de",
      "request": {
        "action": "generate",
        "size": "1024x1024",
        "prompt": "a white siamese cat"
      },
      "trace_id": "1dca4b49-d31d-42e6-83d9-7f0c56f62d31",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "72bdd69d-290d-4710-a6d4-60c78968865a",
        "trace_id": "1dca4b49-d31d-42e6-83d9-7f0c56f62d31",
        "data": [
          {
            "prompt": "a white siamese cat",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "seed": 1437672535,
            "timings": {
              "inference": 3.175
            }
          }
        ]
      }
    }
  ],
  "count": 2
}

Returresultatet innehåller flera fält, där items innehåller specifik detaljerad information om bilduppgifter i batch. Den specifika informationen för varje bilduppgift är densamma som fälten ovan, och fältinformationen är följande.

items, all specifik detaljerad information om bilduppgifter i batch. Det är en array, och varje element i arrayen har samma format som returresultatet för frågan om en enskild uppgift ovan.
count, antalet bilduppgifter som efterfrågas i batch här.

CURL

curl -X POST 'https://api.acedata.cloud/flux/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["2db0168c-2373-4367-8d9a-9dc778802e8a","72bdd69d-290d-4710-a6d4-60c78968865a"],
  "action": "retrieve_batch"
}'

Python

import requests

url = "https://api.acedata.cloud/flux/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "ids": ["2db0168c-2373-4367-8d9a-9dc778802e8a","72bdd69d-290d-4710-a6d4-60c78968865a"],
    "action": "retrieve_batch"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Felhantering

Vid anrop av API:et returnerar API:et motsvarande felkod och information om ett fel uppstår. Till exempel:

400 token_mismatched：Felaktig begäran, möjligen på grund av saknade eller ogiltiga parametrar.
400 api_not_implemented：Felaktig begäran, möjligen på grund av saknade eller ogiltiga parametrar.
401 invalid_token：Obehörig, ogiltig eller saknad auktoriseringstoken.
429 too_many_requests：För många begäranden, du har överskridit hastighetsgränsen.
500 api_error：Internt serverfel, något gick fel på servern.

Exempel på felsvar

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Slutsats

Genom detta dokument har du redan förstått hur du använder FLux Tasks API för att fråga efter all specifik detaljerad information om enskilda eller batchvisa bilduppgifter. 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, kontakta gärna vårt tekniska supportteam när som helst.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Coding

Fler guider

Integrering och användning av Flux Tasks API

Ansökningsprocess

Begäransexempel

Exempelbild för uppgift

Ange begäranderubrik och begärandetext

Kodexempel

CURL

Python

Svarsexempel

Batchfrågeåtgärd

Kodexempel

Svarsexempel

CURL

Python

Felhantering

Exempel på felsvar

Slutsats

​Ansökningsprocess

​Begäransexempel

​Exempelbild för uppgift

​Ange begäranderubrik och begärandetext

​Kodexempel

​CURL

​Python

​Svarsexempel

​Batchfrågeåtgärd

​Kodexempel

​Svarsexempel

​CURL

​Python

​Felhantering

​Exempel på felsvar

​Slutsats

Ansökningsprocess

Begäransexempel

Exempelbild för uppgift

Ange begäranderubrik och begärandetext

Kodexempel

CURL

Python

Svarsexempel

Batchfrågeåtgärd

Kodexempel

Svarsexempel

CURL

Python

Felhantering

Exempel på felsvar

Slutsats