Zhipu: CogView 4
CogView 4 är Zhipus modell för text till bild, tillgänglig i Ailoot Ultra under det exakta ID:t cogview-4. Ange en scenbeskrivning för att skapa en illustration, en produktmiljö eller ett visuellt koncept. De dokumenterade inställningarna omfattar bildstorlek, kvaliteten standard eller hd samt watermark_enabled; svaret innehåller bild-URL:er som alla bör sparas.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
CogView 4 omvandlar en skriftlig bildbeskrivning till bilder. Välj cogview-4 i POST /v1/images/generations och ange prompt som en textsträng. De obligatoriska indatafälten är model och prompt. Använd beskrivningen för att ange huvudmotivet, dess placering, den omgivande scenen och den visuella behandling du vill utvärdera.
För en produktmiljö beskriver du föremålet, ytan under det, bakgrunden och ljusets riktning. För en illustration anger du personer eller föremål, den avsedda stämningen och kompositionen. Om bilden ska placeras bredvid en rubrik eller produktbeskrivning anger du var kompositionen ska lämna fri yta. Granska resultatet mot dessa konkreta krav innan du använder det i en layout.
Den CogView-specifika storleksanvisningen anger 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 och 720x1440. Anvisningen för anpassade storlekar anger att varje sida ska vara mellan 512 och 2048 pixlar, delbar med 16, med totalt högst 2^21 pixlar. Anpassa inramningen till placeringen: en stående illustration, en kvadratisk produktscen och en bred bild kräver olika kompositioner såväl som olika mått.
quality accepterar standard eller hd, där standard anges som CogViews standardvärde. watermark_enabled är ett booleskt värde med det dokumenterade standardvärdet true. En valfri user_id-sträng identifierar slutanvändaren och måste innehålla 6 till 128 tecken. Håll den identifieraren åtskild från den kreativa prompten. Ändringar av kvalitet eller storlek bör åtföljas av ett tydligt avsett användningsområde för bilden, snarare än ersätta beskrivningen av vad som ska synas.
Genereringen returnerar ett synkront JSON-svar som innehåller created och data. Varje data[]-objekt innehåller en url. Hämta varje returnerad bild och behåll svaret tillsammans med beskrivningen och de valda inställningarna; behåll inte bara det första objektet för att en förhandsvisning visar en enda bild. Det dokumenterade kontraktet inför inget separat steg för jobbpollning av videotyp för denna bildförfrågan. Om svaret avbryts eller är ofullständigt behåller du informationen om den ursprungliga förfrågan och det mottagna resultatet innan du avgör om en ytterligare skapandeförfrågan är lämplig. Ailoot lagrar dessa bilder som ägda medietillgångar och returnerar signerade Ailoot-länkar. Hitta tillgångsposterna via GET /v1/media/assets?family=image och följ varje next_cursor. Läs GET /v1/media/assets/{asset_id} med varje faktiskt asset_id för att få dess content_url; läs samma tillgång igen om dess signerade länk har gått ut.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Start
CogView 4 är Zhipus modell för text till bild, tillgänglig i Ailoot Ultra under det exakta ID:t cogview-4. Ange en scenbeskrivning för att skapa en illustration, en produktmiljö eller ett visuellt koncept. De dokumenterade inställningarna omfattar bildstorlek, kvaliteten standard eller hd samt watermark_enabled; svaret innehåller bild-URL:er som alla bör sparas.
- Godkända indata
- Text
- Resultat
- Bilder
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Images POST /v1/images/generations
- Indatatyper
text- Utdatatyper
image- Utdataformat
- Bildfil
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser cogview-4 | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser | Standard— |
Fältsize | Typstring | KravValfritt | Värden & gränser 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Standard1280x1280 |
Fältuser_id | Typstring | KravValfritt | Värden & gränser | Standard— |
Fältquality | Typstring | KravValfritt | Värden & gränser hd, standard | Standard— |
Fältwatermark_enabled | Typboolean | KravValfritt | Värden & gränser | Standardtrue |
Fältstream | Typboolean | KravValfritt | Värden & gränser false | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parameteroptional | Avtalsize, user_id, quality, watermark_enabled, stream |
Parametermaterial_types | Avtaltext |
Parameterconditions | AvtalUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationEstimated generation cost | Prislista— | Prognostiserad mängduppskattning för en generering | Avgift Indata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.09 uppskattning före generering This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
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.
Ta emot och spara resultat
Ailoot Ultra · Images
Ladda ned varje returnerad bild eller spara dess Base64-innehåll
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behåll alla färdiga resultat
Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Om det ursprungliga svaret behöver kontrolleras
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Modellalias
Ailoot Ultra cogview-4
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · Zhipu: CogView 4
- Vilka indata och resultat finns?
POST /v1/images/generations·cogview-4:text→image- Vilka fält använder begäran?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream