Bilder generieren
Die synchrone JSON-Antwort enthält Bildresultate in den Daten.
Auf dieser Seite
https://api.shareai.now/api/v1/imagesBilder generieren
- Basis-URL
https://api.shareai.now- Authentifizierung
- Bearer-API-Schlüssel oder genehmigtes OAuth-Zugriffstoken
- Erforderlicher Scope
inferenceormonetization_gateway
Die synchrone JSON-Antwort enthält Bildergebnisse in data. Der Alias /api/v1/images/generations wird ebenfalls unterstützt. Optionen wie Größe, Auflösung, Seitenverhältnis, Qualität und Ausgabeformat hängen vom ausgewählten Modell ab. Antworten sind auf 2 MiB begrenzt; reduzieren Sie bei Bedarf die Bildanzahl oder -größe. Zurückgegebene Bilder sind auf 8192 Pixel pro Seite begrenzt.
Bevor Sie beginnen#
Setzen Sie SHAREAI_API_KEY auf Ihrem Server und ersetzen Sie den Modell-Platzhalter durch ein derzeit aktiviertes Modell. Geben Sie den API-Schlüssel niemals im Browsercode preis. Das Modell, das Konto, die Berechtigung und der Anbieter müssen diese Operation erlauben. Die unten aufgeführten optionalen Einstellungen erfordern Modellunterstützung; die Sicherheitsgrenzen der API garantieren nicht, dass jedes Modell jeden Wert unterstützt.
Eine Anfrage senden#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_IMAGES_MODEL',
'prompt': 'A quiet forest painted in watercolor.',
'n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/images', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/images", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Anforderungsfelder#
| Feld | Typ | Bedeutung und Grenzen |
|---|---|---|
model erforderlich | Zeichenkette | Exakte aktivierte öffentliche Modellkennung. Muss diese Operation deklarieren und von Ihrer Berechtigung erlaubt sein. |
prompt erforderlich | Zeichenkette | Nichtleere Generierungsaufforderung, maximal 256 KiB UTF-8-Text. |
n | Ganzzahl | Optionale Bildanzahl, 1–10; Standardwert 1. Ihr Modell kann weniger zulassen. |
size | Zeichenkette | Modellunterstützte Ausgabengröße, maximal 100 Zeichen, zum Beispiel 1024×1024. Nicht jedes Modell unterstützt diese Option. |
resolution | Zeichenkette | Modellunterstützter Auflösungswähler, maximal 100 Zeichen; muss mit der veröffentlichten Tarifvariante übereinstimmen. |
aspect_ratio | Zeichenkette | Modellunterstützter Seitenverhältnis-Wähler, maximal 100 Zeichen. |
quality | Zeichenkette | Vom Modell unterstützter Qualitätsselektor, maximal 100 Zeichen; kann eine andere Rate auswählen. |
response_format | Zeichenkette | Modellunterstütztes Antwortformat, maximal 100 Zeichen. Der Vorgang bestimmt, ob das Ergebnis JSON oder binär ist. |
output_format | Zeichenkette | Vom Modell unterstützter Ausgabe-Codierungsselektor, maximal 100 Zeichen. |
background | Zeichenkette | Optionale Bildhintergrundeinstellung, wenn vom Modell unterstützt. |
seed | Ganzzahl | Optional modellunterstützte Seed. Video erfordert eine nichtnegative Ganzzahl; die Reproduzierbarkeit hängt vom Ausführenden ab. |
input_references | Array | Maximal 16 typisierte image_url-Teile mit image_url.url, die auf eine HTTPS-URL oder unterstützte Bilddaten-URL gesetzt sind. Modellunterstützung ist erforderlich. |
provider | Objekt | Optionale Routing-Präferenzen für Anbieter. Verwenden Sie provider.only für akzeptierte Anbieter-Tags, nicht als Präfix in der Modell-ID. Konto- und Berechtigungsbeschränkungen gelten weiterhin. |
Das Ergebnis lesen#
Erfolg gibt HTTP 200 mit JSON zurück. Die synchrone JSON-Antwort enthält Bildergebnisse in data. Der Alias /api/v1/images/generations wird ebenfalls unterstützt. Optionen wie Größe, Auflösung, Seitenverhältnis, Qualität und Ausgabeformat hängen vom ausgewählten Modell ab. Antworten sind auf 2 MiB begrenzt; reduzieren Sie bei Bedarf die Bildanzahl oder -größe. Zurückgegebene Bilder sind auf 8192 Pixel pro Seite begrenzt.
Abrechnungseinheiten#
Bildtarife können generierte Bilder, gemessene Megapixel, Eingabereferenzen, Anfragen oder vom Anbieter gemeldete Tokens verwenden. Eine Bild-URL ist keine Bildgrößenmessung. Megapixel-Tarife erfordern die Abmessungen der zurückgegebenen Bilder; verwenden Sie für diese Routen die Base64-Ausgabe.
Wählen Sie die exakte aktivierte Modellkennung aus der Konsole. Die deklarierte Operation und die Eingabe-/Ausgabefunktionen müssen mit diesem Endpunkt übereinstimmen; ein Text-Chat-Modell kann nicht für eine andere Operation ersetzt werden. Ihre Berechtigungen, Anbieter- und Kontobeschränkungen gelten weiterhin.
Preise und Nutzung#
Die Tarife werden in EUR AI-Credits für das ausgewählte Modell, den Anbieter, die Einheiten und Varianten veröffentlicht. Es werden nur die Dimensionen im aktiven Tarif berechnet. Eine Schätzung reserviert Credits vor der Ausführung; die endgültigen Kosten basieren auf gemessener Nutzung. Preise können von der Auflösung, dem Ausgabeformat oder einem Nutzungsband abhängen. Überprüfen Sie die Konsolennutzung für die endgültige ShareAI-Belastung. Upstream-Kostenfelder und Medienbytes werden nicht in erfundene Token-Mengen umgerechnet.
Zugriff und Fehler#
Verwenden Sie inference für genehmigte netzwerkkostenbasierte Inferenz oder monetization_gateway für einen genehmigten Builder-Aufschlag und akzeptierte Abrechnungsbedingungen. Zugriff nur mit Identitätsnachweis autorisiert keine Ausgaben. Validierung, Modellautorisierung, unzureichende Credits, Ratenlimits und Ausführungsfehler geben eine strukturierte error. Nach einem Timeout oder einer unsicheren Übermittlung überprüfen Sie die Nutzung oder den Videoauftrag, bevor Sie eine weitere potenziell kostenpflichtige Anfrage erstellen.
Zuletzt aktualisiert am 3. November 2026