Bildmodelle

Basis-URL: https://app.neuroflash.com/api/image-service

Verfügbare Bildgenerierungsmodelle auflisten

GET/v1/workspaces/{workspaceId}/image-models

Gibt den statischen Modellkatalog mit einem allowed-Flag zurück, das von den Bildberechtigungen des Workspace abgeleitet ist.

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
workspaceId	string	Ja

Abfrageparameter

Parameter	Typ	Standard	Beschreibung
page	integer	1	1-basierte Seitennummer
size	integer	50	Elemente pro Seite (maximal 200)

Antwort

FeldTypBeschreibung

pageobject

sizeintegerAnzahl der pro Seite angeforderten Elemente.

totalElementsintegerGesamtzahl der übereinstimmenden Elemente.

totalPagesintegerGesamtzahl der Seiten.

currentPageinteger1-basierter Index der zurückgegebenen Seite.

dataarray<object>

idstringMaschinenlesbarer Modellbezeichner.

namestringBenutzerfreundlicher Modellname.

providerstringUpstream-Anbieter (z. B. fal.ai).

descriptionstringVollständige Modellbeschreibung.

capabilitiesarray<string>Von dem Modell unterstützte Funktionen (text2image, image2image, …).

maxImagesintegerMaximale Anzahl von Bildern pro Anfrage.

aspectRatiosarray<string>Unterstützte Seitenverhältnisse.

outputFormatsarray<string>Unterstützte Ausgabeformate.

allowedbooleanOb der aufrufende Workspace berechtigt ist, das Modell zu verwenden.

orderintegerEmpfohlene Anzeigereihenfolge in der UI.

Beispiel

cURL

curl "https://app.neuroflash.com/api/image-service/v1/workspaces/{workspace_id}/image-models" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Python

import requests

response = requests.get(
    f"https://app.neuroflash.com/api/image-service/v1/workspaces/{workspace_id}/image-models",
    headers={"Authorization": f"Bearer {token}"},
).json()

Node.js

const response = await fetch(
  `https://app.neuroflash.com/api/image-service/v1/workspaces/${workspaceId}/image-models`,
  { headers: { Authorization: `Bearer ${token}` } }
).then((r) => r.json());

Go

req, _ := http.NewRequest("GET", "https://app.neuroflash.com/api/image-service/v1/workspaces/"+workspaceID+"/image-models", nil)
req.Header.Set("Authorization", "Bearer "+token)

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

Antwort:

{
  "page": {
    "size": 0,
    "totalElements": 0,
    "totalPages": 0,
    "currentPage": 0
  },
  "data": [
    {
      "allowed": true,
      "aspectRatios": [
        "21:9",
        "16:9",
        "3:2",
        "4:3",
        "5:4",
        "1:1",
        "4:5",
        "3:4",
        "2:3",
        "9:16"
      ],
      "capabilities": [
        "text2image",
        "image2image"
      ],
      "description": "Fast and efficient image generation model",
      "id": "nano-banana-2",
      "maxImages": 4,
      "name": "Nano Banana 2",
      "order": 1,
      "outputFormats": [
        "jpeg",
        "png",
        "webp"
      ],
      "provider": "fal.ai"
    }
  ]
}