Source: https://ailoot.ai/models/pt-pt/cogview-4/ Canonical: https://ailoot.ai/models/pt-pt/cogview-4/ Language: pt-pt # Zhipu: CogView 4 [Markdown](https://ailoot.ai/models/pt-pt/cogview-4/index.md) · [JSON](https://ailoot.ai/models/pt-pt/cogview-4/facts.json) ## [Zhipu: CogView 4](https://ailoot.ai/models/pt-pt/cogview-4/) CogView 4 é o modelo de texto para imagem da Zhipu, disponível no Ailoot Ultra sob o ID exato cogview-4. Forneça a descrição de uma cena para criar uma ilustração, um cenário de produto ou um conceito visual. Os controlos documentados incluem o tamanho da imagem, a qualidade standard ou hd e watermark\_enabled; a resposta fornece URLs de imagens, que devem ser todos guardados. - [**Ailoot Ultra · Images** `POST /v1/images/generations` `cogview-4`](https://ailoot.ai/models/pt-pt/cogview-4/#method-0) Sobre o modelo Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo. CogView 4 transforma uma descrição escrita em imagens. Selecione cogview-4 em POST /v1/images/generations e forneça prompt como uma cadeia de texto. Os dados de entrada obrigatórios são model e prompt. Utilize a descrição para definir o tema principal, a sua posição, a cena envolvente e o tratamento visual que pretende avaliar. Para um cenário de produto, descreva o objeto, a superfície em que assenta, o fundo e a direção da luz. Para uma ilustração, especifique as personagens ou objetos, o ambiente pretendido e a composição. Se a imagem ficar ao lado de um título ou de uma descrição de produto, indique onde a composição deve deixar espaço livre. Compare o resultado com esses requisitos concretos antes de o utilizar numa composição gráfica. As indicações de tamanho específicas de CogView apresentam 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 e 720x1440. As indicações de tamanho personalizado estabelecem cada lado entre 512 e 2048 píxeis, divisível por 16, com um máximo total de 2^21 píxeis. Adeque o enquadramento ao local de utilização: uma ilustração vertical, uma cena de produto quadrada e uma imagem panorâmica exigem composições diferentes, além de dimensões diferentes. quality aceita standard ou hd, sendo standard o valor predefinido documentado para CogView. watermark\_enabled é um booleano com um valor predefinido documentado de true. A cadeia opcional user\_id identifica o utilizador final e deve conter de 6 a 128 carateres. Mantenha esse identificador separado do prompt criativo. As alterações de qualidade ou tamanho devem corresponder a uma utilização pretendida clara para a imagem, em vez de substituírem a descrição do que deve aparecer. A geração devolve uma resposta JSON síncrona com created e data. Cada elemento de data\[\] fornece um url. Transfira todas as imagens devolvidas e guarde a resposta juntamente com a descrição e as definições escolhidas; não conserve apenas o primeiro elemento pelo simples facto de a pré-visualização mostrar uma imagem. O contrato documentado não introduz uma etapa separada de consulta de estado de tarefa, ao estilo dos vídeos, para este pedido de imagem. Se a resposta for interrompida ou estiver incompleta, conserve as informações do pedido original e o resultado recebido antes de decidir se é adequado fazer outro pedido de criação. O Ailoot armazena estas imagens como recursos multimédia próprios e devolve ligações assinadas do Ailoot. Localize os registos dos recursos através de GET /v1/media/assets?family=image, percorrendo todos os next\_cursor. Consulte GET /v1/media/assets/{asset\_id} com cada asset\_id real para obter o respetivo content\_url; consulte novamente o mesmo recurso se a ligação assinada expirar. **Ailoot Ultra · Images** `POST /v1/images/generations` `cogview-4` [`cogview-4`](https://ailoot.ai/models/pt-pt/#m=cogview-4&route=Ultra&caller=cogview-4&fmt=images) ZHIPU /`cogview-4` ### Introdução CogView 4 é o modelo de texto para imagem da Zhipu, disponível no Ailoot Ultra sob o ID exato cogview-4. Forneça a descrição de uma cena para criar uma ilustração, um cenário de produto ou um conceito visual. Os controlos documentados incluem o tamanho da imagem, a qualidade standard ou hd e watermark\_enabled; a resposta fornece URLs de imagens, que devem ser todos guardados. Entradas aceites Texto Resultados Imagens ### Disponível no Ailoot · entradas e métodos **Ailoot Ultra · Images** `POST /v1/images/generations` Entrada `text` Saída `image` Formato de saída Ficheiro de imagem | Campo | Tipo | Requisito | Valores e limites | Predefinição | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites cogview-4 | Predefinição— | | Campo`prompt` | Tipo`string` | RequisitoObrigatório | Valores e limites | Predefinição— | | Campo`size` | Tipo`string` | RequisitoOpcional | Valores e limites 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Predefinição1280x1280 | | Campo`user_id` | Tipo`string` | RequisitoOpcional | Valores e limites | Predefinição— | | Campo`quality` | Tipo`string` | RequisitoOpcional | Valores e limites hd, standard | Predefinição— | | Campo`watermark_enabled` | Tipo`boolean` | RequisitoOpcional | Valores e limites | Predefiniçãotrue | | Campo`stream` | Tipo`boolean` | RequisitoOpcional | Valores e limites false | Predefinição— | Parâmetros e ciclo de vida do método | Parâmetro | Contrato | | --- | --- | | Parâmetro`content_type` | Contratoapplication/json | | Parâmetro`required` | Contratomodel, prompt | | Parâmetro`optional` | Contratosize, user\_id, quality, watermark\_enabled, stream | | Parâmetro`material_types` | Contratotext | | Parâmetro`conditions` | 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}` ### Tarifários ##### Cálculo do custo final As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável. As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado. Modo rápido Não especificado Quando o modo rápido está selecionado Modo flex Não especificado Quando o modo flex está selecionado Esforço máximo de raciocínio Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default) #### Tarifas estimadas para comparação #### Preços por configuração Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas. | Configuração | Tabela de tarifas | Quantidade prevista | Custo | | --- | --- | --- | --- | | ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação **—** / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação **—** / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação **—** / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação **—** / 1K tokens | | ConfiguraçãoEstimated generation cost | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Custo Entrada · Custo estimado de geração · Estimativa apenas para comparação **$0.09** estimativa antes da geração This estimate is not an additional charge or a fixed rate for the completed generation. | O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. [Como funcionam a reserva e a liquidação →](https://ailoot.ai/docs/pt-pt/billing/reserve/) ### Exemplos de pedidos #### Ailoot Ultra · Images curl · crie uma única vez e guarde o resultado completo ```bash 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. ``` ### Receber e guardar os resultados #### Ailoot Ultra · Images Descarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64 - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Guardar todos os resultados concluídos Guarde cada imagem concluída; obtenha cada URL devolvido ou descodifique o respetivo conteúdo 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. ##### Se for necessário verificar a resposta original Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation. ### Aliases #### Aliases do modelo **Ailoot Ultra** [`cogview-4`](https://ailoot.ai/models/pt-pt/#m=cogview-4&route=Ultra&caller=cogview-4&fmt=images) #### Aliases dos caminhos dos métodos Use os caminhos dos métodos indicados acima. #### IDs de chamada relacionados [`cogview-4`](https://ailoot.ai/models/pt-pt/#m=cogview-4&route=Ultra&caller=cogview-4&fmt=images) FAQ · Zhipu: CogView 4 Que entradas e resultados estão disponíveis? `POST /v1/images/generations` · `cogview-4`: `text` → `image` Que campos utiliza o pedido? `POST /v1/images/generations` · `cogview-4`: `model`, `prompt`, `size`, `user_id`, `quality`, `watermark_enabled`, `stream` Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação. ## A empresa e a sua carteira de projetos A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. ## Compre tokens com desconto. Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens. Subscrição Escolha um plano com desconto para os pedidos regulares. Código promocional até 50% Introduza o código na compra. O preço é recalculado conforme a campanha em vigor. Custos no histórico O modelo, os tokens e o montante são guardados para cada pedido. [Escolher subscrição](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/) ## Ligue a API ao produto que vende. SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor. Aplicação comercial Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço. Licença de revendedor Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda. Documentos no site A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação. [Pedir licença de revendedor](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt) ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.