Zhipu: CogView 4
CogView 4 ist Zhipus Modell zur Bilderzeugung aus Text und in Ailoot Ultra unter der genauen ID cogview-4 verfügbar. Geben Sie eine Szenenbeschreibung an, um eine Illustration, eine Produktinszenierung oder ein visuelles Konzept zu erstellen. Zu den dokumentierten Steuerungen gehören Bildgröße, die Qualität standard oder hd und watermark_enabled; die Antwort liefert Bild-URLs, die alle gespeichert werden sollten.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
CogView 4 setzt eine schriftliche Bildbeschreibung in Bildausgaben um. Wählen Sie cogview-4 in POST /v1/images/generations und geben Sie prompt als Textzeichenfolge an. Die erforderlichen Eingaben sind model und prompt. Beschreiben Sie in der Aufgabenbeschreibung das Hauptmotiv, seine Platzierung, die umgebende Szene und die visuelle Gestaltung, die Sie beurteilen möchten.
Beschreiben Sie bei einer Produktinszenierung das Objekt, die Oberfläche darunter, den Hintergrund und die Lichtrichtung. Geben Sie für eine Illustration die Figuren oder Objekte, die gewünschte Stimmung und die Komposition an. Wenn das Bild neben einer Überschrift oder Produktbeschreibung stehen soll, nennen Sie die Stelle, an der die Komposition freien Raum lassen soll. Prüfen Sie das Ergebnis anhand dieser konkreten Anforderungen, bevor Sie es in einem Layout verwenden.
Die CogView-spezifischen Größenhinweise nennen 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 und 720x1440. Die Vorgaben für benutzerdefinierte Größen sehen Seitenlängen zwischen 512 und 2048 Pixeln vor, die durch 16 teilbar sind, bei insgesamt höchstens 2^21 Pixeln. Stimmen Sie den Bildausschnitt auf die Platzierung ab: Eine Illustration im Hochformat, eine quadratische Produktszene und ein breites Motiv erfordern sowohl unterschiedliche Kompositionen als auch unterschiedliche Abmessungen.
quality akzeptiert standard oder hd, wobei standard als CogView-Standardwert dokumentiert ist. watermark_enabled ist ein boolescher Wert mit dem dokumentierten Standardwert true. Eine optionale user_id-Zeichenfolge identifiziert den Endnutzer und muss 6 bis 128 Zeichen enthalten. Halten Sie diese Kennung vom kreativen Prompt getrennt. Änderungen an quality oder size sollten einem klaren Verwendungszweck des Bildes dienen und nicht die Beschreibung dessen ersetzen, was zu sehen sein soll.
Die Generierung liefert eine synchrone JSON-Antwort mit created und data. Jedes data[]-Element enthält eine url. Laden Sie jedes zurückgegebene Bild herunter und bewahren Sie die Antwort zusammen mit der Aufgabenbeschreibung und den gewählten Einstellungen auf; behalten Sie nicht nur das erste Element, bloß weil eine Vorschau ein Bild zeigt. Der dokumentierte Vertrag führt für diese Bildanfrage keinen separaten Schritt zum Abfragen eines Auftrags wie bei Videos ein. Wird die Antwort unterbrochen oder bleibt sie unvollständig, bewahren Sie die ursprünglichen Anfrageinformationen und das empfangene Ergebnis auf, bevor Sie entscheiden, ob eine weitere Erstellungsanfrage angebracht ist. Ailoot speichert diese Bilder als dem eigenen Ailoot-Konto zugeordnete Medien-Assets und gibt signierte Ailoot-Links zurück. Finden Sie die Asset-Datensätze über GET /v1/media/assets?family=image und folgen Sie dabei jedem next_cursor. Lesen Sie GET /v1/media/assets/{asset_id} mit jeder tatsächlichen asset_id, um deren content_url zu erhalten; lesen Sie dasselbe Asset erneut, wenn dessen signierter Link abläuft.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Start
CogView 4 ist Zhipus Modell zur Bilderzeugung aus Text und in Ailoot Ultra unter der genauen ID cogview-4 verfügbar. Geben Sie eine Szenenbeschreibung an, um eine Illustration, eine Produktinszenierung oder ein visuelles Konzept zu erstellen. Zu den dokumentierten Steuerungen gehören Bildgröße, die Qualität standard oder hd und watermark_enabled; die Antwort liefert Bild-URLs, die alle gespeichert werden sollten.
- Zulässige Eingaben
- Text
- Ergebnisse
- Bilder
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Images POST /v1/images/generations
- Eingabetypen
text- Ausgabetypen
image- Ausgabeformat
- Bilddatei
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits cogview-4 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldsize | Typstring | AnforderungOptional | Werte und Limits 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Standard1280x1280 |
Felduser_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldquality | Typstring | AnforderungOptional | Werte und Limits hd, standard | Standard— |
Feldwatermark_enabled | Typboolean | AnforderungOptional | Werte und Limits | Standardtrue |
Feldstream | Typboolean | AnforderungOptional | Werte und Limits false | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt |
Parameteroptional | Vertragsize, user_id, quality, watermark_enabled, stream |
Parametermaterial_types | Vertragtext |
Parameterconditions | VertragUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Gebühr |
|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationEstimated generation cost | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Gebühr Eingabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.09 Schätzung vor der Generierung This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "cogview-4", "prompt": "A calm studio product photograph with a plain background."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Ergebnisse abrufen und speichern
Ailoot Ultra · Images
Laden Sie jedes zurückgegebene Bild herunter oder speichern Sie seinen Base64-Inhalt
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Bild; rufen Sie jede zurückgegebene URL ab oder dekodieren Sie seinen Base64-Inhalt.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Wenn die ursprüngliche Antwort geprüft werden muss
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasnamen
Modellaliasnamen
Ailoot Ultra cogview-4
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Zhipu: CogView 4
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/images/generations·cogview-4:text→image- Welche Felder verwendet die Anfrage?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream