Zhipu: CogView 4
CogView 4 je model Zhipu na vytváranie obrázkov z textu, dostupný v Ailoot Ultra pod presným ID cogview-4. Dodajte opis scény a vytvorte ilustráciu, produktovú scénu alebo vizuálny koncept. Jeho zdokumentované nastavenia zahŕňajú veľkosť obrázka, kvalitu standard alebo hd a watermark_enabled; odpoveď poskytuje URL obrázkov, ktoré treba všetky uložiť.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
CogView 4 premieňa písomné obrazové zadanie na obrázky. V POST /v1/images/generations vyberte cogview-4 a zadajte prompt ako textový reťazec. Povinné vstupy sú model a prompt. V zadaní opíšte hlavný motív, jeho umiestnenie, okolitú scénu a výtvarné spracovanie, ktoré chcete posúdiť.
Pri produktovej scéne opíšte predmet, povrch pod ním, pozadie a smer svetla. Pri ilustrácii určte postavy alebo predmety, zamýšľanú náladu a kompozíciu. Ak sa obrázok použije vedľa nadpisu alebo opisu produktu, uveďte, kde má kompozícia ponechať voľný priestor. Pred použitím v rozložení porovnajte výsledok s týmito konkrétnymi požiadavkami.
Pokyny k veľkosti pre CogView uvádzajú 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 a 720x1440. Pri vlastnej veľkosti musí mať každá strana 512 až 2048 pixelov, byť deliteľná 16 a celkový počet pixelov nesmie prekročiť 2^21. Rámovanie prispôsobte zamýšľanému umiestneniu: ilustrácia na výšku, štvorcová produktová scéna a široký vizuál vyžadujú odlišné kompozície aj rozmery.
quality prijíma standard alebo hd, pričom zdokumentovaná predvolená hodnota CogView je standard. watermark_enabled je booleovská hodnota so zdokumentovanou predvolenou hodnotou true. Voliteľný reťazec user_id identifikuje koncového používateľa a musí obsahovať 6 až 128 znakov. Tento identifikátor udržiavajte oddelene od tvorivého zadania. Zmeny kvality alebo veľkosti majú vychádzať z jasného zamýšľaného použitia obrázka a nemajú nahrádzať opis toho, čo má zobrazovať.
Generovanie vracia synchrónnu odpoveď JSON obsahujúcu created a data. Každá položka data[] poskytuje url. Stiahnite všetky vrátené obrázky a uchovajte odpoveď spolu so zadaním a vybranými nastaveniami; neuchovávajte iba prvú položku len preto, že náhľad ukazuje jeden obrázok. Zdokumentovaný kontrakt pri tejto požiadavke na obrázok nezavádza samostatný krok zisťovania stavu úlohy ako pri videu. Ak je odpoveď prerušená alebo neúplná, uchovajte informácie o pôvodnej požiadavke a prijatý výsledok, až potom posúďte vhodnosť ďalšej požiadavky na vytvorenie. Ailoot ukladá tieto obrázky ako mediálne súbory vo vašom vlastníctve a vracia podpísané odkazy Ailoot. Záznamy súborov vyhľadajte cez GET /v1/media/assets?family=image a prejdite každú hodnotu next_cursor. Pomocou každého skutočného asset_id načítajte GET /v1/media/assets/{asset_id} a získajte jeho content_url; ak platnosť podpísaného odkazu uplynie, načítajte ten istý súbor znova.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Úvod
CogView 4 je model Zhipu na vytváranie obrázkov z textu, dostupný v Ailoot Ultra pod presným ID cogview-4. Dodajte opis scény a vytvorte ilustráciu, produktovú scénu alebo vizuálny koncept. Jeho zdokumentované nastavenia zahŕňajú veľkosť obrázka, kvalitu standard alebo hd a watermark_enabled; odpoveď poskytuje URL obrázkov, ktoré treba všetky uložiť.
- Povolené vstupy
- Text
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Images POST /v1/images/generations
- Vstup
text- Výstup
image- Výstupný formát
- Súbor obrázka
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity cogview-4 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polesize | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Predvolené1280x1280 |
Poleuser_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polequality | Typstring | PožiadavkaVoliteľné | Hodnoty a limity hd, standard | Predvolené— |
Polewatermark_enabled | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenétrue |
Polestream | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity false | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parameteroptional | Špecifikáciasize, user_id, quality, watermark_enabled, stream |
Parametermaterial_types | Špecifikáciatext |
Parameterconditions | ŠpecifikáciaUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaEstimated generation cost | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Poplatok Vstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.09 odhad pred generovaním This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
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.
Prijať a uložiť výsledky
Ailoot Ultra · Images
Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovať všetky dokončené výsledky
Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Ak treba overiť pôvodnú odpoveď
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasy
Aliasy modelov
Ailoot Ultra cogview-4
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Zhipu: CogView 4
- Aké vstupy a výsledky sú dostupné?
POST /v1/images/generations·cogview-4:text→image- Aké polia používa požiadavka?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream