Zhipu: CogView 4 250304
CogView 4 250304 es el selector de CogView 4 con nombre independiente cogview-4-250304 para tareas de texto a imagen. Utilízalo cuando un flujo de trabajo necesite esta identidad exacta del modelo, con un encargo escrito de la escena, dimensiones específicas de CogView y ajustes de calidad y marca de agua. Devuelve URL de imágenes mediante una respuesta síncrona de generación de imágenes.
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 250304 es el modelo con nombre cogview-4-250304 de Zhipu, dentro de la familia de generación de imágenes CogView. Utiliza el selector completo cuando esta sea la edición que quieras conservar en un flujo de trabajo creativo. Su método en Ailoot Ultra es POST /v1/images/generations, con model y prompt como campos de cadena obligatorios. La entrada de este perfil es una descripción escrita de la imagen.
Prepara el encargo en torno a un resultado visible. Una ilustración editorial podría describir a una persona esperando en una estación, el tiempo, la relación entre el sujeto y el fondo y el tratamiento del color deseado. Para una escena de producto, indica la disposición del producto, el punto de vista, la superficie y la iluminación. Explica qué detalles son los más importantes y luego compáralos con el archivo generado. Conservar juntos el encargo y el selector exacto facilita la evaluación de revisiones posteriores.
Las indicaciones de dimensiones específicas de CogView incluyen el formato cuadrado 1024x1024, vertical 768x1344 o 864x1152, horizontal 1344x768 o 1152x864 y ancho o alto 1440x720 o 720x1440. Para dimensiones personalizadas, cada lado se sitúa entre 512 y 2048 píxeles, cada uno es divisible por 16 y el número total de píxeles no puede superar 2^21. Planifica la ubicación del sujeto para el encuadre elegido en lugar de tratar un cambio de dimensiones como un simple recorte.
Los valores documentados de quality son standard y hd; el valor predeterminado de CogView es standard. watermark_enabled controla la marca de agua y su valor predeterminado es true. El parámetro opcional user_id es una cadena de 6 a 128 caracteres para el identificador del usuario final. Conserva los ajustes de calidad y marca de agua seleccionados junto con el resultado, especialmente al reunir varios candidatos para una misma tarea de diseño.
La solicitud de imagen se completa de forma síncrona con created y un array data cuyos elementos contienen url. Guarda cada imagen real devuelta y conserva la respuesta completa. Un grupo de URL devueltas constituye el conjunto de resultados; seleccionar una imagen preferida para una maquetación no debe descartar las demás del registro de generación. Conserva la información de la solicitud original y de la respuesta cuando una conexión termine antes de conocerse el resultado completo, y comprueba el resultado existente antes de 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-250304
cogview-4-250304Primeros pasos
CogView 4 250304 es el selector de CogView 4 con nombre independiente cogview-4-250304 para tareas de texto a imagen. Utilízalo cuando un flujo de trabajo necesite esta identidad exacta del modelo, con un encargo escrito de la escena, dimensiones específicas de CogView y ajustes de calidad y marca de agua. Devuelve URL de imágenes mediante una respuesta síncrona de generación de imágenes.
- 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-250304 | 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-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.
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-250304
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Zhipu: CogView 4 250304
- ¿Qué entradas y resultados están disponibles?
POST /v1/images/generations·cogview-4-250304:text→image- ¿Qué campos utiliza la solicitud?
POST /v1/images/generations·cogview-4-250304:model,prompt,size,user_id,quality,watermark_enabled,stream