Zhipu: CogView 4
CogView 4 is het tekst-naar-beeldmodel van Zhipu, beschikbaar in Ailoot Ultra onder de exacte ID cogview-4. Lever een scènebeschrijving aan om een illustratie, productomgeving of visueel concept te maken. De gedocumenteerde instellingen omvatten afbeeldingsgrootte, kwaliteit standard of hd en watermark_enabled; het antwoord levert afbeeldings-URL's die allemaal moeten worden opgeslagen.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
CogView 4 zet een geschreven beeldbriefing om in afbeeldingen. Selecteer cogview-4 in POST /v1/images/generations en geef prompt op als een tekenreeks met tekst. De vereiste invoervelden zijn model en prompt. Gebruik de briefing om het hoofdonderwerp, de plaatsing ervan, de omringende scène en de visuele uitwerking die je wilt beoordelen te beschrijven.
Beschrijf voor een productomgeving het object, het oppervlak eronder, de achtergrond en de richting van het licht. Geef voor een illustratie de personages of objecten, de beoogde sfeer en de compositie aan. Als de afbeelding naast een kop of productbeschrijving komt te staan, vermeld dan waar de compositie ruimte moet vrijlaten. Beoordeel het resultaat aan de hand van die concrete eisen voordat je het in een lay-out gebruikt.
De CogView-specifieke richtlijnen voor afmetingen noemen 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 en 720x1440. Voor aangepaste afmetingen moet elke zijde tussen 512 en 2048 pixels liggen, deelbaar zijn door 16 en mag het totale aantal pixels niet groter zijn dan 2^21. Stem de kadrering af op de plaatsing: een staande illustratie, een vierkante productscène en een breed beeld vragen zowel om verschillende composities als om verschillende afmetingen.
quality accepteert standard of hd, waarbij standard de gedocumenteerde standaardwaarde voor CogView is. watermark_enabled is een booleaanse waarde met true als gedocumenteerde standaardwaarde. Een optionele user_id-tekenreeks identificeert de eindgebruiker en moet 6 tot 128 tekens bevatten. Houd die identificatie gescheiden van de creatieve prompt. Wijzigingen in kwaliteit of afmetingen moeten samengaan met een duidelijk beoogd gebruik voor de afbeelding, in plaats van de beschrijving te vervangen van wat zichtbaar moet zijn.
De generatie retourneert een synchroon JSON-antwoord met created en data. Elk data[]-item bevat een url. Download elke geretourneerde afbeelding en bewaar het antwoord met de briefing en de gekozen instellingen; bewaar niet alleen het eerste item omdat een voorbeeldweergave één afbeelding toont. Het gedocumenteerde contract introduceert voor dit afbeeldingsverzoek geen afzonderlijke stap voor het opvragen van de taakstatus zoals bij video. Als het antwoord wordt onderbroken of onvolledig is, bewaar dan de oorspronkelijke verzoekinformatie en het ontvangen resultaat voordat je beslist of een volgend creatieverzoek passend is. Ailoot slaat deze afbeeldingen op als media-assets in eigendom en retourneert ondertekende Ailoot-links. Zoek de assetrecords via GET /v1/media/assets?family=image en volg elke next_cursor. Lees GET /v1/media/assets/{asset_id} met elke daadwerkelijke asset_id om de content_url op te halen; lees dezelfde asset opnieuw als de ondertekende link verloopt.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Aan de slag
CogView 4 is het tekst-naar-beeldmodel van Zhipu, beschikbaar in Ailoot Ultra onder de exacte ID cogview-4. Lever een scènebeschrijving aan om een illustratie, productomgeving of visueel concept te maken. De gedocumenteerde instellingen omvatten afbeeldingsgrootte, kwaliteit standard of hd en watermark_enabled; het antwoord levert afbeeldings-URL's die allemaal moeten worden opgeslagen.
- Toegestane invoer
- Tekst
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Images POST /v1/images/generations
- Invoer
text- Uitvoer
image- Uitvoerformaat
- Afbeeldingsbestand
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten cogview-4 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Standaard1280x1280 |
Velduser_id | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldquality | Typestring | VereisteOptioneel | Waarden en limieten hd, standard | Standaard— |
Veldwatermark_enabled | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardtrue |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten false | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parameteroptional | Contractsize, user_id, quality, watermark_enabled, stream |
Parametermaterial_types | Contracttext |
Parameterconditions | ContractUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieEstimated generation cost | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kosten Invoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.09 schatting vóór generatie This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
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.
Resultaten ophalen en opslaan
Ailoot Ultra · Images
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasnamen
Modelaliasnamen
Ailoot Ultra cogview-4
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · Zhipu: CogView 4
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·cogview-4:text→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream