A API de consistência de caracteres do Muapi transforma uma ou mais imagens de referência em assuntos repetíveis para imagens e vídeos. Compare modelos leves de referência única, pacotes de referência maiores e endpoints multimodais de referência para vídeo sem integrar cada fornecedor separadamente.
Um ponto final de referência única de baixo custo para transportar um assunto para uma nova imagem.
Preserve uma identidade de personagem reconhecível enquanto gera uma nova cena ilustrada ou fotorreal.
Use de uma a três referências quando o sujeito precisar de um controle mais forte de identidade e aparência.
Uma opção multimodal gratuita para combinar vários personagens ou referências de guarda-roupa em um único prompt.
Geração de vídeo orientada por referência com um pacote de até sete imagens para assuntos consistentes.
Use um pacote de referência maior para orientar a identidade e a continuidade visual no vídeo gerado.
Geração premium de referência para vídeo para tomadas cinematográficas com um assunto controlado.
Crie um assunto de vídeo consistente a partir de múltiplas visualizações e um prompt direcionado em linguagem natural.
Combine referências visuais e temporais quando a aparência, o movimento e o som de um personagem são importantes.
Um endpoint de referência de alta capacidade para pacotes de personagens complexos e continuidade de vídeo em várias cenas.
Uma API de consistência de personagens usa uma ou mais imagens de referência para reproduzir o mesmo assunto em novas cenas, poses, roupas e ângulos de câmera. Modelos de referência de imagem são úteis para fichas de personagens e fotos; modelos de referência ao vídeo colocam essa identidade em movimento.
Muapi expõe ambas as famílias por meio do mesmo fluxo de envio e pesquisa REST. Escolha um modelo por tamanho do pacote de referência, modalidade de entrada, preço ou se a saída deve ser uma imagem ou um vídeo.
Transforme a imagem original de um personagem em novas fotos, preservando características faciais, roupas e identidade visual reconhecíveis.
Anime um objeto referenciado em uma nova cena com modelos que suportam saída de vídeo, movimento e direção de cena.
O catálogo torna visível o limite prático de referência de cada modelo, desde uma imagem até embalagens de até trinta.
Use endpoints que aceitem combinações de imagens, vídeo ou áudio quando a identidade incluir movimento, voz ou tempo.
Passe explicitamente o tipo de tarefa específico do modelo e os campos de referência para que os trabalhos assíncronos falhem com menos frequência e sejam mais fáceis de tentar novamente.
Comece com referências de imagens gratuitas ou de baixo custo e, em seguida, passe para modelos de vídeo premium somente quando a filmagem exigir.
| Modelo | Provedor | Preço | Melhor para |
|---|---|---|---|
| Referência de assunto MiniMax | MiniMax | $0.01/generation | Referência de imagem única de menor custo |
| Personagem de ideograma | Ideograma | $0.15/generation | Imagens estáticas ilustradas ou fotorrealistas consistentes |
| Personagem Seedance 2 | ByteDança | $0.18/generation | Imagens de referência de uma a três |
| Personagem Omni de Gêmeos | Grátis | Referências gratuitas de imagens multimodais | |
| Referência Vidu Q2 | Vidu | $0.065/generation | Até sete referências ao vídeo |
| Referência do Wan 3.0 ao vídeo | Alibaba | $0.50/generation | Grandes pacotes de referência para vídeo |
| Referência do Veo 3.1 ao vídeo | $0.60/generation | Imagens de referência cinematográfica premium | |
| Referência Omni do Seedance 2.5 | ByteDança | US$ 1,70/geração (720p) | Pacotes multimodais complexos e continuidade |
Os limites de referência, as modalidades suportadas e os preços variam de acordo com o modelo. Verifique o esquema do Playground de cada modelo antes de enviar solicitações de produção.
curl -X POST https://api.muapi.ai/api/v1/seedance-2.5-omni-reference \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"images_list": [
"https://example.com/character-front.jpg",
"https://example.com/character-side.jpg"
],
"prompt": "the character walking through a neon-lit city street at night",
"omni_reference_task_type": "reference",
"duration": 5,
"aspect_ratio": "16:9"
}'import requests
response = requests.post(
"https://api.muapi.ai/api/v1/seedance-2.5-omni-reference",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"images_list": [
"https://example.com/character-front.jpg",
"https://example.com/character-side.jpg",
],
"prompt": "the character walking through a neon-lit city street at night",
"omni_reference_task_type": "reference",
"duration": 5,
"aspect_ratio": "16:9",
},
)
request_id = response.json()["request_id"]
result = requests.get(
f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())Use o menor pacote de referência que capture o assunto. Os modelos de referência única precisam de uma imagem, enquanto os modelos de vídeo podem aceitar três, sete, dez ou trinta, dependendo do esquema.
Sim. Vidu Q2, Wan 3.0, Veo 3.1, Kling O1, MiniMax H3 e Seedance Omni incluem opções de referência para vídeo.
Alguns endpoints multimodais aceitam vídeo ou áudio além de imagens. Verifique o esquema de entrada do modelo selecionado antes de enviar esses campos.
As causas comuns são uma contagem de referências não suportada, um nome de campo incorreto, uma URL inacessível ou um tipo de tarefa específico do modelo ausente. Valide o esquema do Playground e tente novamente com um pacote menor.
Os preços representativos variam de referências de imagem gratuitas e de US$ 0,01 a US$ 1,70 para uma solicitação de referência de vídeo 720p de alta capacidade. O modelo e as opções selecionadas determinam o custo final.
Sim. Muapi usa uma chave de API e o mesmo padrão de envio e pesquisa em todo o catálogo de referência de imagens e vídeos.