Hoppa till huvudinnehåll

​
Introduktion

Flux är en AI-bildtjänst som tillhandahålls av Ace Data Cloud, med Black Forest Labs Flux bildgenereringsmodell. Genom Ace Data Clouds enhetliga API kan du snabbt integrera Flux med Python för att skapa bilder från text, redigera bilder, använda olika modeller och anpassa storlekar.

​
Förutsättningar

  • Ett konto hos Ace Data Cloud och en API-token
  • Python 3.7 eller senare
  • Installera requests-biblioteket: pip install requests

​
Grundläggande användning

Huvudendpoint för att anropa Flux API är: 
POST https://api.acedata.cloud/flux/images
Det här exemplet använder modellen flux-pro-1.1. Tillgängliga modeller inkluderar: flux-dev, flux-pro, flux-pro-1.1, flux-pro-1.1-ultra, flux-kontext-pro, flux-kontext-max. Fullständigt Python-exempel: 
import requests

url = "https://api.acedata.cloud/flux/images"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "generate",
    "prompt": "A white siamese cat sitting on a windowsill",
    "model": "flux-pro-1.1",
    "size": "1024x1024"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Byt ut YOUR_API_TOKEN mot din faktiska token från Ace Data Cloud-plattformen.

​
Hantering av svar

Vid lyckad anrop returnerar API:et data i JSON-format. Det rekommenderas att kontrollera HTTP-statuskoden: 
if response.status_code == 200:
    result = response.json()
    print("Anrop lyckades:", result)
else:
    print(f"Anrop misslyckades, statuskod: {response.status_code}")
    print(response.text)

​
Avancerad användning

För API:er som stödjer asynkrona uppgifter kan du få resultat via en callback-URL: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Resultatet kommer att skickas till din server via callback-URL:en

​
Felhantering

Vanliga felkoder:
StatuskodBeskrivning
401Autentisering misslyckades, kontrollera API-token
403Otillräcklig saldo eller ingen åtkomst
429För många förfrågningar
500Intern serverfel

​
Andra endpoints

Flux-tjänsten erbjuder även följande endpoint:
  • POST https://api.acedata.cloud/flux/tasks

​
Nästa steg