Zhipu AI: CogVideoX 2

CogVideoX 2 gera vídeo a partir de uma descrição textual ou de uma imagem fornecida. O fabricante documenta tamanhos de fotogramas selecionáveis, 30 ou 60 fps, modos de qualidade ou velocidade e efeitos sonoros gerados opcionais para dar forma a uma breve cena visual.

Ailoot Ultra · Vídeo POST /v1/videos cogvideox-2

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.

CogVideoX 2 é o modelo de geração de vídeo da Zhipu AI para uma descrição escrita da cena ou uma imagem fornecida. O texto estabelece o sujeito, o cenário e a ação; uma imagem pode fornecer a base visual da sequência gerada. Utilize a entrada que melhor representa os materiais já disponíveis para o plano e descreva depois o movimento visível que o vídeo terminado deve conter.

Para criação a partir de texto, defina um evento coerente. Uma pessoa a abrir a porta de uma oficina, um pequeno barco a passar por um cais ou um objeto a rodar sob luz constante dão, cada um, uma finalidade legível ao plano. Indique as características importantes do sujeito, o ponto de vista e a direção do movimento. Escolha um final utilizável na montagem pretendida, em vez de deixar indefinida a composição final da cena.

Para criação a partir de uma imagem, prepare uma vista clara do sujeito e descreva como a cena deve mover-se a partir dela. O fabricante aceita referências PNG, JPEG e JPG até 5 MB, fornecidas por URL da imagem ou dados de imagem codificados. Mantenha os contornos importantes, os traços faciais e os detalhes do objeto visíveis na referência e deixe espaço para a ação pedida dentro da composição.

O fabricante limita o prompt escrito a 512 caracteres. Utilize este espaço para os detalhes decisivos: sujeito, ação, cenário e ponto de vista. Uma descrição curta que explica que objeto se move e o que permanece fixo é mais fácil de avaliar do que uma lista de adjetivos de estilo genéricos. Se o resultado falhar o objetivo, reveja a instrução ligada ao problema observado de movimento ou enquadramento.

Os tamanhos de saída publicados incluem formatos quadrados, horizontais e verticais, com opções de 720×480 a 3840×2160 píxeis. O fabricante também documenta 30 ou 60 fotogramas por segundo. Selecione o formato e a taxa de fotogramas para o destino antes da geração e examine o vídeo real para perceber se o sujeito e os seus detalhes importantes permanecem legíveis nesse enquadramento.

Qualidade e velocidade são modos de saída nomeados no processo do fabricante. Os efeitos sonoros opcionais gerados por IA são controlados separadamente da descrição visual. Conserve o modo selecionado e a definição dos efeitos sonoros com o prompt e qualquer imagem de referência, para que os diferentes vídeos candidatos possam ser comparados usando as suas definições de geração reais.

A geração é assíncrona: é devolvido um identificador da tarefa antes de o vídeo terminado estar disponível. Conserve esse identificador durante a verificação dos resultados e preserve todos os ficheiros de vídeo concluídos associados à operação. Guarde o próprio vídeo para edição, juntamente com a imagem de origem quando utilizada, em vez de depender de uma localização temporária do resultado ou de um fotograma de pré-visualização.

Examine toda a sequência quanto à continuidade, aos tempos e à ação pedida. Um plano de produto precisa de forma e detalhes de materiais estáveis durante o movimento; um plano de personagem precisa de aparência e gestos coerentes. Verifique a composição final e qualquer som gerado em relação à finalidade do plano. Conserve os elementos bem-sucedidos da cena ao rever uma discrepância concreta e utilize as mesmas condições de visualização para comparar os vídeos original e revisto.

Ailoot Ultra · Vídeo POST /v1/videos cogvideox-2

cogvideox-2

Zhipu AI /cogvideox-2

Introdução

Entradas aceites: Texto
Resultados: Vídeo

Disponível no Ailoot · entradas e métodos

Ailoot Ultra · Vídeo POST /v1/videos

Entrada: text
Saída: video

Campo	Tipo	Requisito	Valores e limites	Predefinição
Campo`model`	Tipo`string`	RequisitoObrigatório	Valores e limites cogvideox-2 Condições: Utilize o seletor exato de modelos da Ailoot.	Predefinição—
Campo`prompt`	Tipo`string`	RequisitoObrigatório	Valores e limites Condições: Descreva a cena e o movimento.	Predefinição—
Campo`quality`	Tipo`boolean`	RequisitoOpcional	Valores e limites Condições: Indicador opcional de qualidade; este esquema selecionado não fornece um enum compatível nem um valor predefinido.	Predefinição—
Campo`with_audio`	Tipo`boolean`	RequisitoOpcional	Valores e limites Condições: Gere efeitos sonoros com IA quando ativado.	Predefiniçãofalse
Campo`size`	Tipo`string`	RequisitoOpcional	Valores e limites Condições: Forneça a cadeia size documentada ao selecionar dimensões explícitas.	Predefinição—
Campo`fps`	Tipo`string`	RequisitoOpcional	Valores e limites 30, 60 Condições: Neste método nativo selecionado, a frequência de fotogramas é representada como uma cadeia de carateres.	Predefinição30
Campo`duration`	Tipo`string`	RequisitoOpcional	Valores e limites 5, 10 Condições: Neste método nativo selecionado, a duração em segundos é representada como uma cadeia de carateres.	Predefinição5

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`	Contratoquality, with_audio, size, fps, duration
Parâmetro`material_types`	Contratotext
Parâmetro`conditions`	ContratoUtilize o seletor exato de modelos da Ailoot., Descreva a cena e o movimento., Indicador opcional de qualidade; este esquema selecionado não fornece um enum compatível nem um valor predefinido., Gere efeitos sonoros com IA quando ativado., Forneça a cadeia size documentada ao selecionar dimensões explícitas., Neste método nativo selecionado, a frequência de fotogramas é representada como uma cadeia de carateres., Neste método nativo selecionado, a duração em segundos é representada como uma cadeia de carateres.

Aliases do método: /v1/videos/generations

Ciclo de vida: 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}

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	Quantidade faturada	Custo
ConfiguraçãoTarifas base por token	Tabela de tarifasTarifa base	Quantidade prevista—	Quantidade faturada—	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çãoPor pedido	Tabela de tarifas—	Quantidade prevista—	Quantidade faturadaum pedido	Custo Entrada · Estimativa apenas para comparação $0.2 por pedido
ConfiguraçãoCusto estimado de geração	Tabela de tarifas—	Quantidade previstaestimativa para uma geração	Quantidade faturada—	Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.2 estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída.

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 · Vídeo

curl · crie uma única vez e guarde o comprovativoConsulte a tarefa originalGuarde cada recurso concluído que lhe pertence

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "cogvideox-2",
  "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.

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

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

Receber e guardar os resultados

Ailoot Ultra · Vídeo

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}

Guardar todos os resultados concluídos

Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.

Conserve a resposta completa e os cabeçalhos, os identificadores originais, todos os resultados reais e todos os campos de utilização/contabilidade. Guarde cada recurso único pertencente ao utilizador e conserve todas as funções que apontam para ele.

Se for necessário verificar a resposta original

Conserve o id público de tarefa ou operação devolvido e todos os cabeçalhos. Consulte apenas a tarefa original; unknown ou result_pending_check não autoriza uma nova criação.

Campos da resposta

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

Aliases

Aliases do modelo

Ailoot Ultra cogvideox-2

Aliases dos caminhos dos métodos

/v1/videos/generations

IDs de chamada relacionados

cogvideox-2

FAQ · Zhipu AI: CogVideoX 2

Que entradas e resultados estão disponíveis?: POST /v1/videos · cogvideox-2: text → video
Que campos utiliza o pedido?: POST /v1/videos · cogvideox-2: model, prompt, quality, with_audio, size, fps, duration

Zhipu AI: CogVideoX 2