Image Models

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

List available image generation models

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

Returns the static model catalog with an allowed flag derived from the workspace's image permissions.

Path Parameters

Parameter	Type	Required	Description
workspaceId	string	Yes

Query Parameters

Parameter	Type	Default	Description
page	integer	1	1-based page number
size	integer	50	Items per page (max 200)

Response

FieldTypeDescription

pageobject

sizeintegerNumber of elements requested per page.

totalElementsintegerTotal number of matching elements.

totalPagesintegerTotal number of pages.

currentPageinteger1-based index of the returned page.

dataarray<object>

idstringMachine readable model identifier.

namestringHuman readable model name.

providerstringUpstream provider (e.g. fal.ai).

descriptionstringFull model description.

capabilitiesarray<string>Capabilities supported by the model (text2image, image2image, …).

maxImagesintegerMax images per request.

aspectRatiosarray<string>Aspect ratios supported.

outputFormatsarray<string>Output formats supported.

allowedbooleanWhether the calling workspace is allowed to use the model.

orderintegerRecommended display order in the UI.

Example

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()

Response:

{
  "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"
    }
  ]
}