Zhipu: CogView 4
CogView 4 es el modelo de texto a imagen de Zhipu, disponible en Ailoot Ultra con el ID exacto cogview-4. Proporciona una descripción de la escena para crear una ilustración, un entorno para un producto o un concepto visual. Sus controles documentados incluyen el tamaño de imagen, la calidad standard o hd y watermark_enabled; la respuesta proporciona URL de imágenes que deben guardarse todas.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
CogView 4 convierte un encargo escrito de imagen en imágenes de salida. Selecciona cogview-4 en POST /v1/images/generations y proporciona prompt como una cadena de texto. Los datos de entrada obligatorios son model y prompt. Utiliza el encargo para describir el sujeto principal, su ubicación, la escena que lo rodea y el tratamiento visual que quieres evaluar.
Para el entorno de un producto, describe el objeto, la superficie sobre la que se apoya, el fondo y la dirección de la luz. Para una ilustración, especifica los personajes u objetos, el ambiente deseado y la composición. Si la imagen se situará junto a un titular o una descripción de producto, indica dónde debe dejar espacio libre la composición. Revisa el resultado con arreglo a esos requisitos concretos antes de utilizarlo en una maquetación.
Las indicaciones de tamaño específicas de CogView enumeran 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 y 720x1440. Sus indicaciones para tamaños personalizados sitúan cada lado entre 512 y 2048 píxeles, divisible por 16, con un máximo total de 2^21 píxeles. Adapta el encuadre a su ubicación: una ilustración vertical, una escena cuadrada de producto y una imagen horizontal requieren composiciones distintas además de dimensiones distintas.
quality acepta standard o hd, y standard figura como el valor predeterminado de CogView. watermark_enabled es un booleano con un valor predeterminado documentado de true. Una cadena opcional user_id identifica al usuario final y debe contener de 6 a 128 caracteres. Mantén ese identificador separado del prompt creativo. Los cambios de calidad o tamaño deben acompañar a un uso previsto claro de la imagen, en lugar de sustituir la descripción de lo que debe aparecer.
La generación devuelve una respuesta JSON síncrona que contiene created y data. Cada elemento de data[] proporciona una url. Descarga todas las imágenes devueltas y conserva la respuesta junto con el encargo y los ajustes seleccionados; no conserves únicamente el primer elemento porque una vista previa muestre una imagen. El contrato documentado no introduce un paso independiente de consulta del estado de un trabajo, como el de los vídeos, para esta solicitud de imagen. Si la respuesta se interrumpe o está incompleta, conserva la información de la solicitud original y el resultado recibido antes de decidir si procede realizar otra solicitud de creación. Ailoot almacena estas imágenes como recursos multimedia en propiedad y devuelve enlaces firmados de Ailoot. Busca los registros de los recursos mediante GET /v1/media/assets?family=image, siguiendo todos los next_cursor. Consulta GET /v1/media/assets/{asset_id} con cada asset_id real para obtener su content_url; vuelve a leer ese mismo recurso si su enlace firmado caduca.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Primeros pasos
CogView 4 es el modelo de texto a imagen de Zhipu, disponible en Ailoot Ultra con el ID exacto cogview-4. Proporciona una descripción de la escena para crear una ilustración, un entorno para un producto o un concepto visual. Sus controles documentados incluyen el tamaño de imagen, la calidad standard o hd y watermark_enabled; la respuesta proporciona URL de imágenes que deben guardarse todas.
- Entradas aceptadas
- Texto
- Resultados
- Imágenes
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Images POST /v1/images/generations
- Tipos de entrada
text- Tipos de salida
image- Formato de salida
- Archivo de imagen
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites cogview-4 | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Camposize | Tipostring | RequisitoOpcional | Valores y límites 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Predeterminado1280x1280 |
Campouser_id | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campoquality | Tipostring | RequisitoOpcional | Valores y límites hd, standard | Predeterminado— |
Campowatermark_enabled | Tipoboolean | RequisitoOpcional | Valores y límites | Predeterminadotrue |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites false | Predeterminado— |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt |
Parámetrooptional | Contratosize, user_id, quality, watermark_enabled, stream |
Parámetromaterial_types | Contratotext |
Parámetroconditions | ContratoUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Planes
Cómo se calcula el cargo definitivo
Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)
Tarifas estimadas para comparar
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad prevista | Cargo |
|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Cargo Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens |
| ConfiguraciónEstimated generation cost | Tabla de tarifas— | Cantidad previstaestimación para una generación | Cargo Entrada · Coste estimado de generación · Estimación solo para comparar $0.09 estimación previa a la generación This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
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.
Recibir y guardar resultados
Ailoot Ultra · Images
Descarga cada imagen recibida o guarda su contenido Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva todos los resultados completados
Guarda todas las imágenes completadas; descarga cada URL recibida o decodifica su contenido 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.
Si es necesario revisar la respuesta original
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Alias del modelo
Ailoot Ultra cogview-4
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Zhipu: CogView 4
- ¿Qué entradas y resultados están disponibles?
POST /v1/images/generations·cogview-4:text→image- ¿Qué campos utiliza la solicitud?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream