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.
", "aboutText": "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.\n\nPara 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.\n\nLas 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.\n\nquality 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.\n\nLa 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "0f28f4dec5445bc692a80dc1ad3a750fef8587e54495ac237223a6efe760331f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "cogview-4CogView 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.
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.
POST /v1/images/generationstextimage| 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á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}
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.
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "cogview-4", "prompt": "A calm studio product photograph with a plain background."}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Submit once. Retain the complete result, original identifiers and every response header.\nDescarga cada imagen recibida o guarda su contenido Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}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.
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Ailoot Ultra cogview-4
Usa las rutas de método indicadas arriba.