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"
  }'
import requests

url = "https://api.apimart.ai/v1/videos/generations"

payload = {
    "model": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
const url = "https://api.apimart.ai/v1/videos/generations";

const payload = {
  model: "Omni-Flash-Ext",
  prompt: "a girl is dancing happily in a sunny garden",
  duration: 10,
  resolution: "1080p",
  aspect_ratio: "9:16"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://api.apimart.ai/v1/videos/generations"

    payload := map[string]interface{}{
        "model":        "Omni-Flash-Ext",
        "prompt":       "a girl is dancing happily in a sunny garden",
        "duration":     10,
        "resolution":   "1080p",
        "aspect_ratio": "9:16",
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KS1H7ZYSJWH1N779S2FSHTKA"
    }
  ]
}
{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}
{
  "error": {
    "code": 401,
    "message": "Authentication failed. Please check your API key",
    "type": "authentication_error"
  }
}
{
  "error": {
    "code": 402,
    "message": "Insufficient account balance. Please recharge and try again",
    "type": "payment_required"
  }
}
{
  "error": {
    "code": 429,
    "message": "Too many requests. Please try again later",
    "type": "rate_limit_error"
  }
}
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"
  }'
import requests

url = "https://api.apimart.ai/v1/videos/generations"

payload = {
    "model": "Omni-Flash-Ext",
    "prompt": "a girl is dancing happily in a sunny garden",
    "duration": 10,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
const url = "https://api.apimart.ai/v1/videos/generations";

const payload = {
  model: "Omni-Flash-Ext",
  prompt: "a girl is dancing happily in a sunny garden",
  duration: 10,
  resolution: "1080p",
  aspect_ratio: "9:16"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://api.apimart.ai/v1/videos/generations"

    payload := map[string]interface{}{
        "model":        "Omni-Flash-Ext",
        "prompt":       "a girl is dancing happily in a sunny garden",
        "duration":     10,
        "resolution":   "1080p",
        "aspect_ratio": "9:16",
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KS1H7ZYSJWH1N779S2FSHTKA"
    }
  ]
}
{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}
{
  "error": {
    "code": 401,
    "message": "Authentication failed. Please check your API key",
    "type": "authentication_error"
  }
}
{
  "error": {
    "code": 402,
    "message": "Insufficient account balance. Please recharge and try again",
    "type": "payment_required"
  }
}
{
  "error": {
    "code": 429,
    "message": "Too many requests. Please try again later",
    "type": "rate_limit_error"
  }
}

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.
generation_type
string
Tipo de geração, usado para especificar como as imagens são usadas.Opções:
  • frame - Modo de primeiro frame. image_urls pode conter apenas 1 imagem, usada como o primeiro frame do vídeo.
  • reference - Modo de referência. image_urls pode conter 1 ou 3 imagens, usadas como imagens de referência.
Quando generation_type é frame, image_urls suporta apenas 1 imagem; passar qualquer outra quantidade retorna um erro unsupported_image_count.
image_urls
array<url>
Array de URLs de imagens de referência. Você pode omiti-lo, fornecer 1 imagem ou fornecer 3 imagens, dependendo de generation_type:
  • Omitido ou array vazio: Text-to-Video
  • 1 imagem: Image-to-Video com imagem única
  • 3 imagens: fusão de imagens de referência (suportado apenas quando generation_type é reference)
Relação com generation_type:
  • generation_type é frame: apenas 1 imagem pode ser enviada.
  • generation_type é reference: 1 ou 3 imagens podem ser enviadas.
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,
    "credits_cost": 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,
    "credits_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.