Zhipu: CogView 4 250304
CogView 4 250304 é o seletor de CogView 4 com a designação distinta cogview-4-250304 para tarefas de texto para imagem. Utilize-o quando um fluxo de trabalho exigir esta identidade exata do modelo, com uma descrição escrita da cena, dimensões específicas de CogView e definições de qualidade e marca de água. Devolve URLs de imagens através de uma resposta síncrona de geração de imagens.
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 250304 é o modelo da Zhipu denominado cogview-4-250304, pertencente à família de geração de imagens CogView. Utilize o seletor completo quando esta for a edição que pretende preservar num fluxo de trabalho criativo. O seu método no Ailoot Ultra é POST /v1/images/generations, com model e prompt como campos de cadeia obrigatórios. Os dados de entrada para este perfil consistem numa descrição escrita da imagem.
Prepare a descrição em função de um resultado visível. Uma ilustração editorial pode descrever uma pessoa à espera numa estação, o estado do tempo, a relação entre o sujeito e o fundo e o tratamento de cor pretendido. Para uma cena de produto, indique a disposição do produto, o ponto de vista, a superfície e a iluminação. Explique quais os detalhes mais importantes e compare-os depois com o ficheiro gerado. Manter a descrição e o seletor exato em conjunto facilita a avaliação de revisões posteriores.
As indicações de dimensões específicas de CogView incluem o formato quadrado 1024x1024, o formato vertical 768x1344 ou 864x1152, o formato horizontal 1344x768 ou 1152x864 e os formatos largo ou alto 1440x720 ou 720x1440. Para dimensões personalizadas, cada lado deve ter entre 512 e 2048 píxeis, ser divisível por 16 e o número total de píxeis não pode exceder 2^21. Planeie a posição do sujeito para o enquadramento escolhido, em vez de tratar uma mudança de dimensões como um simples recorte.
Os valores documentados de quality são standard e hd; o valor predefinido de CogView é standard. watermark_enabled controla a marca de água e tem como valor predefinido true. O parâmetro opcional user_id é uma cadeia de 6 a 128 carateres para o identificador do utilizador final. Preserve com o resultado as definições selecionadas de qualidade e marca de água, sobretudo ao reunir várias opções para a mesma tarefa de design.
O pedido de imagem termina de forma síncrona com created e um array data cujos elementos contêm url. Guarde todas as imagens efetivamente devolvidas e conserve a resposta completa. Um grupo de URLs devolvidos constitui o conjunto de resultados; selecionar uma imagem preferida para uma composição gráfica não deve eliminar as restantes do registo da geração. Conserve as informações do pedido e da resposta originais quando uma ligação terminar antes de o resultado completo ser conhecido e verifique o resultado existente antes de 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-250304
cogview-4-250304Introdução
CogView 4 250304 é o seletor de CogView 4 com a designação distinta cogview-4-250304 para tarefas de texto para imagem. Utilize-o quando um fluxo de trabalho exigir esta identidade exata do modelo, com uma descrição escrita da cena, dimensões específicas de CogView e definições de qualidade e marca de água. Devolve URLs de imagens através de uma resposta síncrona de geração de imagens.
- 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 |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites cogview-4-250304 | 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âmetros e ciclo de vida do método
| 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}
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 →
Exemplos de pedidos
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.
Receber e guardar os resultados
Ailoot Ultra · Images
Descarregue cada imagem devolvida ou guarde o respetivo conteúdo Base64
GET /v1/media/assetsGET /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-250304
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · Zhipu: CogView 4 250304
- Que entradas e resultados estão disponíveis?
POST /v1/images/generations·cogview-4-250304:text→image- Que campos utiliza o pedido?
POST /v1/images/generations·cogview-4-250304:model,prompt,size,user_id,quality,watermark_enabled,stream