Zhipu: CogView 4
CogView 4 è il modello di Zhipu da testo a immagine, disponibile in Ailoot Ultra con l'ID esatto cogview-4. Fornisci la descrizione di una scena per creare un'illustrazione, un'ambientazione di prodotto o un concept visivo. I controlli documentati includono dimensioni dell'immagine, qualità standard o hd e watermark_enabled; la risposta fornisce URL di immagini che vanno salvate tutte.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
CogView 4 trasforma un brief scritto in immagini. Seleziona cogview-4 in POST /v1/images/generations e fornisci prompt come stringa di testo. Gli input obbligatori sono model e prompt. Usa il brief per descrivere il soggetto principale, la sua posizione, la scena circostante e il trattamento visivo che vuoi valutare.
Per un'ambientazione di prodotto, descrivi l'oggetto, la superficie su cui poggia, lo sfondo e la direzione della luce. Per un'illustrazione, specifica i personaggi o gli oggetti, l'atmosfera desiderata e la composizione. Se l'immagine verrà affiancata a un titolo o a una descrizione di prodotto, indica dove la composizione deve lasciare spazio libero. Confronta il risultato con questi requisiti concreti prima di usarlo in un'impaginazione.
Le indicazioni sulle dimensioni specifiche di CogView elencano 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720 e 720x1440. Per le dimensioni personalizzate, ogni lato deve essere compreso tra 512 e 2048 pixel, divisibile per 16, con un massimo di 2^21 pixel totali. Adatta l'inquadratura alla destinazione: un'illustrazione verticale, una scena di prodotto quadrata e un'immagine panoramica richiedono composizioni diverse oltre a dimensioni diverse.
quality accetta standard o hd, con standard documentato come valore predefinito di CogView. watermark_enabled è un booleano con un valore predefinito documentato di true. Una stringa user_id facoltativa identifica l'utente finale e deve contenere da 6 a 128 caratteri. Tieni questo identificatore separato dal prompt creativo. Le modifiche alla qualità o alle dimensioni dovrebbero accompagnare una chiara destinazione d'uso dell'immagine, senza sostituire la descrizione di ciò che deve apparire.
La generazione restituisce una risposta JSON sincrona contenente created e data. Ogni elemento data[] fornisce un url. Scarica tutte le immagini restituite e conserva la risposta insieme al brief e alle impostazioni scelte; non conservare soltanto il primo elemento solo perché un'anteprima mostra una singola immagine. Il contratto documentato non introduce per questa richiesta di immagine un passaggio separato di polling del job come nei video. Se la risposta viene interrotta o è incompleta, conserva le informazioni della richiesta originale e il risultato ricevuto prima di decidere se sia appropriata un'ulteriore richiesta di creazione. Ailoot archivia queste immagini come risorse multimediali di proprietà e restituisce link Ailoot firmati. Trova i record delle risorse tramite GET /v1/media/assets?family=image, seguendo ogni next_cursor. Leggi GET /v1/media/assets/{asset_id} con ciascun asset_id effettivo per ottenere il relativo content_url; leggi nuovamente la stessa risorsa se il suo link firmato scade.
Ailoot Ultra · Images POST /v1/images/generations cogview-4
cogview-4Introduzione
CogView 4 è il modello di Zhipu da testo a immagine, disponibile in Ailoot Ultra con l'ID esatto cogview-4. Fornisci la descrizione di una scena per creare un'illustrazione, un'ambientazione di prodotto o un concept visivo. I controlli documentati includono dimensioni dell'immagine, qualità standard o hd e watermark_enabled; la risposta fornisce URL di immagini che vanno salvate tutte.
- Input accettati
- Testo
- Risultati
- Immagini
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Images POST /v1/images/generations
- Tipi di input
text- Tipi di output
image- Formato di output
- File immagine
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti cogview-4 | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Camposize | Tipostring | RequisitoFacoltativo | Valori e limiti 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728 | Predefinito1280x1280 |
Campouser_id | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campoquality | Tipostring | RequisitoFacoltativo | Valori e limiti hd, standard | Predefinito— |
Campowatermark_enabled | Tipoboolean | RequisitoFacoltativo | Valori e limiti | Predefinitotrue |
Campostream | Tipoboolean | RequisitoFacoltativo | Valori e limiti false | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt |
Parametrooptional | Contrattosize, user_id, quality, watermark_enabled, stream |
Parametromaterial_types | Contrattotext |
Parametroconditions | ContrattoUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Ciclo di vita: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Costo |
|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazioneEstimated generation cost | Listino delle tariffe— | Quantità previstastima per una generazione | Costo Input · Costo di generazione stimato · Stima solo a fini di confronto $0.09 stima prima della generazione This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Esempi di richieste
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", "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.
Ricevi e salva i risultati
Ailoot Ultra · Images
Scarica ogni immagine restituita o salvane il contenuto Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva tutti i risultati completati
Salva ogni immagine completata; recupera ogni URL restituito oppure decodificane il contenuto 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 occorre verificare la risposta originale
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Alias del modello
Ailoot Ultra cogview-4
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · Zhipu: CogView 4
- Quali input e risultati sono disponibili?
POST /v1/images/generations·cogview-4:text→image- Quali campi usa la richiesta?
POST /v1/images/generations·cogview-4:model,prompt,size,user_id,quality,watermark_enabled,stream