Ein Bild generieren

Verwenden Sie ein Bildmodell, das derzeit auf ShareAI aktiviert ist und durch Ihre Berechtigung erlaubt ist. Das Modell bestimmt, welche Größen, Qualitätsstufen und Ausgabeoptionen es unterstützt.

Eine Anfrage senden#

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/images/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "provider": {
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  },
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
}'

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'provider': {'sort': {'by': 'price', 'direction': 'asc'}}, 'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "provider": {
    "sort": {
      "by": "price",
      "direction": "asc"
    }
  },
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

Anforderungsfelder#

Lesen Sie das Bild#

Überprüfen Sie die zurückgegebenen data Einträge. Abhängig vom Modell und angeforderten Format enthält ein Eintrag eine HTTPS-Bild-URL oder Base64-Bilddaten. Verwenden Sie das tatsächlich zurückgegebene Format; gehen Sie nicht davon aus, dass jeder Anbieter eine URL zurückgibt. Die API lädt zurückgegebene Bild-URLs nicht für Sie herunter.

Größen- und Zeitlimits#

Anfragen sind synchron. Kombinierter Text ist auf 256 KiB begrenzt, der Anbieteraufruf auf 120 Sekunden und die Antwort auf 2 MiB. Große Base64-Bilder können dieses Antwortlimit überschreiten. Wählen Sie eine geeignete Ausgabegröße oder ein Modell, das URL-Ausgabe unterstützt.

Vorsichtig erneut versuchen#

Das Generieren eines Bildes kann Nutzungskosten verursachen. Nach einem Timeout oder einem mehrdeutigen Netzwerkfehler überprüfen Sie die Aktivität, bevor Sie es erneut versuchen; das Wiederholen der Anfrage kann ein weiteres Bild generieren und berechnen. Die API versucht nicht automatisch, eine Bildanfrage nach der Übermittlung an einen Anbieter erneut auszuführen.

Unterstützte Operationen#

Diese Route generiert Bilder aus Text. Bildbearbeitungen, Variationen, mehrteilige Uploads und Streaming-Bildgenerierung werden nicht unterstützt. Die aktuelle Abrechnung erfordert einen kompatiblen Modell-/Anbieter-Token-Nutzungsvertrag; Anbieter, die nur pro Bild abrechnen, sind möglicherweise nicht verfügbar.

Kundenauthorisierung verwenden#

Für einen genehmigten OAuth-Flow senden Sie das Zugriffstoken als Bearer. Kontofinanzierte Bildgenerierung erfordert surcharge und einen akzeptierten Nutzungsplan. Alle Modell-, Anbieter- und Kontobeschränkungen bleiben in Kraft.

Modellidentität und Ausführungsanbieter#

Kopieren Sie die genaue, auf dem Creator basierende Modellkennung von Modelle. Wählen Sie die Infrastruktur separat mit dem optionalen provider Objekt aus. Standardmäßig werden berechtigte Anbieter nach Preis sortiert, beginnend mit dem niedrigsten. Anbieter auswählen oder konsultieren Sie die vollständige Richtlinienreferenz.