Renderização de Vídeo Musical

curl --request POST \
  --url https://api.apimart.ai/v1/music/generations/videoClipFlowMusic \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "preset": "modern"
  }'

import requests

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

payload = {
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "preset": "modern"
}

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/music/generations/videoClipFlowMusic";

const payload = {
  model: "flowmusic",
  clip_id: "abc123-def456",
  preset: "modern"
};

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));

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

{
  "error": {
    "message": "clip_id is required",
    "type": "invalid_request",
    "param": "",
    "code": "invalid_request"
  }
}

{
  "error": {
    "message": "Saldo insuficiente",
    "type": "invalid_request",
    "param": "",
    "code": "quota_not_enough"
  }
}

{
  "error": {
    "message": "A capacidade do grupo atual está saturada, tente novamente mais tarde",
    "type": "rate_limit_error",
    "param": "",
    "code": "rate_limit_error"
  }
}

POST

music

generations

videoClipFlowMusic

curl --request POST \
  --url https://api.apimart.ai/v1/music/generations/videoClipFlowMusic \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "preset": "modern"
  }'

import requests

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

payload = {
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "preset": "modern"
}

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/music/generations/videoClipFlowMusic";

const payload = {
  model: "flowmusic",
  clip_id: "abc123-def456",
  preset: "modern"
};

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));

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

{
  "error": {
    "message": "clip_id is required",
    "type": "invalid_request",
    "param": "",
    "code": "invalid_request"
  }
}

{
  "error": {
    "message": "Saldo insuficiente",
    "type": "invalid_request",
    "param": "",
    "code": "quota_not_enough"
  }
}

{
  "error": {
    "message": "A capacidade do grupo atual está saturada, tente novamente mais tarde",
    "type": "rate_limit_error",
    "param": "",
    "code": "rate_limit_error"
  }
}

curl --request POST \
  --url https://api.apimart.ai/v1/music/generations/videoClipFlowMusic \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "preset": "modern"
  }'

import requests

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

payload = {
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "preset": "modern"
}

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/music/generations/videoClipFlowMusic";

const payload = {
  model: "flowmusic",
  clip_id: "abc123-def456",
  preset: "modern"
};

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));

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

{
  "error": {
    "message": "clip_id is required",
    "type": "invalid_request",
    "param": "",
    "code": "invalid_request"
  }
}

{
  "error": {
    "message": "Saldo insuficiente",
    "type": "invalid_request",
    "param": "",
    "code": "quota_not_enough"
  }
}

{
  "error": {
    "message": "A capacidade do grupo atual está saturada, tente novamente mais tarde",
    "type": "rate_limit_error",
    "param": "",
    "code": "rate_limit_error"
  }
}

Autenticação

Authorization

string

obrigatório

Todos os endpoints exigem autenticação via Bearer TokenObtenha sua API Key:Acesse a página de gerenciamento de API Keys para obter sua API KeyAo usar, adicione ao cabeçalho da requisição:

Authorization: Bearer YOUR_API_KEY

Parâmetros da Requisição

model

string

obrigatório

Nome do modelo, sempre passe "flowmusic" (não diferencia maiúsculas de minúsculas)

clip_id

string

obrigatório

clip_id da música para a qual o vídeo será gerado, proveniente de result.music[].clip_id de uma tarefa concluída com sucesso

preset

string

padrão:"simple"

Predefinição do modelo de vídeoValores possíveis:

simple - modelo minimalista
modern - modelo de estilo moderno
player - modelo em estilo de player

Resposta

code

integer

Código de status da resposta, 200 em caso de sucesso

data

array

Array de dados retornados

Mostrar Elementos do array

status

string

Status da tarefa, submitted no envio inicial

task_id

string

Identificador único da tarefa, usado para consultar o status e o resultado da tarefa

Casos de Uso

Cenário 1: Renderizar o vídeo musical com o modelo modern

{
  "model": "flowmusic",
  "clip_id": "abc123-def456",
  "preset": "modern"
}

Consultar o Resultado da TarefaA renderização do vídeo musical é uma tarefa assíncrona; após o envio, um task_id é retornado. Use o endpoint Obter Status da Tarefa para consultar o progresso e o resultado da geração. O resultado fica em result.music[0].video_url.

Exemplo de Resultado de Tarefa Concluída

Exemplo de resposta da consulta (GET /v1/music/tasks/{task_id}):

{
  "code": 200,
  "data": {
    "id": "task_01KWXVD4HQEEY7B5NJ31177Q1H",
    "status": "completed",
    "progress": 100,
    "created": 1783413248,
    "completed": 1783413327,
    "actual_time": 79,
    "cost": 0.016,
    "credits_cost": 0.16,
    "result": {
      "music": [
        {
          "clip_id": "a41aade4-993e-4d28-b56f-d97e7ef7167c",
          "video_url": "https://cdn.apimart.ai/video/flowmusic_a41aade4_video_clip.mp4",
          "url": "https://cdn.apimart.ai/video/flowmusic_a41aade4_video_clip.mp4"
        }
      ]
    }
  }
}

Baixar Áudio Consultar Tarefa

​Autenticação

​Parâmetros da Requisição

​Resposta

​Casos de Uso

​Cenário 1: Renderizar o vídeo musical com o modelo modern

​Exemplo de Resultado de Tarefa Concluída

Autenticação

Parâmetros da Requisição

Resposta

Casos de Uso

Cenário 1: Renderizar o vídeo musical com o modelo modern

Exemplo de Resultado de Tarefa Concluída