Zhipu: CogView 4
CogView 4 to model Zhipu tworzący obrazy z tekstu, dostępny w Ailoot Ultra pod dokładnym identyfikatorem cogview-4. Podaj opis sceny, aby stworzyć ilustrację, otoczenie produktu lub koncepcję wizualną. Udokumentowane parametry obejmują rozmiar obrazu, jakość standard lub hd oraz watermark_enabled; odpowiedź zawiera adresy URL obrazów, które należy zapisać w całości.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
CogView 4 przekształca pisemny opis obrazu w obrazy wynikowe. Wybierz cogview-4 w POST /v1/images/generations i podaj prompt jako ciąg tekstowy. Wymagane dane wejściowe to model i prompt. Opisz główny temat, jego położenie, otaczającą scenę oraz sposób przedstawienia, który chcesz ocenić.
W przypadku sceny produktowej opisz przedmiot, powierzchnię pod nim, tło oraz kierunek światła. W przypadku ilustracji określ postacie lub przedmioty, zamierzony nastrój i kompozycję. Jeśli obraz ma znajdować się obok nagłówka lub opisu produktu, wskaż, gdzie w kompozycji ma pozostać wolne miejsce. Przed użyciem w projekcie oceń wynik względem tych konkretnych wymagań.
Wskazówki dotyczące size dla CogView wymieniają 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 i 720x1440. Wskazówki dotyczące rozmiaru niestandardowego określają długość każdego boku od 512 do 2048 pikseli, podzielną przez 16, przy łącznej liczbie pikseli nieprzekraczającej 2^21. Dopasuj kadr do miejsca wykorzystania: pionowa ilustracja, kwadratowa scena produktowa i szeroki obraz wymagają różnych kompozycji, a także różnych wymiarów.
quality przyjmuje standard lub hd; jako domyślną wartość CogView udokumentowano standard. watermark_enabled to wartość logiczna z udokumentowaną wartością domyślną true. Opcjonalny ciąg user_id identyfikuje użytkownika końcowego i musi zawierać od 6 do 128 znaków. Zachowaj ten identyfikator oddzielnie od opisu kreatywnego. Zmianom jakości lub rozmiaru powinno towarzyszyć jasno określone przeznaczenie obrazu; nie zastępują one opisu tego, co ma się na nim pojawić.
Generowanie zwraca synchroniczną odpowiedź JSON zawierającą created i data. Każdy element data[] zawiera url. Pobierz każdy zwrócony obraz i zachowaj odpowiedź wraz z opisem i wybranymi ustawieniami; nie zachowuj wyłącznie pierwszego elementu tylko dlatego, że podgląd pokazuje jeden obraz. Udokumentowany kontrakt nie wprowadza dla tego żądania obrazu oddzielnego etapu odpytywania zadania, stosowanego przy wideo. Jeśli odpowiedź zostanie przerwana lub będzie niepełna, zachowaj informacje o pierwotnym żądaniu i otrzymany wynik, zanim zdecydujesz, czy zasadne jest kolejne żądanie utworzenia obrazu. Ailoot zapisuje te obrazy jako należące do użytkownika zasoby multimedialne i zwraca podpisane łącza Ailoot. Znajdź zapisy zasobów przez GET /v1/media/assets?family=image, przechodząc przez każdy next_cursor. Wywołaj GET /v1/media/assets/{asset_id} z każdym rzeczywistym asset_id, aby uzyskać content_url; odczytaj ponownie ten sam zasób, jeśli jego podpisane łącze wygaśnie.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Start
CogView 4 to model Zhipu tworzący obrazy z tekstu, dostępny w Ailoot Ultra pod dokładnym identyfikatorem cogview-4. Podaj opis sceny, aby stworzyć ilustrację, otoczenie produktu lub koncepcję wizualną. Udokumentowane parametry obejmują rozmiar obrazu, jakość standard lub hd oraz watermark_enabled; odpowiedź zawiera adresy URL obrazów, które należy zapisać w całości.
- Akceptowane dane wejściowe
- Tekst
- Wyniki
- Obrazy
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Images POST /v1/images/generations
- Wejście
text- Wyjście
image- Format wyjściowy
- Plik obrazu
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity cogview-4 | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity | Domyślnie— |
Polesize | Typstring | WymaganieOpcjonalne | Wartości i limity 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Domyślnie1280x1280 |
Poleuser_id | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polequality | Typstring | WymaganieOpcjonalne | Wartości i limity hd, standard | Domyślnie— |
Polewatermark_enabled | Typboolean | WymaganieOpcjonalne | Wartości i limity | Domyślnietrue |
Polestream | Typboolean | WymaganieOpcjonalne | Wartości i limity false | Domyślnie— |
Parametry i cykl życia 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. |
Cykl życia: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cennik
Jak obliczana jest ostateczna opłata
Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Szacunkowe stawki do porównania
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów |
| KonfiguracjaEstimated generation cost | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Opłata Wejście · Szacowany koszt generowania · Szacunek tylko do porównania $0.09 szacunek przed generowaniem This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
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.
Odbieranie i zapisywanie wyników
Ailoot Ultra · Images
Pobierz każdy zwrócony obraz lub zapisz jego zawartość Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Zachowaj wszystkie ukończone wyniki
Zapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość 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.
Jeśli trzeba sprawdzić pierwotną odpowiedź
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 ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · Zhipu: CogView 4
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/images/generations·cogview-4:text→image- Jakich pól używa żądanie?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream