Zhipu: CogView 4
A CogView 4 a Zhipu szövegből képet létrehozó modellje, amely az Ailoot Ultra felületén a pontos cogview-4 azonosítóval érhető el. Jelenetleírás megadásával készíthet illusztrációt, termékkörnyezetet vagy vizuális koncepciót. Dokumentált vezérlői között szerepel a képméret, a standard vagy hd minőség és a watermark_enabled; a válasz kép-URL-eket ad vissza, amelyeket mind el kell menteni.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A CogView 4 az írásos képleírást képi eredményekké alakítja. A POST /v1/images/generations kérésben válassza a cogview-4 modellt, és a prompt mezőt szöveges karakterláncként adja meg. A kötelező bemenetek a model és a prompt. A leírásban határozza meg a fő témát, annak elhelyezését, a környező jelenetet és az értékelni kívánt vizuális megjelenítést.
Termékkörnyezethez írja le a tárgyat, az alatta lévő felületet, a hátteret és a fény irányát. Illusztrációhoz adja meg a szereplőket vagy tárgyakat, a kívánt hangulatot és a kompozíciót. Ha a kép egy főcím vagy termékleírás mellett jelenik meg, jelezze, hol hagyjon a kompozíció szabad teret. Mielőtt elrendezésben használná, ellenőrizze az eredményt ezekhez a konkrét követelményekhez mérten.
A CogView méretre vonatkozó útmutatója a 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 és 720x1440 méreteket sorolja fel. Az egyedi méretre vonatkozó útmutató szerint minden oldalnak 512 és 2048 pixel között kell lennie, 16-tal oszthatónak kell lennie, és az összes pixelszám legfeljebb 2^21 lehet. A képkivágást igazítsa az elhelyezéshez: egy álló illusztráció, egy négyzetes termékjelenet és egy széles vizuális elem eltérő kompozíciót és eltérő méreteket kíván.
A quality értéke standard vagy hd lehet, a dokumentáció szerint a CogView alapértéke standard. A watermark_enabled logikai érték, dokumentált alapértéke true. Az opcionális user_id karakterlánc a végfelhasználót azonosítja, és 6–128 karakterből kell állnia. Ezt az azonosítót tartsa külön a kreatív prompttól. A minőség vagy a méret módosítása a kép egyértelmű felhasználási céljához kapcsolódjon, és ne helyettesítse annak leírását, hogy mi jelenjen meg.
A generálás szinkron JSON-választ ad vissza created és data mezőkkel. Minden data[] elem tartalmaz egy url értéket. Töltse le az összes visszaadott képet, és őrizze meg a választ a leírással és a választott beállításokkal együtt; ne csak az első elemet tartsa meg azért, mert az előnézet egyetlen képet mutat. A dokumentált szerződés ehhez a képkéréshez nem vezet be külön, a videóknál megszokott feladatállapot-lekérdezési lépést. Ha a válasz megszakad vagy hiányos, őrizze meg az eredeti kérés adatait és a beérkezett eredményt, mielőtt eldönti, indokolt-e újabb létrehozási kérés. Az Ailoot ezeket a képeket a felhasználóhoz tartozó médiaelemként tárolja, és aláírt Ailoot-hivatkozásokat ad vissza. A médiaelemek rekordjait a GET /v1/media/assets?family=image végponton keresse meg, minden next_cursor értéket követve. Minden tényleges asset_id értékkel olvassa ki a GET /v1/media/assets/{asset_id} végpontot a content_url lekéréséhez; ha az aláírt hivatkozás lejár, olvassa ki újra ugyanazt a médiaelemet.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Kezdő lépések
A CogView 4 a Zhipu szövegből képet létrehozó modellje, amely az Ailoot Ultra felületén a pontos cogview-4 azonosítóval érhető el. Jelenetleírás megadásával készíthet illusztrációt, termékkörnyezetet vagy vizuális koncepciót. Dokumentált vezérlői között szerepel a képméret, a standard vagy hd minőség és a watermark_enabled; a válasz kép-URL-eket ad vissza, amelyeket mind el kell menteni.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Képek
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Images POST /v1/images/generations
- Bemenet
text- Kimenet
image- Kimeneti formátum
- Képfájl
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok cogview-4 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezősize | Típusstring | KövetelményOpcionális | Értékek és korlátok 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Alapértelmezett1280x1280 |
Mezőuser_id | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőquality | Típusstring | KövetelményOpcionális | Értékek és korlátok hd, standard | Alapértelmezett— |
Mezőwatermark_enabled | Típusboolean | KövetelményOpcionális | Értékek és korlátok | Alapértelmezetttrue |
Mezőstream | Típusboolean | KövetelményOpcionális | Értékek és korlátok false | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paraméteroptional | Szerződéssize, user_id, quality, watermark_enabled, stream |
Paramétermaterial_types | Szerződéstext |
Paraméterconditions | SzerződésUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításEstimated generation cost | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Bemenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.09 becslés a generálás előtt This estimate is not an additional charge or a fixed rate for the completed generation. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
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.
Eredmények fogadása és mentése
Ailoot Ultra · Images
Töltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Ha az eredeti választ ellenőrizni kell
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Álnevek
Modell álnevei
Ailoot Ultra cogview-4
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Zhipu: CogView 4
- Milyen bemenetek és eredmények érhetők el?
POST /v1/images/generations·cogview-4:text→image- Mely mezőket használja a kérés?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream