Source: https://ailoot.ai/models/it/cogvideox-3/
Canonical: https://ailoot.ai/models/it/cogvideox-3/
Language: it

# Zhipu AI: CogVideoX 3

[Markdown](https://ailoot.ai/models/it/cogvideox-3/index.md) · [JSON](https://ailoot.ai/models/it/cogvideox-3/facts.json)

## [Zhipu AI: CogVideoX 3](https://ailoot.ai/models/it/cogvideox-3/)

CogVideoX 3 crea video da testo, da un’immagine o da una coppia di fotogrammi iniziale e finale nel processo documentato dal produttore. Supporta sequenze di cinque o dieci secondi, diverse dimensioni di output fino a 4K, 30 o 60 fps ed effetti sonori generati facoltativi.

- [**Ailoot Ultra · Generazione video** `POST /v1/videos` `cogvideox-3`](https://ailoot.ai/models/it/cogvideox-3/#method-0)

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.

CogVideoX 3 è il modello video di Zhipu AI con generazione documentata da testo a video, da immagine a video e da fotogrammi iniziale e finale. Il produttore evidenzia la stabilità dei fotogrammi, il rispetto delle istruzioni e stili visivi realistici o tridimensionali. Scegliete il testo quando la scena nasce come descrizione scritta, un’immagine quando la base visiva esiste già o due immagini degli estremi quando la sequenza richiede una vista iniziale e finale definite.

Per una descrizione testuale, indicate il soggetto e un’azione leggibile. Precisate l’ambientazione, il punto di vista e le relazioni fisiche importanti, affinché la scena possa essere valutata rispetto a un’intenzione chiara. Un personaggio che raccoglie un oggetto richiede una sequenza diversa da una camera che rivela quell’oggetto. Descrivete entrambi soltanto quando la loro relazione conta per l’inquadratura.

Per una sequenza basata su immagini, preparate il riferimento in modo che le caratteristiche distintive del soggetto siano visibili. Il produttore accetta immagini PNG, JPEG e JPG non superiori a 5 MB, fornite tramite URL o dati immagine codificati. Conservate il riferimento effettivo insieme al risultato generato, affinché aspetto e inquadratura possano essere confrontati con la fonte, anziché con una versione ricordata.

La modalità del produttore basata sui fotogrammi degli estremi accetta due immagini in ordine: la prima stabilisce il fotogramma iniziale e la seconda quello finale. Preparatele come i due stati desiderati di un’unica inquadratura. Descrivete la transizione o l’azione che li collega, poi esaminate se il soggetto rimanga coerente tra gli estremi. Una coppia di buone immagini fisse non dimostra da sola che il movimento intermedio sia adatto alla storia desiderata.

Il prompt può contenere fino a 512 caratteri. Usate il testo disponibile per l’azione, la sua direzione e i dettagli visivi che distinguono un risultato riuscito. Mantenete la descrizione concentrata su ciò che deve accadere sullo schermo. Quando le immagini di input stabiliscono già l’aspetto del soggetto, descrivete il movimento e i tempi che devono svilupparsi tra quelle immagini o a partire da esse.

Il produttore documenta output di cinque o dieci secondi, con cinque secondi come valore predefinito, e 30 o 60 fotogrammi al secondo. Le dimensioni supportate comprendono 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 e 3840×2160. Scegliete dimensioni e durata per la destinazione, poi esaminate il filmato completato per l’inquadratura e il ritmo dell’azione effettiva.

Le modalità qualità e velocità sono documentate separatamente dall’impostazione facoltativa degli effetti sonori dell’IA. Conservate queste scelte insieme al prompt, alle immagini e al risultato. Le capacità visive e di input del produttore descrivono il modello; i controlli disponibili per un particolare metodo di generazione sono forniti dalle specifiche di quel metodo. Preservate le impostazioni effettivamente usate quando confrontate inquadrature candidate.

Conservate l’identificatore dell’attività originale fino al completamento del video e salvate il filmato restituito per il montaggio. Esaminate l’intera sequenza, includendo l’aspetto del soggetto durante grandi movimenti, le interazioni con gli oggetti della scena e la composizione finale. Per il lavoro basato sui fotogrammi degli estremi, esaminate entrambi gli estremi e la transizione tra loro. Rivedete la discrepanza visiva specifica conservando i riferimenti riusciti e il piano dell’inquadratura e confrontate i video completati, anziché soltanto le immagini di anteprima.

**Ailoot Ultra · Generazione video** `POST /v1/videos` `cogvideox-3`

[`cogvideox-3`](https://ailoot.ai/models/it/#m=cogvideox-3&route=Ultra&caller=cogvideox-3&fmt=videos)

Zhipu AI /`cogvideox-3`

### Introduzione

CogVideoX 3 crea video da testo, da un’immagine o da una coppia di fotogrammi iniziale e finale nel processo documentato dal produttore. Supporta sequenze di cinque o dieci secondi, diverse dimensioni di output fino a 4K, 30 o 60 fps ed effetti sonori generati facoltativi.

Input accettati

Testo

Risultati

Video

### Disponibile in Ailoot · input e metodi

**Ailoot Ultra · Generazione video** `POST /v1/videos`

Tipi di input

`text`

Tipi di output

`video`

| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti cogvideox-3 Condizioni: Usa il selettore esatto del modello Ailoot. | Predefinito— |
| Campo`prompt` | Tipo`string` | RequisitoObbligatorio | Valori e limiti Condizioni: Descrivi la scena e il movimento. | Predefinito— |
| Campo`quality` | Tipo`boolean` | RequisitoFacoltativo | Valori e limiti Condizioni: Opzione di qualità facoltativa; questo schema selezionato non fornisce un'enumerazione compatibile o un valore predefinito. | Predefinito— |
| Campo`with_audio` | Tipo`boolean` | RequisitoFacoltativo | Valori e limiti Condizioni: Genera effetti sonori con l'IA quando l'opzione è attiva. | Predefinitofalse |
| Campo`size` | Tipo`string` | RequisitoFacoltativo | Valori e limiti Condizioni: Fornisci la stringa di dimensione documentata quando selezioni dimensioni esplicite. | Predefinito— |
| Campo`fps` | Tipo`string` | RequisitoFacoltativo | Valori e limiti 30, 60 Condizioni: In questo metodo nativo selezionato, la frequenza dei fotogrammi è rappresentata come stringa. | Predefinito30 |
| Campo`duration` | Tipo`string` | RequisitoFacoltativo | Valori e limiti 5, 10 Condizioni: In questo metodo nativo selezionato, la durata in secondi è rappresentata come stringa. | Predefinito5 |

Parametri e ciclo di vita del metodo

| Parametro | Contratto |
| --- | --- |
| Parametro`content_type` | Contrattoapplication/json |
| Parametro`required` | Contrattomodel, prompt |
| Parametro`optional` | Contrattoquality, with\_audio, size, fps, duration |
| Parametro`material_types` | Contrattotext |
| Parametro`conditions` | ContrattoUsa il selettore esatto del modello Ailoot., Descrivi la scena e il movimento., Opzione di qualità facoltativa; questo schema selezionato non fornisce un'enumerazione compatibile o un valore predefinito., Genera effetti sonori con l'IA quando l'opzione è attiva., Fornisci la stringa di dimensione documentata quando selezioni dimensioni esplicite., In questo metodo nativo selezionato, la frequenza dei fotogrammi è rappresentata come stringa., In questo metodo nativo selezionato, la durata in secondi è rappresentata come stringa. |

Alias del metodo: `/v1/videos/generations`

Ciclo di vita: `submit_once_poll_original`

`GET /v1/videos/{request_id}`

`GET /v1/videos/generations/{request_id}`

`GET /v1/videos/{request_id}/content`

`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 | Quantità fatturata | Costo |
| --- | --- | --- | --- | --- |
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Quantità fatturata— | 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 |
| ConfigurazionePer richiesta | Listino delle tariffe— | Quantità prevista— | Quantità fatturatauna richiesta | Costo Input · Stima solo a fini di confronto **$0.3** per richiesta |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Quantità fatturata— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto **$0.3** stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |

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 →](https://ailoot.ai/docs/it/billing/reserve/)

### Esempi di richieste

#### Ailoot Ultra · Generazione video

curl · crea una sola volta e conserva la ricevutaLeggi il task originaleSalva ogni risorsa completata di tua proprietà

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "cogvideox-3",
  "prompt": "A cat is walking on grass."
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
```

### Ricevi e salva i risultati

#### Ailoot Ultra · Generazione video

- `GET /v1/videos/{request_id}`
- `GET /v1/videos/generations/{request_id}`
- `GET /v1/videos/{request_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

##### Conserva tutti i risultati completati

Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.

Conserva la risposta completa e le intestazioni, gli identificatori originali, ogni risultato effettivo e tutti i campi di utilizzo e contabilizzazione. Salva ogni risorsa univoca di tua proprietà e conserva ogni ruolo che vi fa riferimento.

##### Se occorre verificare la risposta originale

Conserva l'id pubblico dell'attività o dell'operazione restituito e tutte le intestazioni. Consulta solo l'attività originale; unknown o result\_pending\_check non autorizza un'altra creazione.

Campi della risposta

| Campo | Tipo |
| --- | --- |
| Campo`id` | Tipostring |
| Campo`polling_url` | Tipostring |
| Campo`provider_task_id` | Tipostring |
| Campo`id` | Tipostring |
| Campo`task_status` | Tipostring |
| Campo`video_result[].url` | Tipostring |

### Alias

#### Alias del modello

**Ailoot Ultra** [`cogvideox-3`](https://ailoot.ai/models/it/#m=cogvideox-3&route=Ultra&caller=cogvideox-3&fmt=videos)

#### Alias dei percorsi dei metodi

`/v1/videos/generations`

#### ID di chiamata correlati

[`cogvideox-3`](https://ailoot.ai/models/it/#m=cogvideox-3&route=Ultra&caller=cogvideox-3&fmt=videos)

FAQ · Zhipu AI: CogVideoX 3

Quali input e risultati sono disponibili?

`POST /v1/videos` · `cogvideox-3`: `text` → `video`

Quali campi usa la richiesta?

`POST /v1/videos` · `cogvideox-3`: `model`, `prompt`, `quality`, `with_audio`, `size`, `fps`, `duration`

Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione.

## L’azienda e il suo portafoglio di progetti

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

## Acquista token con uno sconto.

Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token.

Abbonamento

Scegli un piano scontato per richieste regolari.

Codice fino al 50%

Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione.

Spese nella cronologia

Modello, token e importo sono salvati per ogni richiesta.

[Scegli abbonamento](https://ailoot.ai/docs/it/billing/subscriptions/) · [Consulta prezzi dei modelli](https://ailoot.ai/models/it/)

## Collega l’API al prodotto che vendi.

SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller.

Applicazione commerciale

Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento.

Licenza reseller

Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita.

Documenti sul sito

Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione.

[Richiedi licenza reseller](mailto:support@ailoot.ai) · [Offerta e accordo di licenza](https://ailoot.ai/legal/offer?lang=it)

## Ailoot · L’azienda e il suo portafoglio di progetti





Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.





L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.





Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.
