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": "grok-imagine-1.0-video-apimart",
    "prompt": "A dog running on the beach, sunny weather, slow motion",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'
{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

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": "grok-imagine-1.0-video-apimart",
    "prompt": "A dog running on the beach, sunny weather, slow motion",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'
{
  "code": 200,
  "data": {
    "id": "task_01JNXXXXXXXXXXXXXXXXXX",
    "status": "submitted",
    "progress": 0,
    "created": 1710000000,
    "type": "video"
  }
}

Autorizações

Authorization
string
obrigatório
Todas as APIs exigem autenticação via Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione-a ao cabeçalho da requisição:
Authorization: Bearer YOUR_API_KEY

Parâmetros da requisição

model
string
padrão:"grok-imagine-1.0-video-apimart"
obrigatório
Nome do modelo de geração de vídeoModelos suportados:
  • grok-imagine-1.0-video-apimart - Geração de vídeo Grok
Exemplo: "grok-imagine-1.0-video-apimart"
prompt
string
obrigatório
Descrição do conteúdo do vídeo, suporta vários idiomas
size
string
padrão:"16:9"
Tamanho do vídeoOpções:
  • 16:9 - Paisagem (padrão)
  • 9:16 - Retrato
  • 1:1 - Quadrado
  • 3:2 - Paisagem
  • 2:3 - Retrato
duration
integer
padrão:6
Duração do vídeo (segundos)Faixa: 6-30 (mínimo de 6 segundos, máximo de 30 segundos)⚠️ Nota: Deve ser um número simples (por exemplo, 6), sem aspas, caso contrário ocorrerá um erro
quality
string
padrão:"480p"
Qualidade do vídeoOpções:
  • 480p - Definição padrão (padrão)
  • 720p - Alta definição
image_urls
string[]
Lista de URLs de imagens de referênciaLimites:
  • No máximo 7 imagens
  • Devem ser URLs publicamente acessíveis
  • O formato Base64 não é suportado
Após o envio de uma imagem de referência, a proporção será automaticamente ajustada para corresponder à proporção da imagem de referência.

Resposta

code
integer
Código de status da resposta
data
object
Objeto de dados da resposta
Consultar o resultado da tarefaA geração de vídeo é uma tarefa assíncrona. Após a submissão, será retornado um id (ou seja, task_id). Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.

Casos de uso

Caso 1: Texto para vídeo

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "A dog running on the beach, sunny weather, slow motion",
  "size": "16:9",
  "duration": 6
}

Caso 2: Imagem para vídeo

{
  "model": "grok-imagine-1.0-video-apimart",
  "prompt": "Bring the scene to life with natural dynamic effects",
  "image_urls": ["https://example.com/start.png"],
  "size": "16:9",
  "duration": 10,
  "quality": "720p"
}