O modelo emoji-v1 gera vídeos de emojis faciais a partir de imagens de retrato e IDs de modelo predefinidos .
Visão geral do modelo
Modelo | Descrição |
|---|---|
emoji-v1 | Gera vídeos faciais a partir de imagens de retrato utilizando coordenadas faciais, coordenadas da área de expressão dinâmica e IDs de modelo. |
Pré-requisitos
- Obtenha uma chave de API e exporte a chave de API como uma variável de ambiente.
- Processe a imagem de entrada usando a Detecção de imagem Emoji para obter as coordenadas da área facial e da área de expressão dinâmica. Essas coordenadas são obrigatórias como parâmetros de entrada.
HTTP
A geração de vídeo geralmente leva de 1 a 5 minutos, portanto a API utiliza invocação assíncrona. Crie uma tarefa e, em seguida, consulte os resultados periodicamente.
O tempo de processamento varia conforme o tamanho da fila e o status do serviço. Aguarde a conclusão da tarefa.
Etapa 1: Crie uma tarefa e obter o ID da tarefa
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis
Parâmetros da requisição |
|
Headers | |
Content-Type string (Required)O tipo de conteúdo da requisição. Deve ser application/json. | |
Authorization string (Required)Autentica a requisição com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
X-DashScope-Async string (Required)Ative o processamento assíncrono. Requisições HTTP suportam apenas chamadas assíncronas. O valor deve ser enable. | |
Request body | |
model string (Required)Nome do modelo. Defina este parâmetro como emoji-v1. | |
input object (Required)Informações básicas de entrada, como imagem facial, área facial e área do emoji.
Properties image_url string (Required)URL pública de uma imagem facial frontal. Protocolos HTTP e HTTPS são suportados.Requisitos da imagem:
array of integer (Required)Coordenadas da área facial na imagem. O formato é [x1, y1, x2, y2] em pixels (pontos superior esquerdo e inferior direito).Defina este parâmetro com o valor do campo output.bbox_face obtido na resposta da API de Detecção de Imagem Emoji.Exemplo: [212.194.460.441].ext_bbox array of integer (Required)Coordenadas da área de expressão dinâmica. A proporção é de aproximadamente 1:1. O formato é [x1, y1, x2, y2] em pixels (pontos superior esquerdo e inferior direito).Defina este parâmetro com o valor do campo output.ext_bbox_face na resposta da API de Detecção de imagem Emoji.Exemplo: [63.30.609.575].Nota: A área de expressão dinâmica é a região quadrada em que o modelo se concentra durante a geração do vídeo. Geralmente é ligeiramente maior que a área facial, incluindo fundo e ombros para garantir uma animação natural.driven_id string (Required)ID do modelo predefinido. Para consultar a lista de valores válidos, veja Apêndice: Lista de IDs de modelos.Exemplo: mengwa_kaixin. |
Parâmetros de resposta |
Salve o task_id para consultar o status e o resultado da tarefa. |
output objectStatus e resultados da tarefa.
Properties task_id stringID da tarefa. Válido para consultas por 24 horas.task_status stringStatus atual da tarefa.
Enumeration values
| |
request_id stringIdentificador único da requisição para rastreamento e solução de problemas. | |
code stringCódigo de erro. Retornado apenas para requisições com falha. Consulte Códigos de erro. | |
message stringMensagem de erro detalhada. Retornada apenas para requisições com falha. Consulte Códigos de erro. |
Etapa 2: Consultar o resultado pelo ID da tarefa
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
- Recomendação de consulta periódica: A geração de vídeo leva vários minutos. Utilize um mecanismo de consulta com intervalo razoável, como 15 segundos.
- Transição de estado da tarefa: PENDING → RUNNING → SUCCEEDED ou FAILED.
- Link do resultado: Após o sucesso da tarefa, uma URL de vídeo válida por 24 horas é retornada. Baixe e salve o vídeo em armazenamento permanente, como o OSS.
- Validade dotask_id:24 horas**. Após esse período, as consultas retornam o status da tarefa como
UNKNOWN.
Parâmetros da requisição |
Substitua 86ecf553-d340-4e21-xxxxxxxxx pelo seu task_id real.As chaves de API são diferentes para cada região. Para mais informações, consulte Obter uma chave de API. Se você usar um modelo na região China (Beijing), substitua |
Headers | |
Authorization string (Required)Autentica a requisição com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
Parâmetros de caminho da URL | |
task_id string (Required)ID da tarefa. |
Parâmetros de resposta |
As URLs de vídeo são válidas apenas por 24 horas e depois são removidas automaticamente. Salve os vídeos gerados prontamente. |
outputobjectStatus e resultados da tarefa.
Properties task_id stringID da tarefa. Válido para consultas por 24 horas.task_status stringStatus atual da tarefa.
Enumeration values
stringHorário em que a tarefa foi enviada. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringHorário em que a tarefa foi executada. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.end_time stringHorário em que a tarefa foi concluída. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.video_url stringURL do vídeo gerado. Retornada apenas quando task_status é SUCCEEDED.Válida por 24 horas. O vídeo está no formato MP4 com codificação H.264.code stringCódigo de erro. Retornado apenas para requisições com falha. Consulte Códigos de erro.message stringMensagem de erro detalhada. Retornada apenas para requisições com falha. Consulte Códigos de erro. | |
usage objectEstatísticas de uso de saída (apenas tarefas bem-sucedidas).
Properties video_duration integerDuração do vídeo gerado em segundos.Faturamento: Custo = Duração do vídeo (segundos) × Preço unitário.video_ratio stringProporção do vídeo. Fixa em standard (1:1). | |
request_id stringIdentificador único da requisição para rastreamento e solução de problemas. |
Faturamento e limitação de taxa
- Para cota gratuita e preço unitário, consulte Modelos recomendados.
- Para limites de taxa, consulte Limitação de taxa.
Códigos de erro
Se uma chamada de modelo falhar, consulte Códigos de erro para resolver o problema.
Apêndice: Lista de IDs de modelos
Exemplo: { "input": { "driven_id": "mengwa_kaixin" } }.
- Pré-visualização dos efeitos gerados pelo aplicativo Tongyi (integra o modelo Emoji).
- Os vídeos gerados não incluem adesivos ou sobreposições de texto.
ID do Modelo (driven_id) | Prévia do efeito | ID do Modelo (driven_id) | Prévia do efeito |
|---|---|---|---|
mengwa_kaixin |  | dagong_zhuakuang |  |
mengwa_dengyan |  | dagong_wunai |  |
mengwa_gandong |  | dagong_weixiao |  |
mengwa_renzhen_1 |  | dagong_ganji |  |
mengwa_jidong |  | jingdian_tiaopi |  |
mengwa_kun_1 |  | jingdian_deyi_1 |  |
mengwa_jiaoxie |  | jingdian_qidai |  |
dagong_kaixin |  | jingdian_landuo_1 |  |
dagong_yangwang |  | jingdian_xianqi |  |
dagong_kunhuo |  | jingdian_lei |  |