Parâmetro
promptobrigatórioTipo
text
Valores
text description
Padrão
required
Preço
—
GetVibeAPITema
Idioma
Vídeo
HeyGen Avatar V API — como conectar e pagar
HeyGen Avatar V — o mais novo mecanismo de avatares falantes: um avatar pronto do HeyGen reproduz sua narração com movimentos e sincronização labial mais naturais do que o Avatar IV. Requer avatar (o nome de um avatar pronto do HeyGen, por exemplo, “Ann Doctor Standing”) e audio_url; o clipe tem a mesma duração do áudio (até 5 minutos). 720p / 1080p / 4K. Cobrado por segundo de vídeo gerado.
Crie o resultado de que você precisa
heygen-avatar-v:flowEste modelo publica apenas seu preço mínimo no catálogo.
Entrada: Texto, ÁudioAlguns modos exigem que você anexe: heygen avatar (ready-made avatar name), audio track
O que é HeyGen Avatar V
HeyGen Avatar V — o mais novo mecanismo de avatares falantes: um avatar pronto do HeyGen reproduz sua narração com movimentos e sincronização labial mais naturais do que o Avatar IV. Requer avatar (o nome de um avatar pronto do HeyGen, por exemplo, “Ann Doctor Standing”) e audio_url; o clipe tem a mesma duração do áudio (até 5 minutos). 720p / 1080p / 4K. Cobrado por segundo de vídeo gerado.
Resumo do contrato
- Entrada
- text, audio
- Saída
- video
- Modo
- assíncrono (job + polling)
- Consulta de status
- a cada 3 s · até 600 s
Pontos fortes
- Preços: por segundo
- Entradas: texto, áudio
- 3 opções configuráveis
- Uma chave de API para geração de mídia
Onde é usado
- Clipes para redes sociais
- Promos e sequências de títulos
- Animação de imagem estática
- Storyboards e animatics
Contrato da API
A geração é executada de forma assíncrona: crie um job e consulte o status até a conclusão.
- Criar job
- POST /api/media/generate
- Verificar status
- GET /api/media/jobs/{jobId}
- Entrada
- text, audio
- Saída
- video
- Consulta de status
- a cada 3 s · até 600 s
- Autenticação
- Authorization: Bearer sk-pv-…
Exemplo de solicitação
Envie sua chave no cabeçalho Bearer. A API retorna jobId para consultar o status.
curl -sS https://getvibeapi.com/api/media/generate \
-H "Authorization: Bearer $GETVIBE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary '{"model":"heygen-avatar-v:flow","opts":{"avatar":"example","audio_url":"https://example.com/audio_url.mp3","resolution":"720p","aspect_ratio":"auto"}}'JavaScript
const response = await fetch('https://getvibeapi.com/api/media/generate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.GETVIBE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "heygen-avatar-v:flow",
"opts": {
"avatar": "example",
"audio_url": "https://example.com/audio_url.mp3",
"resolution": "720p",
"aspect_ratio": "auto"
}
}),
});
if (!response.ok) throw new Error(`GetVibe API: ${response.status}`);
const { jobId } = await response.json();
console.log(jobId);Parâmetros da solicitação à API
Parâmetros para solicitações a HeyGen Avatar V por meio da GetVibe API.
Parâmetro
audio_urlTipo
URL
Valores
Public audio URL
Padrão
—
Preço
—
Parâmetro
avatarobrigatórioTipo
text / number
Valores
any value
Padrão
—
Preço
Included in the base price
Parâmetro
resolutionTipo
option selection
Valores
720p (default) · 1080p · 4K
Padrão
720p
Preço
Included in the base price
Parâmetro
aspect_ratioTipo
option selection
Valores
Auto (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1
Padrão
Auto
Preço
Included in the base price
Parâmetro
audio_file_idTipo
text
Valores
Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…)
Padrão
—
Preço
Included in the base price
Parâmetro
audio_base64Tipo
text
Valores
Alternative to audio_url: the file inline, as base64 or a data: URI
Padrão
—
Preço
Included in the base price
| Parâmetro | Tipo | Valores | Padrão | Preço |
|---|---|---|---|---|
promptobrigatório | text | text description | required | — |
audio_url | URL | Public audio URL | — | — |
avatarobrigatório | text / number | any value | — | Included in the base price |
resolution | option selection | 720p (default) · 1080p · 4K | 720p | Included in the base price |
aspect_ratio | option selection | Auto (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1 | Auto | Included in the base price |
audio_file_id | text | Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…) | — | Included in the base price |
audio_base64 | text | Alternative to audio_url: the file inline, as base64 or a data: URI | — | Included in the base price |
Solicitação: POST https://getvibeapi.com/api/media/generate. Preços em USD.
Preço de HeyGen Avatar V
O custo de HeyGen Avatar V: de $0.142857 per second. O preço é calculado dinamicamente pela taxa de câmbio atual, e a cobrança final é mostrada na resposta da API (priceRub). Pagamento em USD, sem assinaturas.
Quanto custa uma solicitação padrão
Sem parâmetros enviados, a solicitação usa estes valores: Resolution — 720p, Frame format — Auto. Essa solicitação custa $0.142857.
README
O contrato legível por máquina de HeyGen Avatar V contém o esquema da solicitação, as operações, os limites, a consulta de status e exemplos de resposta.
# HeyGen Avatar V
Modelo público: heygen-avatar-v:flow
Criar job: POST /api/media/generate
Verificar status: GET /api/media/jobs/{jobId}
## Parâmetros de entrada
- `prompt` (text): text description; padrão: required
- `audio_url` (URL): Public audio URL; padrão: —
- `avatar` (text / number): any value; padrão: —
- `resolution` (option selection): 720p (default) · 1080p · 4K; padrão: 720p
- `aspect_ratio` (option selection): Auto (default) · 16:9 · 9:16 · 4:5 · 5:4 · 1:1; padrão: Auto
- `audio_file_id` (text): Alternative to audio_url: the id of your own file from POST /v1/files (file-pv-…); padrão: —
- `audio_base64` (text): Alternative to audio_url: the file inline, as base64 or a data: URI; padrão: —
## Variantes públicas
- `heygen-avatar-v:flow`: padrãoPerguntas frequentes sobre a API HeyGen Avatar V
Quanto custa HeyGen Avatar V?
O preço de HeyGen Avatar V: de $0.142857 per second. O preço é calculado dinamicamente pela taxa de câmbio atual.
É compatível com o OpenAI SDK?
Sim, a API é totalmente compatível com a OpenAI. Basta alterar base_url para https://getvibeapi.com/v1 e definir sua chave — o restante do código permanece igual.
Conecte HeyGen Avatar V agora
Cadastre-se em um minuto, pague conforme o uso e aproveite o código pronto acima.
Obter chave de API