Istruzioni per l'integrazione dell'API Flux Images Generation

​

Processo di richiesta

📘 Documentazione completa: Flux Images Generation API →

​

Utilizzo di base

• accept: il formato del risultato della risposta che si desidera ricevere; qui viene compilato come application/json, ovvero in formato JSON.
• authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dal menu a discesa dopo la richiesta.

• action: l’azione di questa attività di generazione immagini.
• size: la dimensione del risultato della generazione dell’immagine. Le serie flux-2-flex / flux-2-pro / flux-2-max devono ricevere le proporzioni dell’immagine (ad esempio 1:1, 16:9) e non accettano dimensioni in pixel come 1024x1024; se omesso, verrà restituito 400.
• count: il numero di immagini da generare; il valore predefinito è 1. Questo parametro è valido solo per le attività di generazione immagini e non è valido per le attività di modifica.
• prompt: il prompt.
• model: il modello di generazione, con valore predefinito flux-dev; gli ultimi modelli di punta sono flux-2-pro, flux-2-max (qualità dell’immagine più alta, da utilizzare con la proporzione dell’immagine size).
• callback_url: l’URL che deve ricevere il risultato della callback.
• async: opzionale; quando impostato su true, l’interfaccia restituisce immediatamente task_id, senza dover fornire callback_url, e successivamente il risultato viene ottenuto tramite polling attraverso la corrispondente interfaccia di query dell’attività.

{
  "success": true,
  "task_id": "5456c749-3bbb-4f10-9eb8-cfbcac297500",
  "trace_id": "ae4eecb8-1dd6-45b4-bfb3-a1c48872536e",
  "data": [
    {
      "image_url": "https://cdn.acedata.cloud/assets/examples/flux/5456c749-3bbb-4f10-9eb8-cfbcac297500-d0ef60485f73.jpg"
    }
  ]
}

• success, lo stato dell’attività di generazione video in questo momento.
• task_id, l’ID dell’attività di generazione video in questo momento.
• trace_id, l’ID di tracciamento della generazione video in questo momento.
• data, l’elenco dei risultati dell’attività di generazione immagini in questo momento.
  • image_url, il link dell’attività di generazione immagini in questo momento.
  • prompt, il prompt.

curl -X POST 'https://api.acedata.cloud/flux/images' \
-H 'authorization: Bearer {token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "prompt": "A photorealistic studio product shot of a frosted-glass perfume bottle on wet black slate, single softbox key light, water droplets, dark moody background, 85mm macro.",
  "model": "flux-2-pro",
  "size": "1:1"
}'

​

Attività di modifica delle immagini

• model: il modello utilizzato per questa attività di modifica immagini; supporta flux-dev, flux-pro, flux-kontext-pro, flux-kontext-max, flux-2-flex, flux-2-pro, flux-2-max.
• image_url: carica l’immagine da modificare.

import requests

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

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

payload = {
    "action": "edit",
    "prompt": "a white siamese cat",
    "model": "flux-kontext-pro",
    "image_url": "https://cdn.acedata.cloud/ytj2qy.png"
}

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

{
  "success": true,
  "task_id": "2a7979ff-1f77-4380-92c6-a2dc37c3b4c8",
  "trace_id": "732b65c0-48d9-49f7-b568-64e5acffe4c0",
  "data": [
    {
      "prompt": "a white siamese cat",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "timings": 1752744073
    }
  ]
}

​

Callback asincrono

{
  "task_id": "6a97bf49-df50-4129-9e46-119aa9fca73c"
}

{
  "success": true,
  "task_id": "6a97bf49-df50-4129-9e46-119aa9fca73c",
  "trace_id": "9b4b1ff3-90f2-470f-b082-1061ec2948cc",
  "data": [
    {
      "prompt": "a white siamese cat",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "seed": 1698551532,
      "timings": {
        "inference": 3.328
      }
    }
  ]
}

​

Gestione degli errori

• 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.

​

Esempio di risposta di errore

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

​

Conclusione