HeyGen: HeyGen Video
HeyGen Video gera cenas de 5–15 segundos com diálogo, ambiente e efeitos a partir de texto, de uma imagem inicial ou de referências visuais e de áudio. O seu modelo de uso geral heygen-video-1 suporta planos de produtos e personagens, com controlos de referência e saída MP4. Ações claras e bem delimitadas fornecem-lhe instruções de produção úteis.
Sobre o modelo
Esta descrição apresenta as capacidades do modelo. As entradas, saídas e opções disponíveis no Ailoot para o método selecionado estão indicadas abaixo.
HeyGen Video é o modelo de geração de cenas de uso geral da HeyGen, identificado pelo fabricante como heygen-video-1. Cria em conjunto o sujeito, o cenário, a luz e o som a partir de instruções criativas. Cada clipe tem 5–15 segundos e contém a sua faixa de áudio gerada, incluindo diálogo, ambiente e efeitos. As entradas úteis para produção incluem uma descrição de cena, uma fotografia de produto ou material que estabelece uma pessoa, um local ou um movimento. O recurso resultante é uma cena curta para uma apresentação de produto, um segmento de integração de utilizadores, uma vista de imóvel ou outro trabalho de montagem de vídeo.
Três modos atribuem papéis diferentes às entradas. Texto para vídeo cria uma cena a partir da instrução. Imagem para vídeo começa literalmente na imagem fornecida e segue depois as instruções de ação. Referências para vídeo utiliza imagens, vídeo e áudio opcional fornecidos para orientar uma cena com uma nova composição; exige pelo menos uma imagem ou um vídeo de referência. Escolha uma imagem para o primeiro fotograma quando a composição inicial tiver de corresponder a uma imagem fixa, ou referências quando um objeto conhecido deva aparecer numa composição diferente. Este modelo de cenas é distinto dos motores de renderização de avatares da HeyGen e do fluxo de composição do Video Agent.
O guia do fabricante favorece indicações de plano detalhadas e concretas: um sujeito, um local e uma ação delimitada, com uma câmara fixa ou em movimento suave. Descreva a posição da câmara, a intenção quanto à objetiva ou à profundidade de campo, a luz, a textura das superfícies e o tratamento de cor. Explique onde os objetos se tocam quando uma ação depende de contacto. Num exemplo original de produto, utilize uma fotografia de referência de uma garrafa térmica de viagem e peça que fique sobre um balcão de madeira enquanto um apresentador fala ao seu lado, com um pequeno movimento de câmara em direção à garrafa. Inspecione a forma, a posição e as marcas visíveis da garrafa no resultado.
As listas de referências suportam até nove imagens, três vídeos e três elementos de áudio, com um máximo de doze referências no total. As imagens, os vídeos e o áudio são numerados separadamente no formato de instrução do fabricante: a primeira imagem é <Picture 1> e o primeiro vídeo é <Video 1>. Dê um papel a cada referência e identifique-o explicitamente nas instruções. O modelo lê os primeiros cinco segundos de cada vídeo de referência, pelo que deve colocar a secção relevante no início. A referência da API especifica também proporções de vídeo de referência entre 1:4 e 4:1. Um clipe longo que contenha o movimento pretendido apenas no fim é uma preparação inadequada para essa janela de entrada de cinco segundos.
A interface de referências documentada aceita um recurso HTTPS diretamente acessível, um identificador de recurso carregado ou base64 em linha. O guia indica tamanhos máximos de imagem de 16 MB por URL e 5 MB em linha; vídeo ou áudio podem ter até 32 MB por URL e 16 MB em linha. Prepare material de origem legível, com o sujeito importante facilmente distinguível e sem instruções concorrentes em referências diferentes. Mantenha a orientação pretendida na imagem do primeiro fotograma. Estes pormenores de entrada dizem respeito ao fluxo de referências do fabricante e ajudam a organizar os materiais criativos para o modo selecionado.
Oriente o som nas mesmas instruções que a imagem. Indique o diálogo, a interpretação vocal, o som ambiente da sala e os efeitos específicos, incluindo se um som deve estar próximo ou distante. Especifique o tratamento musical pretendido quando a cena deve conter apenas fala e ambiente. O guia sugere prever aproximadamente 2,5 palavras faladas por segundo como estimativa de planeamento, pelo que deve deixar espaço para pausas e para a ação visível. Uma introdução curta pode ser planeada como uma fala seguida de um momento que revela o produto. Ouça as palavras efetivamente produzidas e verifique se o som gerado se adequa ao espaço e à ação.
A duração de saída é selecionada em segundos inteiros de cinco a quinze, com cinco segundos por predefinição. A resolução é uma classe de tamanho: 480p, 768p, 1080p ou 2k. As opções documentadas de enquadramento são 21:9, 16:9, 4:3, 1:1, 3:4 e 9:16. Para texto para vídeo e referências para vídeo a 1080p ou 2k, selecione 16:9 ou 9:16; o enquadramento adaptativo de referências está documentado a 480p e 768p. Imagem para vídeo segue as proporções da primeira imagem, pelo que deve recortar antes da geração quando a forma exigida mudar. Reveja as dimensões reais do resultado concluído, em vez de presumir que um rótulo de classe de tamanho implica um determinado par convencional de dimensões em píxeis.
O guia do modelo especifica vídeo MP4 com codificação de imagem H.264 e áudio AAC estéreo a 32 kHz. Uma geração é processada de forma assíncrona, e a tarefa concluída fornece a localização do vídeo reproduzível, a duração e as dimensões. A sua localização de vídeo assinada pode ser renovada ao consultar novamente a tarefa. Preserve o clipe efetivo, os materiais de referência e as instruções para revisão da montagem. Um registo pendente ou em processamento acompanha a geração; o vídeo concluído é o recurso de produção a avaliar quanto à imagem, à fala e ao som.
O fabricante documenta as opções de melhoramento de instruções turbo, quality e disabled; disabled mantém a redação preparada tal como foi escrita. Uma semente fixa é útil para comparar uma alteração numa cláusula, mantendo as restantes entradas. Registe a semente e as definições escolhidas com as instruções do plano. Para texto no ecrã, mantenha a frase pretendida curta e escreva-a com precisão; o guia recomenda compor posteriormente parágrafos, letras pequenas e diagramas com rótulos. Verifique cada carácter visível num título gerado, em vez de presumir que a redação foi reproduzida corretamente.
O guia identifica como áreas menos fiáveis o texto longo no ecrã, o movimento orgânico suave, como pétalas, papel ou cabelo, e a manipulação de perto com as mãos. Para uma explicação de procedimentos, deixe que uma frase claramente escrita transmita os passos enquanto a imagem mostra uma pessoa ou um objeto estável; utilize elementos visuais verificados separadamente quando a própria operação física tiver de ser exata. Reveja todo o plano quanto à continuidade dos objetos, ao contacto, ao pormenor do rosto e das mãos, ao diálogo e ao som. Uma lista concisa do que deve mudar na próxima tomada mantém práticas umas instruções de produção detalhadas.
Ailoot Ultra · Vídeo POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1Introdução
HeyGen Video gera cenas de 5–15 segundos com diálogo, ambiente e efeitos a partir de texto, de uma imagem inicial ou de referências visuais e de áudio. O seu modelo de uso geral heygen-video-1 suporta planos de produtos e personagens, com controlos de referência e saída MP4. Ações claras e bem delimitadas fornecem-lhe instruções de produção úteis.
- Entradas aceites
- Texto · Imagens · Áudio · Vídeo
- Resultados
- Vídeo
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · Vídeo POST /v1/videos
- Entrada
text,image,audio,video- Saída
video- Formato de saída
- bytes MP4 originais; sem normalização nem transcodificação
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites heygen/heygen-video-1 | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites | Predefinição— |
Campoduration | Tipointeger | RequisitoObrigatório | Valores e limites 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mínimo: 1 Máximo: 600 | Predefinição— |
Camporesolution | Tipostring | RequisitoOpcional | Valores e limites 480p, 768p, 2K | Predefinição— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores e limites 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Predefinição— |
Campogenerate_audio | Tipoboolean | RequisitoOpcional | Valores e limites false | Predefinição— |
Campoframe_images | Tipoarray | RequisitoOpcional | Valores e limites Número mínimo de elementos: 1 Número máximo de elementos: 1 Conteúdo de entrada: Matriz de objetos de fotograma. Cada objeto tem type=image_url, image_url com url e frame_type. Utilize um URL HTTPS de imagem e defina frame_type como first_frame. Cada função de fotograma aparece, no máximo, uma vez. Chaves exatas: type, image_url, frame_type Condições: Estas chaves descrevem cada objeto de fotograma; image_url contém apenas url. Omita frame_images num pedido apenas de texto. | Predefinição— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores e limites | Predefinição— |
Camposeed | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: -9 223 372 036 854 775 808 Máximo: 9 223 372 036 854 775 807 | Predefinição— |
Campocallback_url | Tipostring | RequisitoOpcional | Valores e limites Padrão: ^https:// | Predefinição— |
Camposession_id | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campotrace | Tipoobject | RequisitoOpcional | Valores e limites | Predefinição— |
Campouser | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Combinações de materiais de entrada
Texto para vídeo · Uma instrução escrita. · Obrigatório: model, prompt, duration
Forneça prompt como texto e duration em segundos inteiros. Escolha uma resolução suportada e, se necessário, uma proporção.
model: Tipo: string · heygen/heygen-video-1
prompt: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim
Imagem para vídeo · Uma instrução escrita e uma imagem do primeiro fotograma. · Obrigatório: model, prompt, duration, frame_images
frame_images é uma matriz. Cada objeto de fotograma tem type, image_url e frame_type; image_url contém url. Defina type como image_url. Utilize first_frame. Cada função de fotograma aparece, no máximo, uma vez. Forneça um URL HTTPS público de imagem para cada fotograma. Escolha uma resolução suportada e, se necessário, uma proporção.
Chaves exatas: type, image_url, frame_type
model: Tipo: string · heygen/heygen-video-1
prompt: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim
Reference to video · Uma instrução escrita e referências de imagem, vídeo e áudio suportadas. · Obrigatório: model, prompt, duration, input_references
input_references é uma matriz de objetos. Defina type como image_url, video_url ou audio_url e utilize o campo correspondente que contém url. Utilize URLs HTTPS públicos. Omita frame_images para selecionar o modo de referência. Escolha uma resolução suportada e, se necessário, uma proporção.
model: Tipo: string · heygen/heygen-video-1
prompt: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt, duration |
Parâmetromaterial_types | Contratotext, image, audio, video |
Parâmetroadditional_properties | Contratofalse |
Parâmetrooptional_controls | Contratoresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tarifários
Cálculo do custo final
As tarifas apresentadas permitem estimar o custo antes da geração. O montante final cobrado é calculado a partir do custo registado para a geração original. A duração medida do resultado e as quantidades previstas não correspondem à quantidade final faturável.
As referências tarifárias não acrescentam opções ao pedido. Os parâmetros suportados constam do método selecionado.
- Modo rápido
- Não especificado Quando o modo rápido está selecionado
- Modo flex
- Não especificado Quando o modo flex está selecionado
- Esforço máximo de raciocínio
- Não especificado Quando o esforço máximo de raciocínio usa o ajuste predefinido (default)
Tarifas estimadas para comparação
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Tabela de tarifas | Quantidade prevista | Unidade de faturação | Condições de faturação | Custo |
|---|---|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Unidade de faturação— | Condições de faturação— | Custo Entrada · Tokens de entrada · Estimativa apenas para comparação — / 1K tokens Saída · Tokens de saída · Estimativa apenas para comparação — / 1K tokens Entrada · Leitura da cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache · Estimativa apenas para comparação — / 1K tokens Entrada · Escrita na cache, 1 hora · Estimativa apenas para comparação — / 1K tokens |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoresolution: 2k | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.2 por segundo de vídeo |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoresolution: 480p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.04 por segundo de vídeo |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoresolution: 768p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.072 por segundo de vídeo |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãomodo de geração: reference; resolução: 2k | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.36 por segundo de vídeo |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãomodo de geração: reference; resolução: 480p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.14 por segundo de vídeo |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãomodo de geração: reference; resolução: 768p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.2 por segundo de vídeo |
| Configuraçãoimagem de entrada de referência | Tabela de tarifas— | Quantidade prevista— | Unidade de faturaçãopor imagem de referência de entrada | Condições de faturação— | Custo Entrada · imagem de entrada de referência · Estimativa apenas para comparação $0.08 por imagem de referência de entrada |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Unidade de faturação— | Condições de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.2 estimativa antes da geração Esta estimativa não é um encargo adicional nem uma tarifa fixa para a geração concluída. |
O Ailoot reserva um montante estimado antes de um pedido. Após o resultado, liquida o custo final com base na utilização medida. No streaming, a liquidação usa o registo final de utilização. Como funcionam a reserva e a liquidação →
Detalhes da tarifa de referência
As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado.
Referências de preços das configurações de vídeo
Preços por configuração
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Condições de faturação | Custo |
|---|---|---|
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoresolution: 2k | Custo Saída · Preço do vídeo $0.18 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoresolution: 480p | Custo Saída · Preço do vídeo $0.04 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoresolution: 768p | Custo Saída · Preço do vídeo $0.06 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: reference; resolução: 2k | Custo Saída · Preço do vídeo $0.36 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: reference; resolução: 480p | Custo Saída · Preço do vídeo $0.08 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: reference; resolução: 768p | Custo Saída · Preço do vídeo $0.12 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
Exemplos de pedidos
Ailoot Ultra · Vídeo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Receber e guardar os resultados
Ailoot Ultra · Vídeo
URLs assinados para conteúdo pertencente ao utilizador
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Verificar o estado da tarefa
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Outras leituras de conteúdo
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Guardar todos os resultados concluídos
Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.
Conserve todos os resultados reais que pertencem ao utilizador e os respetivos metadados medidos devolvidos.
Se for necessário verificar a resposta original
503 result_pending_check + id original + X-Should-Retry:false; nunca repita o original
Campos da resposta
| Campo | Tipo | Significado |
|---|---|---|
Campoindex | Tipointeger | SignificadoPosição deste vídeo na lista de saídas, com contagem a partir de zero. |
Campocontent_url | Tipostring | SignificadoURL HTTPS assinado para transferir este vídeo concluído. |
Camposha256 | Tipostring | null | SignificadoResumo criptográfico SHA-256 dos bytes do vídeo original; null se não estiver disponível. |
Camposize_bytes | Tipointeger | null | SignificadoTamanho do ficheiro de vídeo original em bytes; null se não estiver disponível. |
Campoduration_ms | Tipointeger | null | SignificadoDuração medida do vídeo em milissegundos; null se não estiver disponível. |
Campowidth | Tipointeger | null | SignificadoLargura do vídeo em píxeis; null se não estiver disponível. |
Campoheight | Tipointeger | null | SignificadoAltura do vídeo em píxeis; null se não estiver disponível. |
Campovideo_codec | Tipostring | null | SignificadoIdentificador do codec de vídeo; null se não estiver registado. |
Campohas_audio | Tipoboolean | null | SignificadoIndica se o vídeo contém uma faixa de áudio; null se não tiver sido medido. |
Campoaudio_codec | Tipostring | null | SignificadoIdentificador do codec de áudio; null quando não está registado qualquer identificador. |
Erros e passos seguintes
| Resposta | Condição | Passo seguinte |
|---|---|---|
Resposta404 · not_found_error | CondiçãoO acesso ao vídeo não está disponível ou este ID de vídeo não foi encontrado. | Passo seguinteVerifique o acesso ao vídeo. Para um vídeo existente, utilize o ID público original e a mesma chave API. |
Resposta401 · authentication_error | CondiçãoA chave API não corresponde à conta autenticada. | Passo seguinteVerifique a sua chave API e o acesso à conta antes de enviar. |
Resposta400 · invalid_request_error | CondiçãoNão foi possível ler o pedido ou o índice de transferência é inválido. | Passo seguinteCorrija o corpo do pedido. Para uma transferência, escolha um índice de saída devolvido pela tarefa original. |
Resposta422 · price_unavailable | CondiçãoNão é possível calcular o preço da configuração de vídeo selecionada. | Passo seguinteEscolha uma configuração de vídeo suportada e preencha as opções obrigatórias antes de enviar um pedido corrigido. |
Resposta422 · invalid_request_error | CondiçãoUma entrada de vídeo ou a tarefa original de continuação é inválida. | Passo seguinteUtilize entradas HTTPS válidas. Para continuação, utilize o ID público do seu vídeo original concluído com a mesma chave API. |
Resposta402 · billing_error | CondiçãoO saldo disponível ou os limites não permitem efetuar uma reserva. | Passo seguinteVerifique o saldo disponível e os limites antes de enviar um novo pedido. |
Resposta503 · server_error | CondiçãoA verificação, o armazenamento ou o acesso ao serviço de vídeo está temporariamente indisponível. | Passo seguinteAguarde a disponibilidade do serviço. Se já tiver um ID de vídeo, consulte essa tarefa original em vez de criar outra geração. |
Resposta503 · result_pending_check | CondiçãoO resultado e a cobrança do vídeo original precisam de verificação. | Passo seguinteConserve o ID de vídeo devolvido e consulte essa tarefa. Não envie um pedido de geração substituto enquanto estiver a ser verificada. |
Resposta503 · owned_result_unavailable | CondiçãoA transferência do vídeo existente está temporariamente indisponível. | Passo seguinteConsulte a mesma tarefa de vídeo mais tarde e transfira a saída existente. Uma nova geração cria uma operação separada. |
Resposta409 · video_not_ready | CondiçãoO conteúdo do vídeo não foi publicado. | Passo seguinteConsulte o estado da tarefa original. Transfira quando indicar completed; se indicar failed, siga o aviso de verificação da cobrança. |
Aliases
Aliases do modelo
Ailoot Ultra heygen/heygen-video-1
Aliases dos caminhos dos métodos
Use os caminhos dos métodos indicados acima.
IDs de chamada relacionados
FAQ · HeyGen: HeyGen Video
- Que entradas e resultados estão disponíveis?
POST /v1/videos·heygen/heygen-video-1:text,image,audio,video→video- Que campos utiliza o pedido?
POST /v1/videos·heygen/heygen-video-1:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,seed,callback_url,session_id,trace,user- Que limites se aplicam?
POST /v1/videos·heygen/heygen-video-1:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807