Criar uma tarefa de geração de vídeo

post/v1/video/generations

Envia uma tarefa de geração de vídeo. Tanto texto para vídeo quanto imagem para vídeo são suportados.

Retorna um ID de tarefa que você pode consultar periodicamente pelo endpoint GET.

Autenticação

Envie sua chave de API da OLETOKEN como token Bearer. As chaves são criadas na página Chaves de API do console.

Authorization: Bearer $OLETOKEN_API_KEY

Corpo da requisição

Content-Type:application/json

Campo	Tipo	Obrigatório	Descrição
model	`string`	—	ID do modelo ou do estilo
prompt	`string`	—	Prompt de texto
image	`string`	—	Entrada de imagem (URL ou Base64)
duration	`number`	—	Duração do vídeo em segundos
width	`integer`	—	Largura do vídeo
height	`integer`	—	Altura do vídeo
fps	`integer`	—	Taxa de quadros do vídeo
seed	`integer`	—	Semente aleatória
n	`integer`	—	Número de vídeos a gerar
response_format	`string`	—	Formato da resposta
user	`string`	—	Identificador do usuário
metadata	`object`	—	Parâmetros extras (como negative_prompt, style, quality_level)

Respostas

200Tarefa de geração de vídeo criada

Campo	Tipo	Obrigatório	Descrição
task_id	`string`	—	ID da tarefa
status	`string`	—	Status da tarefa

400Parâmetros de requisição inválidos

Campo	Tipo	Obrigatório	Descrição
error	`object`	—	—
message	`string`	—	Mensagem de erro
type	`string`	—	Tipo de erro
param	`string \| null`	—	O parâmetro envolvido
code	`string \| null`	—	Código de erro

Requisição de exemplo

curl -X POST 'https://api.oletoken.ai/v1/video/generations' \
  -H "Authorization: Bearer $OLETOKEN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-v1",
    "prompt": "宇航员在月球上漫步",
    "duration": 5,
    "width": 1280,
    "height": 720
  }'