VEO3 Official — Geração de vídeo

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

POST

videos

generations

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "veo3.1-fast-official",
    "prompt": "a golden retriever running on the beach, sunset, cinematic",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

Autorização

Authorization

string

obrigatório

Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua API Key:Acesse a página de gerenciamento de API Keys para obter sua API KeyAdicione ao cabeçalho da requisição:

Authorization: Bearer YOUR_API_KEY

Parâmetros da requisição

model

string

obrigatório

Nome do modelo de geração de vídeoModelos disponíveis:

veo3.1-fast-official — Veo 3.1 Official, versão rápida
veo3.1-quality-official — Veo 3.1 Official, versão de alta qualidade

prompt

string

obrigatório

Prompt textual positivoDescreva cenas, ações, estilos etc. em detalhes para obter melhores resultados de geração. Recomenda-se prompts em inglês.Exemplo: "a golden retriever running on the beach, sunset, cinematic"

negative_prompt

string

Prompt negativo para excluir conteúdo indesejadoExemplo: "blurry, low quality, watermark, text"

duration

integer

padrão:"8"

Duração do vídeo em segundosValores recomendados: 4 / 6 / 8Padrão: 8Observação: deve ser um número puro (por exemplo, 8), não adicione aspas, caso contrário ocorrerá um erro

aspect_ratio

string

padrão:"16:9"

Proporção do vídeoValores disponíveis:

16:9 — paisagem
9:16 — retrato

Padrão: 16:9

resolution

string

padrão:"720p"

Resolução do vídeoValores disponíveis:

720p — resolução padrão
1080p — alta definição
4K — ultra alta definição

Padrão: 720p

first_frame_image

string

URL da imagem do primeiro frame para geração imagem-para-vídeo

A URL da imagem deve ser publicamente acessível, sem proteção contra hotlinking
URLs de armazenamento de objetos são recomendadas em vez de links de download temporários

last_frame_image

string

URL da imagem do último frame para geração imagem-para-vídeoUsado em conjunto com first_frame_image para controlar o primeiro e o último frame

seed

integer

Seed aleatória para reproduzir resultados de geraçãoFaixa de valores: 0 - 4294967295

sample_count

integer

padrão:"1"

Número de amostras a gerar (1-4); atualmente é recomendado usar 1Padrão: 1

generate_audio

boolean

padrão:"false"

Se deve gerar trilha de áudio

person_generation

string

padrão:"allow_adult"

Política de geração de pessoasValores disponíveis:

allow_adult — permitir apenas a geração de pessoas/rostos adultos
disallow — não permitir a geração de pessoas ou rostos

Padrão: allow_adult

resize_mode

string

padrão:"pad"

Estratégia de redimensionamento de imagem (válida para imagem-para-vídeo)Valores disponíveis:

pad — modo padding
crop — modo recorte

Padrão: pad

enhance_prompt

boolean

padrão:"true"

Se deve habilitar o aprimoramento de prompt no upstreamPadrão: true

Este parâmetro só pode ser definido como true. Defini-lo como false causará erro na requisição
Se você não precisar deste parâmetro, não o inclua

Texto-para-vídeo vs. imagem-para-vídeo

O sistema determina automaticamente o modo com base na presença de parâmetros de imagem: sem imagens para texto-para-vídeo, com imagens para imagem-para-vídeo.

Parâmetro	Texto-para-vídeo	Imagem-para-vídeo
`prompt`	Obrigatório	Obrigatório
`first_frame_image`	Não usado	Obrigatório (pelo menos um)
`last_frame_image`	Não usado	Opcional (último frame)
`negative_prompt`	Opcional	Opcional
`duration`	Opcional	Opcional
`aspect_ratio`	Opcional	Opcional
`resolution`	Opcional	Opcional
`seed`	Opcional	Opcional
`generate_audio`	Opcional	Opcional
`person_generation`	Opcional	Opcional
`resize_mode`	Não aplicável	Opcional
`enhance_prompt`	Opcional	Opcional

Resposta

code

integer

Código de status da resposta, 200 em caso de sucesso

data

array

Array de dados da resposta

Mostrar Propriedades

status

string

Status da tarefa, inicialmente submitted no envio

task_id

string

Identificador único da tarefa para consultar status e resultados

Cenários de uso

Cenário 1: Texto-para-vídeo (básico)

{
  "model": "veo3.1-fast-official",
  "prompt": "a golden retriever running on the beach, sunset, cinematic"
}

Cenário 2: Texto-para-vídeo (parâmetros completos)

{
  "model": "veo3.1-quality-official",
  "prompt": "a cinematic close-up of a ragdoll cat slowly walking through a sunlit living room",
  "negative_prompt": "blurry, low quality, watermark, text",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "seed": 12345,
  "generate_audio": true,
  "person_generation": "disallow",
  "enhance_prompt": true
}

Cenário 3: Imagem-para-vídeo (apenas primeiro frame)

{
  "model": "veo3.1-fast-official",
  "prompt": "the cat slowly walks forward and looks around",
  "first_frame_image": "https://example.com/cat.png",
  "duration": 8,
  "resolution": "720p"
}

Cenário 4: Imagem-para-vídeo (primeiro frame + último frame)

{
  "model": "veo3.1-quality-official",
  "prompt": "smooth cinematic transition from the first frame to the last frame",
  "first_frame_image": "https://example.com/frame-start.png",
  "last_frame_image": "https://example.com/frame-end.png",
  "duration": 8,
  "resolution": "1080p"
}

Cenário 5: Vídeo com áudio

{
  "model": "veo3.1-quality-official",
  "prompt": "a busy coffee shop with people chatting and barista making latte art",
  "duration": 8,
  "generate_audio": true,
  "aspect_ratio": "16:9"
}

Consultar resultados da tarefaA geração de vídeo é uma tarefa assíncrona que retorna um task_id ao ser enviada. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.

VEO3 — Remix de vídeo MiniMax-Hailuo-02 — Geração de vídeo

Documentation Index

​Autorização

​Parâmetros da requisição

​Texto-para-vídeo vs. imagem-para-vídeo

​Resposta

​Cenários de uso

​Cenário 1: Texto-para-vídeo (básico)

​Cenário 2: Texto-para-vídeo (parâmetros completos)

​Cenário 3: Imagem-para-vídeo (apenas primeiro frame)

​Cenário 4: Imagem-para-vídeo (primeiro frame + último frame)

​Cenário 5: Vídeo com áudio

Autorização

Parâmetros da requisição

Texto-para-vídeo vs. imagem-para-vídeo

Resposta

Cenários de uso

Cenário 1: Texto-para-vídeo (básico)

Cenário 2: Texto-para-vídeo (parâmetros completos)

Cenário 3: Imagem-para-vídeo (apenas primeiro frame)

Cenário 4: Imagem-para-vídeo (primeiro frame + último frame)

Cenário 5: Vídeo com áudio