API de Exportação de Clipes

Use esta API quando você já criou uma tarefa de Clipping com IA ou Buscar Momentos e deseja renderizar clipes posteriormente, ou reexportá-los com diferentes estilos de legenda, proporção, gancho de IA ou outras configurações.

O project_id deve ser o ID da tarefa original retornado por:

POST /api/v2/clips
POST /api/v2/clips/find-moments

Enviar Tarefa de Exportação

POST https://wayinvideo-api.wayin.ai/api/v2/clips/export

Corpo da Requisição

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`project_id`	string	Sim	—	ID da tarefa original de Clipping com IA ou Buscar Momentos.
`clip_indices`	integer[]	Não	`null`	Índices dos clipes a exportar. Quando omitido, exporta todos os clipes.
`target_lang`	string	Não	`null`	Idioma de destino para legendas. Quando `null`, usa o idioma da tarefa original.
`resolution`	string	Não	`SD_480`	Resolução: `SD_480`, `HD_720`, `FHD_1080`, `QHD_2K`, `UHD_4K`.
`enable_caption`	boolean	Não	`false`	Adicionar legenda animada. Quando `true`, `caption_display` e `cc_style_tpl` têm efeito.
`caption_display`	string	Não	`original`	Modo de legenda: `both`, `original`, `translation`. Apenas quando `enable_caption` é `true`.
`cc_style_tpl`	string	Não	`temp-7`	ID do modelo de estilo de legenda. Apenas quando `enable_caption` é `true`.
`enable_ai_hook`	boolean	Não	`false`	Adicionar texto de gancho gerado por IA no início ou no fim de cada clipe.
`ai_hook_script_style`	string	Não	`serious`	Estilo do gancho: `serious`, `casual`, `informative`, `conversational`, `humorous`, `parody`, `inspirational`, `dramatic`, `empathetic`, `persuasive`, `neutral`, `excited`, `calm`.
`ai_hook_position`	string	Não	`beginning`	Posição: `beginning`, `end`.
`ai_hook_keywords`	string	Não	`null`	Palavras-chave opcionais para orientar o texto do gancho de IA.
`ai_hook_text_duration`	integer	Não	`null`	Duração da sobreposição de texto do gancho em milissegundos.
`enable_ai_reframe`	boolean	Não	`false`	Ativar Reencadramento com IA. Quando `true`, `ratio` é obrigatório.
`ratio`	string	Obrigatório quando `enable_ai_reframe` é `true`	—	Proporção: `RATIO_9_16`, `RATIO_1_1`, `RATIO_4_5`, `RATIO_16_9`.

Exemplo de Requisição

curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips/export \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{
    "project_id": "proj_abc123",
    "clip_indices": [0, 2],
    "resolution": "UHD_4K",
    "enable_caption": true,
    "caption_display": "both",
    "cc_style_tpl": "word-focus",
    "enable_ai_hook": true,
    "ai_hook_script_style": "serious",
    "ai_hook_position": "beginning",
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'

Resposta de Envio

{"data": {"export_task_id": "export_task_xyz789", "name": "sample export task", "status": "CREATED"}}

Campo	Tipo	Descrição
`export_task_id`	string	Identificador único da tarefa de exportação. Use este valor para consultar o progresso.
`name`	string	Nome da tarefa de exportação
`status`	string	`CREATED`, `QUEUED`, `ONGOING`, `SUCCEEDED`, `FAILED`

Obter Resultados de Exportação

GET https://wayinvideo-api.wayin.ai/api/v2/clips/export/{taskId}

curl -X GET https://wayinvideo-api.wayin.ai/api/v2/clips/export/export_task_xyz789 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"

{
  "data": {
    "export_task_id": "export_task_xyz789", "name": "sample export task",
    "status": "SUCCEEDED", "expire_at": 1775831883112, "cost_usage": 48.0,
    "clips": [
      {"idx": 0, "title": "sample title", "begin_ms": 15000, "end_ms": 75000,
       "thumbnail": "https://cdn.example.com/thumb/clip_001.jpg",
       "tags": ["insight", "analysis"], "desc": "sample description",
       "score": 81, "export_link": "https://cdn.example.com/export/clip_001.mp4"}
    ]
  }
}

Campos da Resposta

Campo	Tipo	Descrição
`export_task_id`	string	Identificador único da tarefa de exportação
`name`	string	Nome da tarefa de exportação
`status`	string	`CREATED`, `QUEUED`, `ONGOING`, `SUCCEEDED`, `FAILED`
`error_message`	string	Motivo do erro (apenas quando `FAILED`)
`expire_at`	integer	Timestamp de expiração em milissegundos
`cost_usage`	number	API Units consumidas
`clips`	array	Lista de clipes exportados