Zhipu: CogView 4
CogView 4 je model Zhipu pro převod textu na obrázek, dostupný v Ailoot Ultra pod přesným ID cogview-4. Zadejte popis scény a vytvořte ilustraci, produktovou scénu nebo vizuální koncept. Jeho dokumentované ovládací prvky zahrnují velikost obrázku, kvalitu standard nebo hd a watermark_enabled; odpověď poskytuje URL obrázků, které je třeba všechny uložit.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
CogView 4 převádí písemné zadání obrázku na obrazové výstupy. V POST /v1/images/generations vyberte cogview-4 a zadejte prompt jako textový řetězec. Povinnými vstupy jsou model a prompt. V zadání popište hlavní objekt, jeho umístění, okolní scénu a vizuální zpracování, které chcete posoudit.
U produktové scény popište předmět, povrch pod ním, pozadí a směr světla. U ilustrace určete postavy nebo předměty, zamýšlenou náladu a kompozici. Pokud bude obrázek umístěn vedle titulku nebo popisu produktu, uveďte, kde má kompozice ponechat volný prostor. Před použitím v návrhu výsledek porovnejte s těmito konkrétními požadavky.
Pokyny k velikosti specifické pro CogView uvádějí 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 a 720x1440. Podle pokynů k vlastní velikosti musí mít každá strana mezi 512 a 2048 pixely, být dělitelná 16 a celkový počet pixelů nesmí přesáhnout 2^21. Přizpůsobte rámování umístění: portrétní ilustrace, čtvercová produktová scéna a široký vizuál vyžadují různé kompozice i různé rozměry.
quality přijímá standard nebo hd, přičemž standard je dokumentovanou výchozí hodnotou CogView. watermark_enabled je booleovská hodnota s dokumentovanou výchozí hodnotou true. Volitelný řetězec user_id označuje koncového uživatele a musí obsahovat 6 až 128 znaků. Tento identifikátor uchovávejte odděleně od tvůrčího zadání. Změny kvality nebo velikosti mají doprovázet jasný zamýšlený účel obrázku, místo aby nahrazovaly popis toho, co se má zobrazit.
Generování vrací synchronní odpověď JSON obsahující created a data. Každá položka data[] poskytuje url. Stáhněte všechny vrácené obrázky a uchovejte odpověď se zadáním a zvoleným nastavením; neponechávejte pouze první položku jen proto, že náhled zobrazuje jeden obrázek. Dokumentovaný kontrakt pro tento požadavek na obrázek nezavádí samostatný krok dotazování na stav úlohy jako u videa. Pokud je odpověď přerušená nebo neúplná, uchovejte informace o původním požadavku a přijatý výsledek, než rozhodnete, zda je vhodný další požadavek na vytvoření. Ailoot ukládá tyto obrázky jako vlastněné mediální prostředky a vrací podepsané odkazy Ailoot. Záznamy prostředků vyhledejte přes GET /v1/media/assets?family=image a projděte každý next_cursor. Pomocí každého skutečného asset_id přečtěte GET /v1/media/assets/{asset_id} a získejte jeho content_url; pokud jeho podepsaný odkaz vyprší, přečtěte tentýž prostředek znovu.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Úvod
CogView 4 je model Zhipu pro převod textu na obrázek, dostupný v Ailoot Ultra pod přesným ID cogview-4. Zadejte popis scény a vytvořte ilustraci, produktovou scénu nebo vizuální koncept. Jeho dokumentované ovládací prvky zahrnují velikost obrázku, kvalitu standard nebo hd a watermark_enabled; odpověď poskytuje URL obrázků, které je třeba všechny uložit.
- Přijímané vstupy
- Text
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Images POST /v1/images/generations
- Vstup
text- Výstup
image- Výstupní formát
- Soubor obrázku
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity cogview-4 | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polesize | Typstring | PožadavekVolitelné | Hodnoty a limity 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Výchozí1280x1280 |
Poleuser_id | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polequality | Typstring | PožadavekVolitelné | Hodnoty a limity hd, standard | Výchozí— |
Polewatermark_enabled | Typboolean | PožadavekVolitelné | Hodnoty a limity | Výchozítrue |
Polestream | Typboolean | PožadavekVolitelné | Hodnoty a limity false | Výchozí— |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametroptional | Kontraktsize, user_id, quality, watermark_enabled, stream |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | KontraktUse 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}
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Odhadované sazby pro srovnání
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Poplatek |
|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceEstimated generation cost | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Poplatek Vstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.09 odhad před generováním This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
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.
Přijímání a ukládání výsledků
Ailoot Ultra · Images
Stáhněte každý vrácený obrázek nebo uložte jeho obsah Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovejte všechny dokončené výsledky
Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte 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.
Pokud je nutné ověřit původní odpověď
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasy
Aliasy modelu
Ailoot Ultra cogview-4
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · Zhipu: CogView 4
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/images/generations·cogview-4:text→image- Jaká pole požadavek používá?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream