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.
", "aboutText": "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.\n\nPara 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.\n\nAs 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.\n\nquality 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.\n\nA 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "1634bd01c8c5a449990f2f20a237f6461256b7c19617391e66bb71d5bdba6bd7", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pt-pt", "methods": [ { "html": "cogview-4CogView 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.
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.
POST /v1/images/generationstextimage| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites cogview-4 | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites | Predefinição— |
Camposize | Tipostring | RequisitoOpcional | Valores e limites 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Predefinição1280x1280 |
Campouser_id | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campoquality | Tipostring | RequisitoOpcional | Valores e limites hd, standard | Predefinição— |
Campowatermark_enabled | Tipoboolean | RequisitoOpcional | Valores e limites | Predefiniçãotrue |
Campostream | Tipoboolean | RequisitoOpcional | Valores e limites false | Predefinição— |
| 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}
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.
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 →
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.\nDescarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}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.
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Ailoot Ultra cogview-4
Use os caminhos dos métodos indicados acima.