Anleitung zur Bildgenerierung mit dem LLM API Gateway
Erläutert den Bildgenerierungs-Endpunkt, die Modellauswahl, Parameter und Aufrufmethoden.
Die Bildgenerierung über das LLM API Gateway ist verfügbar.
Cover für offizielle Kanäle, Produktgrafiken, App-Symbole, E-Commerce-Bilder und automatisch von Agenten erzeugte Grafiken lassen sich über einen einheitlichen Endpunkt generieren.
Endpunkt zur Bildgenerierung: POST https://api.llm-token.cn/v1/images/generations
1. Das benötigen Sie für den Start ✨
| Benötigt | Einzutragender Wert |
|---|---|
| Gateway-API-Key | Tragen Sie Authorization: Bearer 你的new-api-token in den Anfrageheader ein. |
| Endpunkt zur Bildgenerierung | https://api.llm-token.cn/v1/images/generations |
| Bildgenerierungsmodell | image-01 oder image-01-live |
Das LLM API Gateway vereinheitlicht Modellanbindung, API-Protokoll, Guthabenverwaltung und Abrechnung. Mit Ihrem eigenen API-Key rufen Sie die Bildgenerierung über einen zentralen Endpunkt auf.
2. In einer Minute starten: curl-Beispiel 🚀
Ersetzen Sie YOUR_NEW_API_TOKEN durch Ihren eigenen API-Key, um den Endpunkt direkt zu testen.
curl https://api.llm-token.cn/v1/images/generations \
-H "Authorization: Bearer YOUR_NEW_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "image-01",
"prompt": "一张可爱的蓝色 AI 小机器人图标,白色背景,极简 3D 风格,居中构图,不要文字",
"response_format": "url",
"n": 1,
"aspect_ratio": "1:1",
"prompt_optimizer": false
}'Erzeugen Sie beim ersten Test nur ein Bild, also n: 1. Sobald die Generierung funktioniert, können Sie Seitenverhältnis, Stil und Anzahl nach Bedarf anpassen.
3. Anfrageparameter ausfüllen 🧩
| Parameter | Erforderlich | Typischer Wert | Erläuterung |
|---|---|---|---|
model | Ja | image-01 | Name des Bildgenerierungsmodells. Für eine stärker auf Echtzeit ausgelegte Generierung können Sie auch image-01-live verwenden. |
prompt | Ja | Nach Bildanforderung | Beschreiben Sie Motiv, Stil, Farben, Komposition und Verwendungszweck möglichst eindeutig. |
response_format | Nein | url | Mit url erhalten Sie direkt einen Bildlink; je nach Anwendung können Sie auch base64 verwenden. |
n | Nein | 1 | Anzahl der in einer Anfrage erzeugten Bilder. Beginnen Sie bei Tests mit 1. |
aspect_ratio | Nein | 1:1 | Seitenverhältnis. Häufig verwendet werden 1:1, 16:9, 9:16, 4:3, 3:4 und 21:9. |
prompt_optimizer | Nein | false | Aktiviert oder deaktiviert die Prompt-Optimierung. Verwenden Sie false, wenn sich das Modell eng an den Originaltext halten soll. |
seed | Nein | Ganzzahl | Verbessert die Reproduzierbarkeit. Verwenden Sie für ähnliche Ergebnisse wiederholt denselben Seed. |
width / height | Nein | Meist nicht erforderlich | Für die meisten Fälle genügt aspect_ratio. Senden Sie Breite und Höhe nur, wenn Sie exakte Abmessungen benötigen. |
Wenn die API eine Bild-URL zurückgibt, speichern Sie das Bild zeitnah. Solche Links eignen sich für vorübergehende Vorschauen und Downloads, nicht als dauerhafte Quelle für Produktionsmaterialien.
4. Vorteile des LLM API Gateway 🍬
Bei einer direkten Anbindung mehrerer Modellplattformen müssen häufig unterschiedliche Keys, Endpunkte und Abrechnungsmodelle verwaltet werden. Das erhöht den Entwicklungs- und Wartungsaufwand.
Das LLM API Gateway vereinheitlicht diese Bereiche. Ein API-Key genügt, um die Bildgenerierung über einen gemeinsamen Endpunkt aufzurufen. Nutzung, Multiplikator und Guthaben werden zentral angezeigt und lassen sich dadurch leichter verwalten.
| Funktion | Erläuterung |
|---|---|
| Einheitlicher Endpunkt | Die Bildgenerierung erfolgt zentral über https://api.llm-token.cn/v1/images/generations, was die Integration vereinfacht. |
| Einheitlicher Key | Verwenden Sie das im Gateway-Backend erzeugte new-api-token, ohne zwischen mehreren Plattformen wechseln zu müssen. |
| Einheitliche Abrechnung | Nutzung, Multiplikator und Guthaben werden zentral angezeigt, sodass Teams ihre Kosten leichter verwalten können. |
| Für Produktintegrationen geeignet | Einsetzbar für Grafiken in offiziellen Kanälen, Produktbilder, Cover, automatische Agenten-Workflows und die stapelweise Materialerstellung. |
Kurz gesagt: Ein API-Key und ein Endpunkt genügen, um Bildgenerierung in Ihre Produkte und Workflows zu integrieren.
5. image-01-live verwenden ⚡
image-01-live verwendet denselben Endpunkt zur Bildgenerierung. Alle anderen Parameter bleiben unverändert; setzen Sie lediglich model auf image-01-live.
{
"model": "image-01-live",
"prompt": "一张赛博风格的蓝色产品宣传图,干净背景,科技感,适合公众号封面",
"response_format": "url",
"n": 1,
"aspect_ratio": "16:9",
"prompt_optimizer": false
}Wenn das Modell für Ihr Konto freigeschaltet ist, können Sie es auf diese Weise direkt aufrufen.
6. Python-Beispiel für die Projektintegration 🐍
import requests
url = "https://api.llm-token.cn/v1/images/generations"
headers = {
"Authorization": "Bearer YOUR_NEW_API_TOKEN",
"Content-Type": "application/json",
}
payload = {
"model": "image-01",
"prompt": "一张科技感很强的蓝色应用图标,白色背景,极简 3D 风格,居中构图,不要文字",
"response_format": "url",
"n": 1,
"aspect_ratio": "1:1",
"prompt_optimizer": False,
}
resp = requests.post(url, headers=headers, json=payload, timeout=120)
resp.raise_for_status()
print(resp.json())Die Bildgenerierung dauert länger als eine normale Textantwort. Setzen Sie das Client-Timeout auf etwa 120 Sekunden, damit die Anfrage nicht beendet wird, bevor das Bild fertig ist.
7. Wirkungsvollere Bildbeschreibungen verfassen 🪄
Strukturieren Sie Ihre Bildbeschreibung in der folgenden Reihenfolge, um konsistentere Ergebnisse zu erhalten:
- Motiv: Was soll dargestellt werden, beispielsweise „ein blauer KI-Roboter“ oder „ein Analyseposter zur Weltmeisterschaft“?
- Szene: Wo befindet sich das Motiv, beispielsweise „vor weißem Hintergrund“, „im Stadionlicht“ oder „auf einem Schreibtisch“?
- Stil: minimalistisch, realistisch, 3D, Illustration, Werbeplakat oder fotografisch.
- Komposition: zentriert, aus der Vogelperspektive, Halbporträt, mit Freiraum oder als Querformat-Cover.
- Farben: Haupt- und Akzentfarben, beispielsweise Blau-Weiß, Schwarz-Gold oder ein Rot-Blau-Kontrast.
- Einschränkungen: beispielsweise „kein Text“, „kein Wasserzeichen“ oder „sauberer Hintergrund“.
Sie können diese kurze Vorlage direkt verwenden:
一张【比例】的【用途】图片,主体是【主体】,场景是【场景】,整体风格为【风格】,主色为【颜色】,构图【构图要求】,细节要求【限制或补充】。Beispiel:
一张 1:1 的应用图标,主体是蓝色发光的 AI 芯片,白色背景,极简 3D 风格,居中构图,边缘清晰,不要文字。8. Fehlerbehebung 🛟
| Problem | Lösung |
|---|---|
| Authentifizierung fehlgeschlagen | Prüfen Sie, ob der Anfrageheader exakt Authorization: Bearer YOUR_NEW_API_TOKEN enthält und der Token keine zusätzlichen Leerzeichen aufweist. |
| Modell nicht gefunden | Prüfen Sie, ob der Modellname exakt image-01 oder image-01-live lautet. Verändern Sie die Groß- und Kleinschreibung nicht. |
| Unerwartetes Seitenverhältnis | Passen Sie zuerst aspect_ratio an. Für Cover eignet sich häufig 16:9, für Avatare und Symbole 1:1. |
| Bildlink lässt sich nicht öffnen | Die Bild-URL ist möglicherweise abgelaufen. Laden Sie das Ergebnis direkt nach der Generierung herunter oder speichern Sie es in Ihrer Materialbibliothek. |
| Lange Wartezeit | Die Bildgenerierung benötigt Zeit. Stellen Sie ein Anfrage-Timeout von mindestens 120 Sekunden ein. |
| Ergebnisse sind nicht stabil genug | Formulieren Sie die Anforderungen präziser und vermeiden Sie widersprüchliche Angaben. Verwenden Sie für ähnliche Ergebnisse einen festen seed. |
9. Kurzfassung zum Weitergeben an Entwickler 📮
Wir rufen die Bildgenerierung über das LLM API Gateway und den Endpunkt POST https://api.llm-token.cn/v1/images/generations auf. Der Anfrageheader verwendet Authorization: Bearer YOUR_NEW_API_TOKEN. Im Anfragebody wird model: image-01 oder model: image-01-live zusammen mit Parametern wie prompt, response_format: url, n und aspect_ratio übergeben.
10. Geeignete Einsatzszenarien 📚
| Einsatzszenario | Verwendung |
|---|---|
| Offizielle Kanäle / Xiaohongshu | Cover, Titelbilder, Veranstaltungsplakate und Artikelillustrationen schnell erzeugen. |
| Produkt- und SaaS-Seiten | App-Symbole, Funktionsgrafiken, Banner und Illustrationen für leere Zustände erstellen. |
| E-Commerce und Produktmaterialien | Produkthintergründe, Werbegrafiken und atmosphärische Bilder für Detailseiten erzeugen. |
| Automatisierte Agenten-Workflows | Agenten passend zum Inhalt automatisch Bilder erzeugen lassen und damit die Inhaltserstellung beschleunigen. |