Bilder mit GetAPI.ONE erzeugen

Unterstützte Anfrage vorbereiten

• Öffnen Sie den aktuellen Katalog und wählen Sie ein Modell, dessen angegebener Endpunkt der Bilderzeugung dient.
• Prüfen Sie vor einem kostenpflichtigen Aufruf die aktuellen Preise; diese Anleitung schreibt keinen Preis fest.
• Beginnen Sie mit einer Ausgabe und ausschließlich den für dieses Modell dokumentierten Feldern.

POST https://www.getapi.one/v1/images/generations

Minimale Bilderzeugung anfordern

1. Setzen Sie GETAPI_ONE_API_KEY in einer vertrauenswürdigen Prozessumgebung.
2. Kopieren Sie die exakte Bildmodell-ID aus dem aktuellen Katalog.
3. Beschreiben Sie Motiv, Komposition und Einschränkungen im Prompt.
4. Fordern Sie zunächst ein Ergebnis an und ergänzen Sie optionale Felder erst nach Bestätigung der Modellunterstützung.
5. Decodieren Sie größenbegrenzte Base64‑Ausgaben lokal. Enthält die Antwort eine URL, protokollieren Sie diese für einen freigegebenen Downloader mit expliziten Ausgangs- und Hostregeln sowie erneuter Weiterleitungsprüfung, statt sie im API-Prozess abzurufen.

curl --fail-with-body https://www.getapi.one/v1/images/generations \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<IMAGE_MODEL_ID_FROM_CURRENT_CATALOG>",
    "prompt": "A clean product diagram of a secure server-side API flow",
    "n": 1
  }' > image-response.json

import base64
import json
from pathlib import Path
from urllib.parse import urlsplit

payload = json.loads(Path("image-response.json").read_text(encoding="utf-8"))
item = payload["data"][0]

if item.get("b64_json"):
    image_bytes = base64.b64decode(item["b64_json"], validate=True)
    if len(image_bytes) > 25 * 1024 * 1024:
        raise ValueError("Image exceeds the local 25 MB safety limit")
    Path("generated-image.bin").write_bytes(image_bytes)
elif item.get("url"):
    url = item["url"]
    parsed = urlsplit(url)
    if parsed.scheme != "https" or not parsed.hostname:
        raise ValueError("Refusing an invalid or non-HTTPS image URL")
    # Do not dereference provider-controlled URLs from a generic server example.
    # Give this record to an approved downloader that enforces your egress and
    # host policy, rejects private/link-local/loopback destinations, revalidates
    # every redirect, sends no ONE credential, and bounds the response bytes.
    Path("generated-image-url.txt").write_text(url, encoding="utf-8")
    print("URL recorded for an egress-controlled downloader")
else:
    raise ValueError("Expected data[0].url or data[0].b64_json")

Ergebnis bewerten

Erwartetes Ergebnis prüfen

• Die HTTP-Anfrage ist erfolgreich, und ihr Antwortkörper enthält die Bild-Ergebnisstruktur des ausgewählten Modells.
• Eine decodierte Base64‑Datei lässt sich als erwarteter Bildtyp öffnen, oder ein URL-Ergebnis wird protokolliert und ausschließlich von einem freigegebenen Downloader mit kontrollierten ausgehenden Verbindungen abgerufen.
• Die ONE-Konsole zeichnet die Anfrage oder zugehörige Nutzung auf.

Fehler bei Bildanfragen beheben

Ein- und Ausgaben sicher speichern

• Bewahren Sie Schlüssel serverseitig auf und prüfen Sie Prompt-Länge, Ausgabemenge und optionale Felder vor der Weiterleitung.
• Senden Sie keine vertraulichen Quellbilder oder personenbezogenen Daten, sofern Ihre genehmigten Regeln zur Datenverarbeitung dies nicht erlauben.
• Behandeln Sie zurückgegebene URLs als vorübergehend, sofern der Anbietervertrag nicht ausdrücklich etwas anderes festlegt; kopieren Sie freigegebene Ausgaben in kontrollierten Speicher.
• Leiten Sie den GetAPI.ONE‑Header Authorization niemals an eine zurückgegebene Bild-URL weiter.
• Behandeln Sie zurückgegebene URLs als nicht vertrauenswürdige Eingaben: Erzwingen Sie eine explizite Richtlinie für ausgehende Verbindungen und Hosts, sperren Sie private, Link-Local- und Loopback-Ziele und prüfen Sie jede Weiterleitung im separaten Downloader erneut.

Nächste Schritte

• Eignung für die Aufgabe vergleichen
• Asynchronen Videoablauf erstellen