Saltar para o conteúdo principal
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

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

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }'

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

​
Autenticação

​
Authorization
string
obrigatório
Todas as requisições exigem autenticação via Bearer Token.Obtenha uma chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de API.Adicione o seguinte cabeçalho ao fazer requisições:
Authorization: Bearer YOUR_API_KEY

​
Parâmetros da requisição

​
model
string
obrigatório
Nome do modelo de geração de vídeo. Deve ser Omni-Flash-Ext.
​
prompt
string
obrigatório
Descrição do conteúdo do vídeo. Recomendamos descrever a cena, o sujeito, a ação, o ambiente, o movimento de câmera, o estilo visual e as indicações de áudio em detalhes.Exemplo: "a girl is dancing happily in a sunny garden"
​
duration
integer
padrão:"6"
Duração do vídeo em segundos.Valores suportados: 4, 6, 8, 10.
Outros valores, como 5 ou 7, retornarão um erro invalid_duration.
Não envie duration ao fazer upload de um vídeo de referência. duration e video_urls não podem ser enviados ao mesmo tempo.
​
resolution
string
padrão:"720p"
Resolução do vídeo. Os valores não diferenciam maiúsculas de minúsculas.Valores suportados:
  • 720p
  • 1080p
  • 4k
Outras resoluções retornarão um erro invalid_resolution.
​
aspect_ratio
string
padrão:"16:9"
Proporção do vídeo. Use-a para controlar a saída em paisagem ou retrato.Valores comuns:
  • 16:9 - paisagem
  • 9:16 - retrato
Padrão: 16:9
​
size
string
Campo de compatibilidade. Tem o mesmo significado que aspect_ratio. Se ambos forem fornecidos, mantenha-os consistentes.
​
image_urls
array<url>
Array de URLs de imagens de referência. Você pode omiti-lo, fornecer 1 imagem ou fornecer 3 imagens:
  • Omitido ou array vazio: Text-to-Video
  • 1 imagem: Image-to-Video com imagem única
  • 3 imagens: fusão de imagens de referência
Apenas URLs de imagens publicamente acessíveis são suportadas.
O modo de primeiro frame mais último frame com 2 imagens não é suportado. Passar 2 imagens retorna um erro unsupported_image_count. 4 imagens ou mais não foram totalmente verificadas e não são recomendadas.
​
video_urls
array<url>
Array de URLs de vídeos de referência. Você pode omiti-lo ou fornecer 1 vídeo de referência.Apenas URLs de vídeo HTTP/HTTPS publicamente acessíveis são suportadas. Você pode enviá-lo junto com image_urls: as imagens são usadas como referência de identidade ou composição, enquanto o vídeo é usado como referência de movimento.
Omni-Flash-Ext suporta apenas 0 ou 1 vídeo de referência. Enviar 2 ou mais vídeos retorna um erro unsupported_video_count.
Não envie duration ao enviar video_urls. video_urls e duration não podem ser enviados ao mesmo tempo.

​
Resposta

​
code
integer
Código de status da resposta. Requisições bem-sucedidas retornam 200.
​
data
array
Array de tarefas retornado.

​
Consultar o resultado da tarefa

A geração de vídeo é assíncrona. Após a submissão, a API retorna um task_id. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados.
cURL
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task_01KS1H7ZYSJWH1N779S2FSHTKA \
  --header 'Authorization: Bearer <token>'
Recomendamos aguardar de 5 a 10 segundos após a submissão antes da primeira consulta e, em seguida, fazer polling a cada 5-10 segundos. Uma única tarefa geralmente é concluída em cerca de 3-5 minutos.

​
Exemplo de resultado bem-sucedido

{
  "code": 200,
  "data": {
    "id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
    "status": "completed",
    "progress": 100,
    "created": 1779246294,
    "completed": 1779246534,
    "actual_time": 240,
    "estimated_time": 600,
    "cost": 0.4,
    "result": {
      "videos": [
        {
          "url": ["https://cdn.example.com/videos/abc.mp4"],
          "expires_at": 1779332760
        }
      ]
    }
  }
}

​
Exemplo de resultado com falha

{
  "code": 200,
  "data": {
    "id": "task_01KS1H7ZYSJWH1N779S2FSHTKA",
    "status": "failed",
    "progress": 100,
    "created": 1779246294,
    "completed": 1779246534,
    "actual_time": 240,
    "estimated_time": 600,
    "cost": 0,
    "error": {
      "message": "invalid duration 7, must be one of 4/6/8/10",
      "code": "task_failed"
    }
  }
}

​
Casos de uso

​
Cenário 1: Texto para vídeo

{
  "model": "Omni-Flash-Ext",
  "prompt": "a beautiful sunset over the ocean with seagulls flying",
  "duration": 6,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

​
Cenário 2: Vídeo com imagem única

{
  "model": "Omni-Flash-Ext",
  "prompt": "make the character smile and slowly turn around, cinematic camera motion",
  "duration": 6,
  "resolution": "1080p",
  "aspect_ratio": "9:16",
  "image_urls": ["https://example.com/character.jpg"]
}

​
Cenário 3: Fusão com 3 imagens de referência

{
  "model": "Omni-Flash-Ext",
  "prompt": "a creative scene combining these elements with smooth camera motion",
  "duration": 10,
  "resolution": "1080p",
  "aspect_ratio": "9:16",
  "image_urls": [
    "https://example.com/scene.jpg",
    "https://example.com/character.jpg",
    "https://example.com/product.jpg"
  ]
}

​
Cenário 4: Vídeo curto em 4K

{
  "model": "Omni-Flash-Ext",
  "prompt": "close-up of a hummingbird hovering in front of a red flower",
  "duration": 4,
  "resolution": "4k",
  "aspect_ratio": "16:9"
}

​
Cenário 5: Geração com vídeo de referência

{
  "model": "Omni-Flash-Ext",
  "prompt": "the same scene but at night with neon lights",
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "video_urls": ["https://example.com/reference.mp4"]
}

​
Códigos de erro

HTTPTipo de erroSignificadoAção sugerida
400invalid_request_errormodel não é Omni-Flash-Ext, prompt está vazio ou o formato JSON é inválidoVerifique o corpo da requisição
400invalid_durationduration não é 4, 6, 8 ou 10Use uma duração suportada
400invalid_resolutionresolution não é 720p, 1080p ou 4kUse uma resolução suportada
400unsupported_image_countA quantidade de image_urls não é suportada, comumente causada pela passagem de 2 imagensUse 0, 1 ou 3 imagens
400unsupported_video_countA quantidade de video_urls não é suportada, comumente causada pelo envio de 2 ou mais vídeosUse 0 ou 1 vídeo de referência
401authentication_errorToken inválidoVerifique o Bearer Token
402payment_requiredSaldo insuficienteRecarregue e tente novamente
429rate_limit_errorLimite de taxa excedidoReduza a concorrência ou tente novamente mais tarde
Quando uma tarefa falha, a API de status da tarefa retorna o motivo da falha em data.error. Causas comuns incluem esgotamento temporário da cota upstream, falha na moderação de conteúdo ou timeout do upstream.