Zhipu: CogView 4
CogView 4 er Zhipus tekst-til-billede-model, der er tilgængelig i Ailoot Ultra under det præcise ID cogview-4. Angiv en scenebeskrivelse for at skabe en illustration, en produktopsætning eller et visuelt koncept. De dokumenterede indstillinger omfatter billedstørrelse, kvaliteten standard eller hd samt watermark_enabled; svaret leverer billed-URL'er, som alle bør gemmes.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
CogView 4 omdanner en skriftlig billedbeskrivelse til billeder. Vælg cogview-4 i POST /v1/images/generations, og angiv prompt som en tekststreng. De obligatoriske input er model og prompt. Brug beskrivelsen til at forklare hovedmotivet, dets placering, den omgivende scene og det visuelle udtryk, du vil vurdere.
Til en produktopsætning skal du beskrive genstanden, underlaget, baggrunden og lysets retning. Til en illustration skal du angive figurerne eller genstandene, den ønskede stemning og kompositionen. Hvis billedet skal stå ved siden af en overskrift eller produktbeskrivelse, skal du angive, hvor kompositionen skal efterlade fri plads. Gennemgå resultatet i forhold til disse konkrete krav, før du bruger det i et layout.
Den CogView-specifikke vejledning om size angiver 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 og 720x1440. Vejledningen om tilpassede størrelser kræver, at hver side er mellem 512 og 2048 pixels og delelig med 16, og at der højst er 2^21 pixels i alt. Tilpas udsnittet til placeringen: en stående illustration, en kvadratisk produktscene og et bredt billede kræver både forskellige kompositioner og forskellige dimensioner.
quality accepterer standard eller hd, og standard er dokumenteret som CogViews standardværdi. watermark_enabled er en boolesk værdi med en dokumenteret standardværdi på true. Den valgfrie user_id-streng identificerer slutbrugeren og skal indeholde 6 til 128 tegn. Hold denne identifikator adskilt fra den kreative prompt. Ændringer af kvalitet eller størrelse bør ledsages af et klart tilsigtet formål med billedet frem for at erstatte beskrivelsen af det, der skal vises.
Genereringen returnerer et synkront JSON-svar, der indeholder created og data. Hvert data[]-element indeholder en url. Download alle returnerede billeder, og gem svaret sammen med beskrivelsen og de valgte indstillinger; behold ikke kun det første element, blot fordi en forhåndsvisning viser ét billede. Den dokumenterede kontrakt indfører ikke et separat jobpollingtrin i videostil for denne billedanmodning. Hvis svaret afbrydes eller er ufuldstændigt, skal du gemme de oprindelige anmodningsoplysninger og det modtagne resultat, før du afgør, om endnu en oprettelsesanmodning er passende. Ailoot gemmer disse billeder som medieaktiver, du ejer, og returnerer signerede Ailoot-links. Find aktivregistreringerne via GET /v1/media/assets?family=image, og følg hver next_cursor. Læs GET /v1/media/assets/{asset_id} med hvert faktisk asset_id for at få dets content_url; læs det samme aktiv igen, hvis det signerede link udløber.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Start
CogView 4 er Zhipus tekst-til-billede-model, der er tilgængelig i Ailoot Ultra under det præcise ID cogview-4. Angiv en scenebeskrivelse for at skabe en illustration, en produktopsætning eller et visuelt koncept. De dokumenterede indstillinger omfatter billedstørrelse, kvaliteten standard eller hd samt watermark_enabled; svaret leverer billed-URL'er, som alle bør gemmes.
- Accepterede input
- Tekst
- Resultater
- Billeder
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Images POST /v1/images/generations
- Inputtyper
text- Outputtyper
image- Outputformat
- Billedfil
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser cogview-4 | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser | Standard— |
Feltsize | Typestring | KravValgfrit | Værdier og grænser 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Standard1280x1280 |
Feltuser_id | Typestring | KravValgfrit | Værdier og grænser | Standard— |
Feltquality | Typestring | KravValgfrit | Værdier og grænser hd, standard | Standard— |
Feltwatermark_enabled | Typeboolean | KravValgfrit | Værdier og grænser | Standardtrue |
Feltstream | Typeboolean | KravValgfrit | Værdier og grænser false | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parameteroptional | Kontraktsize, user_id, quality, watermark_enabled, stream |
Parametermaterial_types | Kontrakttext |
Parameterconditions | KontraktUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Beløb |
|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| KonfigurationEstimated generation cost | Takstplan— | Forventet mængdeestimat for én generering | Beløb Input · Anslået genereringsomkostning · Estimat kun til sammenligning $0.09 estimat før generering This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
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.
Hent og gem resultater
Ailoot Ultra · Images
Hent hvert returneret billede, eller gem dets Base64-indhold
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behold alle færdige resultater
Gem hvert færdigt billede; hent hver returneret URL eller afkod dets Base64-indhold.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Hvis det oprindelige svar skal kontrolleres
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliaser
Modelaliaser
Ailoot Ultra cogview-4
Aliaser for metodestier
Brug metodestierne vist ovenfor.
Relaterede kalder-ID’er
FAQ · Zhipu: CogView 4
- Hvilke input og resultater er tilgængelige?
POST /v1/images/generations·cogview-4:text→image- Hvilke felter bruger anmodningen?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream