Avançar para o conteúdo

H3 Max Camera Controls

Integrar

ID do modelo minimax/h3-max/camera-controls
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/minimax/h3-max/camera-controls?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt_expansion_mode": "balanced",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Este pedido: 0,175 $ 175 créditos da API Executar nesta página

Obter chave de API
MiniMax Imagem para vídeo 0,92–15 saté 1080P #stylized#transform#editing

Anima uma imagem ao longo de um percurso de câmara com fotogramas-chave, controlando a órbita, a elevação e a distância

MiniMax · Vídeo

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

0 / 50000

Prompt de geração de vídeo que substitui o comportamento predefinido de cena congelada. Deixá-lo em branco ou omiti-lo mantém a cena de referência fixa e permite apenas o movimento da câmara.

•obrigatório

Esforço de reescrita do prompt antes da geração: 'quality' desenvolve um prompt mais rico durante aproximadamente 30s, enquanto 'balanced' responde em cerca de um segundo. Escolha 'disabled' para omitir a expansão do prompt.

•obrigatório image_url
Largue um ficheiro ou

URL da imagem que define o frame inicial do vídeo.

resolution predefinição 480P

Seleção da resolução da geração: 1080P requer refinamento latente do material gerado nativamente a 768P, em vez de geração nativa na resolução selecionada.

predefinição 5

Duração solicitada em segundos, permitindo uma duração real do vídeo até aproximadamente 0.7 s além desse pedido.

Avançado seed · enable_safety_checker · camera_trajectory

Seed para geração aleatória; se omitida, é escolhida aleatoriamente.

Keyframes de câmara ordenados, com rotações completas assinadas preservadas e deslocação azimutal total limitada a 32 voltas. Fora do intervalo temporal dos keyframes, a câmara mantém a primeira pose antes do respetivo timestamp e a pose final até ao fim do vídeo.

POST /run/minimax/h3-max/camera-controls?wait=20 cotação → 0,175 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/minimax/h3-max/camera-controls?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt_expansion_mode": "balanced",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre H3 Max Camera Controls

Utiliza `image_url` como primeiro frame e move a câmara ao longo de `camera_trajectory`, uma lista de 2 a 12 fotogramas-chave ordenados. Por predefinição, a cena permanece rígida, pelo que apenas a câmara muda. A duração é de 0.92 a 15 segundos, com resolução 480P, 768P ou 1080P. A expansão do prompt pode ser ajustada.

Parâmetros

Envie o nome canónico ou o nome nativo, não ambos. Nomes canónicos

NomeTipo PredefiniçãoPermitido Descrição
promptopcional
Tipostring
PredefiniçãoThe same elements in the reference are rigid. Preserve every element exactly. The entire scene is frozen. Only the camera moves. no scene motion only camera motion
≤ 50 000 caracteres
Prompt de geração de vídeo que substitui o comportamento predefinido de cena congelada. Deixá-lo em branco ou omiti-lo mantém a cena de referência fixa e permite apenas o movimento da câmara.
durationopcional
Tiponumber
Predefinição5
0,92 – 15
Duração solicitada em segundos, permitindo uma duração real do vídeo até aproximadamente 0.7 s além desse pedido.
resolutionopcional
Tipoenum
Predefinição480P
480P768P1080P
Seleção da resolução da geração: 1080P requer refinamento latente do material gerado nativamente a 768P, em vez de geração nativa na resolução selecionada.
seedopcional
Tipointeger | null
Seed para geração aleatória; se omitida, é escolhida aleatoriamente.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
Ativação do verificador de segurança; true ativa a verificação.
prompt_expansion_modeobrigatório
Tipostring
Predefiniçãobalanced
Esforço de reescrita do prompt antes da geração: 'quality' desenvolve um prompt mais rico durante aproximadamente 30s, enquanto 'balanced' responde em cerca de um segundo. Escolha 'disabled' para omitir a expansão do prompt.
image_urlobrigatório image
Tipourl · image
URL da imagem que define o frame inicial do vídeo.
camera_trajectoryopcional
Tipoobject[]
≤ 12 itens≥ 2 itens
Keyframes de câmara ordenados, com rotações completas assinadas preservadas e deslocação azimutal total limitada a 32 voltas. Fora do intervalo temporal dos keyframes, a câmara mantém a primeira pose antes do respetivo timestamp e a pose final até ao fim do vídeo.
camera_trajectory[].timeobrigatório
Tiponumber
0 – 1
Tempo normalizado dentro do vídeo, usando o intervalo [0, 1] para representar, respetivamente, o início e o fim.
camera_trajectory[].azimuthobrigatório
Tiponumber
Ângulo horizontal da câmara em torno do sujeito, medido em graus.
camera_trajectory[].elevationobrigatório
Tiponumber
-90 – 90
Ângulo vertical da câmara em torno do sujeito, medido em graus.
camera_trajectory[].distanceobrigatório
Tiponumber
> 0
Distância entre a câmara e o sujeito, medida em unidades normalizadas da cena.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "minimax/h3-max/camera-controls",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 175,
    "usd": "0.175",
    "charged": 175,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt_expansion_mode": "balanced"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "expanded_prompt": "string",
    "timings": {}
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
video
object {url, content_type, file_name, file_size}Vídeo produzido pelo modelo.
expanded_prompt
string | nullPrompt expandido pronto para o modelo, ou null se não estiver disponível texto expandido. Os casos null são expansão desativada, expansão sem alterações e expansão processada internamente pela API alojada do modelo.
timings
object | nullMedições de tempo expressas em segundos, disponíveis apenas em rotas que reportam tempos do backend; caso contrário, null. A entrada 'inference' mede o tempo de denoising DiT no backend GPU.

Mais modelos: Imagem para vídeo

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/minimax/h3-max/camera-controls.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt