Aufgaben

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

Bilder aus einer Textaufforderung generieren

POST/v1/workspaces/{workspaceId}/image-generation-tasks

Generiert neue Bilder im angegebenen Arbeitsbereich. Der Aufrufer wird als Eigentümer (createdByUserId) registriert und ist der einzige Nicht-Admin-Benutzer, der diese löschen darf.

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
`workspaceId`	string	Ja

Anfrage-Body

promptstringJaTextaufforderung zum Generieren.

numImagesintegerNeinAnzahl der zu generierenden Bilder.

aspectRatiostringNeinSeitenverhältnis-Optionen für generierte Bilder.

outputFormatstringNein

modelIdstringNeinVerfügbare Bildgenerierungsmodelle.

Antwort

imagesarray<object>Die erstellten Bilder.

idstringEindeutige Bild-ID (auch der GCS-Objektschlüssel).

generationIdstringGruppiert jedes Bild, das von einer Generierungsanfrage erzeugt wird. Mehrere Zeilen können die gleiche generationId teilen, wenn eine Anfrage mehr als ein Bild anforderte.

workspaceIdstringID des besitzenden Arbeitsbereichs.

createdByUserIdstringGateway-Benutzer-ID des Bilderstellungsurhebers.

promptstringEingabeaufforderung, die das Bild erzeugte (leer bei Hochskalierungen).

modelstringModell, das zur Erzeugung des Bildes verwendet wurde.

parametersobjectGenerierungsparameter (Seitenverhältnis, Format usw.).

inputImageIdsobjectIDs aller bereitgestellten Eingabebilder für Bild2Bild/Hochskalierung.

imageWidthobjectBildbreite in Pixeln.

imageHeightobjectBildhöhe in Pixeln.

imageSizeobjectBilddateigröße in Bytes.

createdAtstringErstellungs-Zeitstempel in UTC.

updatedAtstringLetzter Update-Zeitstempel in UTC.

_linksobject

contentstringArbeitsbereich-bezogene URL, die das Bildbinary zurückgibt.

generationIdstringID, die die zusammen erstellten Bilder gruppiert.

descriptionstringOptionale Beschreibung vom vorgelagerten Anbieter.

detailobjectNicht-kritische Warnung (z. B. teilweises Kontingent).

Beispiel

cURL
Python
Node.js
Go

curl -X POST "https://app.neuroflash.com/api/image-service/v1/workspaces/{workspace_id}/image-generation-tasks" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "prompt": "string",
      "numImages": 1,
      "aspectRatio": "string",
      "outputFormat": "string",
      "modelId": "string"
  }'

import requests

response = requests.post(
    f"https://app.neuroflash.com/api/image-service/v1/workspaces/{workspace_id}/image-generation-tasks",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
    json={
        "prompt": "string",
        "numImages": 1,
        "aspectRatio": "string",
        "outputFormat": "string",
        "modelId": "string"
    },
).json()

const response = await fetch(
  `https://app.neuroflash.com/api/image-service/v1/workspaces/${workspaceId}/image-generation-tasks`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
          "prompt": "string",
          "numImages": 1,
          "aspectRatio": "string",
          "outputFormat": "string",
          "modelId": "string"
    }),
  }
).then((r) => r.json());

body, _ := json.Marshal(map[string]any{
		"prompt": "string",
		"numImages": 1,
		"aspectRatio": "string",
		"outputFormat": "string",
		"modelId": "string",
	})

req, _ := http.NewRequest("POST", "https://app.neuroflash.com/api/image-service/v1/workspaces/"+workspaceID+"/image-generation-tasks", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")

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

Antwort:

{
  "images": [
    {
      "id": "string",
      "generationId": "string",
      "workspaceId": "string",
      "createdByUserId": "string",
      "prompt": "string",
      "model": "string",
      "parameters": {},
      "inputImageIds": {},
      "imageWidth": {},
      "imageHeight": {},
      "imageSize": {},
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "_links": {
        "content": "string"
      }
    }
  ],
  "generationId": "string",
  "description": "string",
  "detail": {}
}

Vorhandene Bilder bearbeiten (aufforderungsgesteuerte Bild-zu-Bild-Konvertierung)

POST/v1/workspaces/{workspaceId}/image-edit-tasks

Verarbeitet eine oder mehrere vorhandene Bild-URLs und eine Aufforderung und erstellt neue, davon abgeleitete Bild(er). Eingaben werden zusammen mit Ausgaben für Nachverfolgung gespeichert.

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
`workspaceId`	string	Ja

Anfrage-Body

promptstringJaBearbeitungsaufforderung, die die Bild-zu-Bild-Generierung steuert.

imageIdsarray<string>JaIDs vorhandener Bilder zum Bearbeiten. Der Aufrufer muss jedes Bild besitzen (gleicher Arbeitsbereich und createdByUserId).

numImagesintegerNeinAnzahl der zu erzeugenden Bilder.

aspectRatiostringNeinSeitenverhältnis-Optionen einschließlich 'auto' für Bild-zu-Bild-Bearbeitungen.

outputFormatstringNein

modelIdstringNeinVerfügbare Bildgenerierungsmodelle.

Antwort

imagesarray<object>Die erstellten Bilder.

idstringEindeutige Bild-ID (auch der GCS-Objektschlüssel).

generationIdstringGruppiert jedes Bild, das von einer Generierungsanfrage erzeugt wird. Mehrere Zeilen können die gleiche generationId teilen, wenn eine Anfrage mehr als ein Bild anforderte.

workspaceIdstringID des besitzenden Arbeitsbereichs.

createdByUserIdstringGateway-Benutzer-ID des Bilderstellungsurhebers.

promptstringEingabeaufforderung, die das Bild erzeugte (leer bei Hochskalierungen).

modelstringModell, das zur Erzeugung des Bildes verwendet wurde.

parametersobjectGenerierungsparameter (Seitenverhältnis, Format usw.).

inputImageIdsobjectIDs aller bereitgestellten Eingabebilder für Bild2Bild/Hochskalierung.

imageWidthobjectBildbreite in Pixeln.

imageHeightobjectBildhöhe in Pixeln.

imageSizeobjectBilddateigröße in Bytes.

createdAtstringErstellungs-Zeitstempel in UTC.

updatedAtstringLetzter Update-Zeitstempel in UTC.

_linksobject

contentstringArbeitsbereich-bezogene URL, die das Bildbinary zurückgibt.

generationIdstringID, die die zusammen erstellten Bilder gruppiert.

descriptionstringOptionale Beschreibung vom vorgelagerten Anbieter.

detailobjectNicht-kritische Warnung (z. B. teilweises Kontingent).

Beispiel

cURL
Python
Node.js
Go

curl -X POST "https://app.neuroflash.com/api/image-service/v1/workspaces/{workspace_id}/image-edit-tasks" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "prompt": "string",
      "imageIds": [],
      "numImages": 1,
      "aspectRatio": "string",
      "outputFormat": "string",
      "modelId": "string"
  }'

import requests

response = requests.post(
    f"https://app.neuroflash.com/api/image-service/v1/workspaces/{workspace_id}/image-edit-tasks",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
    json={
        "prompt": "string",
        "imageIds": [],
        "numImages": 1,
        "aspectRatio": "string",
        "outputFormat": "string",
        "modelId": "string"
    },
).json()

const response = await fetch(
  `https://app.neuroflash.com/api/image-service/v1/workspaces/${workspaceId}/image-edit-tasks`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
          "prompt": "string",
          "imageIds": [],
          "numImages": 1,
          "aspectRatio": "string",
          "outputFormat": "string",
          "modelId": "string"
    }),
  }
).then((r) => r.json());

body, _ := json.Marshal(map[string]any{
		"prompt": "string",
		"imageIds": []any{},
		"numImages": 1,
		"aspectRatio": "string",
		"outputFormat": "string",
		"modelId": "string",
	})

req, _ := http.NewRequest("POST", "https://app.neuroflash.com/api/image-service/v1/workspaces/"+workspaceID+"/image-edit-tasks", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")

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

Antwort:

{
  "images": [
    {
      "id": "string",
      "generationId": "string",
      "workspaceId": "string",
      "createdByUserId": "string",
      "prompt": "string",
      "model": "string",
      "parameters": {},
      "inputImageIds": {},
      "imageWidth": {},
      "imageHeight": {},
      "imageSize": {},
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "_links": {
        "content": "string"
      }
    }
  ],
  "generationId": "string",
  "description": "string",
  "detail": {}
}

Vorhandenes Bild hochskalieren

POST/v1/workspaces/{workspaceId}/image-upscale-tasks

Skaliert ein einzelnes Eingabebild mit einem dedizierten Hochskalierungsmodell hoch. Das Eingabebild wird zusammen mit der Ausgabe für Nachverfolgung gespeichert.

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
`workspaceId`	string	Ja

Anfrage-Body

imageIdstringJaID des vorhandenen Bildes zum Hochskalieren. Der Aufrufer muss das Bild besitzen (gleicher Arbeitsbereich und createdByUserId).

modelIdstringJaVerfügbare Bildvergrößerungsmodelle.

upscaleFactorintegerJaUnterstützte Hochskalierungsfaktoren.

outputFormatstringNein

Antwort

imagesarray<object>Die erstellten Bilder.

idstringEindeutige Bild-ID (auch der GCS-Objektschlüssel).

generationIdstringGruppiert jedes Bild, das von einer Generierungsanfrage erzeugt wird. Mehrere Zeilen können die gleiche generationId teilen, wenn eine Anfrage mehr als ein Bild anforderte.

workspaceIdstringID des besitzenden Arbeitsbereichs.

createdByUserIdstringGateway-Benutzer-ID des Bilderstellungsurhebers.

promptstringEingabeaufforderung, die das Bild erzeugte (leer bei Hochskalierungen).

modelstringModell, das zur Erzeugung des Bildes verwendet wurde.

parametersobjectGenerierungsparameter (Seitenverhältnis, Format usw.).

inputImageIdsobjectIDs aller bereitgestellten Eingabebilder für Bild2Bild/Hochskalierung.

imageWidthobjectBildbreite in Pixeln.

imageHeightobjectBildhöhe in Pixeln.

imageSizeobjectBilddateigröße in Bytes.

createdAtstringErstellungs-Zeitstempel in UTC.

updatedAtstringLetzter Update-Zeitstempel in UTC.

_linksobject

contentstringArbeitsbereich-bezogene URL, die das Bildbinary zurückgibt.

generationIdstringID, die die zusammen erstellten Bilder gruppiert.

descriptionstringOptionale Beschreibung vom vorgelagerten Anbieter.

detailobjectNicht-kritische Warnung (z. B. teilweises Kontingent).

Beispiel

cURL
Python
Node.js
Go

curl -X POST "https://app.neuroflash.com/api/image-service/v1/workspaces/{workspace_id}/image-upscale-tasks" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "imageId": "string",
      "modelId": "string",
      "upscaleFactor": 0,
      "outputFormat": "string"
  }'

import requests

response = requests.post(
    f"https://app.neuroflash.com/api/image-service/v1/workspaces/{workspace_id}/image-upscale-tasks",
    headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
    json={
        "imageId": "string",
        "modelId": "string",
        "upscaleFactor": 0,
        "outputFormat": "string"
    },
).json()

const response = await fetch(
  `https://app.neuroflash.com/api/image-service/v1/workspaces/${workspaceId}/image-upscale-tasks`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
          "imageId": "string",
          "modelId": "string",
          "upscaleFactor": 0,
          "outputFormat": "string"
    }),
  }
).then((r) => r.json());

body, _ := json.Marshal(map[string]any{
		"imageId": "string",
		"modelId": "string",
		"upscaleFactor": 0,
		"outputFormat": "string",
	})

req, _ := http.NewRequest("POST", "https://app.neuroflash.com/api/image-service/v1/workspaces/"+workspaceID+"/image-upscale-tasks", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")

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

Antwort:

{
  "images": [
    {
      "id": "string",
      "generationId": "string",
      "workspaceId": "string",
      "createdByUserId": "string",
      "prompt": "string",
      "model": "string",
      "parameters": {},
      "inputImageIds": {},
      "imageWidth": {},
      "imageHeight": {},
      "imageSize": {},
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z",
      "_links": {
        "content": "string"
      }
    }
  ],
  "generationId": "string",
  "description": "string",
  "detail": {}
}

Bilder aus einer Textaufforderung generieren​

Pfadparameter​

Anfrage-Body​

Antwort​

Beispiel​

Vorhandene Bilder bearbeiten (aufforderungsgesteuerte Bild-zu-Bild-Konvertierung)​

Pfadparameter​

Anfrage-Body​

Antwort​

Beispiel​

Vorhandenes Bild hochskalieren​

Pfadparameter​

Anfrage-Body​

Antwort​

Beispiel​

Bilder aus einer Textaufforderung generieren

Pfadparameter

Anfrage-Body

Antwort

Beispiel

Vorhandene Bilder bearbeiten (aufforderungsgesteuerte Bild-zu-Bild-Konvertierung)

Pfadparameter

Anfrage-Body

Antwort

Beispiel

Vorhandenes Bild hochskalieren

Pfadparameter

Anfrage-Body

Antwort

Beispiel