Zhipu: CogView 4 250304
CogView 4 250304 is the separately named CogView 4 selector cogview-4-250304 for text-to-image work. Use it when a workflow needs this exact model identity, with a written scene brief, CogView-specific dimensions, quality and watermark settings. It returns image URLs through a synchronous image-generation response.
About the model
This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.
CogView 4 250304 is Zhipu's named cogview-4-250304 model in the CogView image-generation family. Use the complete selector when this is the edition you want to preserve in a creative workflow. Its Ailoot Ultra method is POST /v1/images/generations, with model and prompt as the required string fields. The input for this profile is a written image description.
Prepare the brief around a visible deliverable. An editorial illustration might describe a person waiting at a station, the weather, the relationship between the subject and background, and the desired colour treatment. For a product scene, name the product arrangement, viewpoint, surface and lighting. Explain which details matter most, then compare those details with the generated file. Keeping the brief and exact selector together makes later revisions easier to assess.
The CogView-specific dimension guidance includes square 1024x1024, portrait 768x1344 or 864x1152, landscape 1344x768 or 1152x864, and wide or tall 1440x720 or 720x1440. For custom dimensions, each side is between 512 and 2048 pixels, each is divisible by 16, and the total pixel count cannot exceed 2^21. Plan the subject placement for the chosen frame instead of treating a change of dimensions as a simple crop.
The documented quality values are standard and hd; the CogView default is standard. watermark_enabled controls the watermark and defaults to true. The optional user_id is a 6-to-128-character string for the end-user identifier. Preserve the selected quality and watermark settings with the result, especially when collecting several candidates for the same design task.
The image request completes synchronously with created and a data array whose items contain url. Save each actual returned image and retain the complete response. A group of returned URLs is the output set; selecting one preferred image for a layout should not discard the others from the generation record. Keep the original request and response information when a connection ends before the complete result is known, and check the existing result before making another creation request. Ailoot stores these images as owned media assets and returns signed Ailoot links. Find the asset records through GET /v1/media/assets?family=image, following every next_cursor. Read GET /v1/media/assets/{asset_id} with each actual asset_id to obtain its content_url; read that same asset again if its signed link expires.
Ailoot Ultra · Images POST /v1/images/generations cogview-4-250304
cogview-4-250304Overview
CogView 4 250304 is the separately named CogView 4 selector cogview-4-250304 for text-to-image work. Use it when a workflow needs this exact model identity, with a written scene brief, CogView-specific dimensions, quality and watermark settings. It returns image URLs through a synchronous image-generation response.
- Accepted inputs
- Text
- Results
- Images
Available in Ailoot · inputs & methods
Ailoot Ultra · Images POST /v1/images/generations
- Input types
text- Output types
image- Output format
- Image file
| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits cogview-4-250304 | Default— |
Fieldprompt | Typestring | RequirementRequired | Values & limits | Default— |
Fieldsize | Typestring | RequirementOptional | Values & limits 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Default1280x1280 |
Fielduser_id | Typestring | RequirementOptional | Values & limits | Default— |
Fieldquality | Typestring | RequirementOptional | Values & limits hd, standard | Default— |
Fieldwatermark_enabled | Typeboolean | RequirementOptional | Values & limits | Defaulttrue |
Fieldstream | Typeboolean | RequirementOptional | Values & limits false | Default— |
Method parameters and lifecycle
| 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. |
Lifecycle: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Pricing
How the final charge is calculated
The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.
Tariff references do not add request options. Supported parameters are listed for the selected method.
- Fast mode
- Not specified When fast mode is selected
- Flex mode
- Not specified When flex mode is selected
- Maximum reasoning effort
- Not specified When maximum reasoning effort uses the default adjustment
Estimated rates for comparison
Prices by configuration
Match each charge to the conditions shown. Use one rate for each set of alternative configurations.
| Configuration | Rate schedule | Forecast quantity | Charge |
|---|---|---|---|
| ConfigurationBase token rates | Rate scheduleBase rate | Forecast quantity— | Charge Input · Input tokens · Estimate for comparison only — / 1K tokens Output · Output tokens · Estimate for comparison only — / 1K tokens Input · Cache read · Estimate for comparison only — / 1K tokens Input · Cache write · Estimate for comparison only — / 1K tokens Input · Cache write, 1 hour · Estimate for comparison only — / 1K tokens |
| ConfigurationEstimated generation cost | Rate schedule— | Forecast quantityone generation estimate | Charge Input · Estimated generation cost · Estimate for comparison only $0.09 estimate before generation This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →
Example requests
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-250304", "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.
Receive and save results
Ailoot Ultra · Images
Download each returned image or save its Base64 contents
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Keep all completed results
Save every completed image; retrieve each returned URL or decode its Base64 contents.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
If the original response needs checking
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliases
Model aliases
Ailoot Ultra cogview-4-250304
Method path aliases
Use the method paths shown above.
Related caller IDs
FAQ · Zhipu: CogView 4 250304
- What inputs and results are available?
POST /v1/images/generations·cogview-4-250304:text→image- Which fields does the request use?
POST /v1/images/generations·cogview-4-250304:model,prompt,size,user_id,quality,watermark_enabled,stream