modelos

Higgsfield: DOP Lite

Markdown · JSON

Higgsfield: DOP Lite

DOP Lite anima uma imagem fornecida com modelos de movimento documentados, intensidade ajustável e instruções escritas. Este seletor exato dop-lite usa o pedido de conversão de imagem em vídeo e devolve o vídeo através de uma tarefa assíncrona.

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.

DOP Lite anima as imagens fornecidas através do fluxo de conversão de imagem em vídeo documentado pela Higgsfield. O seletor exato é dop-lite. Use dop-lite como seleção do modelo no nível superior e como valor de model no objeto params documentado. A imagem fornece o material visual, enquanto os modelos de movimento e as instruções escritas controlam o movimento e o efeito pedidos.

Prepare uma imagem de referência em que o sujeito pretendido, os pormenores importantes e o espaço envolvente sejam legíveis. O guia recomenda uma imagem de alta resolução para pormenores mais claros. Para uma cena de produto, escolha uma vista que mostre a forma do objeto e as superfícies que devem continuar reconhecíveis durante o movimento. Para uma pessoa ou ambiente, identifique a característica visual que o movimento deve realçar. Forneça o URL real da imagem de referência através da entrada de imagem usada no exemplo do método.

A operação documenta um ou dois modelos de movimento. Quando são fornecidos dois, o guia descreve os seus efeitos como combinados. As descrições das predefinições incluem movimento da câmara, rotação do sujeito e transformações visuais; por exemplo, Dolly In descreve uma aproximação da câmara, enquanto 3D Rotation descreve um sujeito ou produto a rodar no mesmo lugar. Selecione os identificadores documentados dos modelos que correspondem à sequência pretendida e guarde cada identificador com o respetivo valor de intensidade.

A intensidade do movimento é um número de 0 a 1, com 0,8 como predefinição documentada. O guia descreve 0,3 como um efeito subtil e 1 como movimento forte. Escolha a intensidade de acordo com o pormenor que precisa de continuar legível e verifique toda a ação gerada. Uma descrição do movimento e a sua intensidade têm finalidades diferentes: o modelo de movimento seleciona o efeito, enquanto a intensidade controla a sua força.

O campo prompt tem de estar presente de acordo com a sua descrição, mas é permitida uma cadeia vazia. Para efeitos guiados por modelos de movimento, o guia recomenda deixar prompt vazio; quando é fornecido texto, recomenda incluir a descrição do modelo de movimento, porque o prompt pode alterar fortemente o resultado. O controlo enhance_prompt ativa a otimização do prompt e está documentado com true como predefinição. Guarde o texto e este controlo com a imagem de referência e os modelos selecionados ao comparar versões.

O controlo seed aceita um inteiro de 1 a 1 000 000. Registe o valor seed escolhido com as definições de geração. O pedido também expõe um campo inteiro seconds; guarde o valor usado com o vídeo resultante e examine a temporização e o enquadramento reais do vídeo. O booleano check_nsfw ativa o filtro de conteúdo documentado e tem true como predefinição. Estes controlos pertencem ao pedido de conversão de imagem em vídeo e devem continuar associados ao modelo exato selecionado.

A geração é assíncrona. Guarde o identificador da tarefa devolvido enquanto acompanha as consultas configuradas de estado e resultado. O mapeamento de conclusão lê as entradas dos trabalhos concluídos e os URL brutos dos resultados. Guarde cada resultado de vídeo concluído e preserve o identificador do trabalho com o URL devolvido, mantendo todas as entradas concluídas juntas como resultado da operação.

Verifique o vídeo completo face à imagem fornecida, ao efeito escolhido e às instruções escritas: aspeto do sujeito, movimento, enquadramento e vista final. Para uma revisão, identifique o pormenor visual concreto a mudar e preserve as partes bem-sucedidas do pedido. Guarde juntos a referência à imagem original, o seletor exato, prompt, identificadores dos movimentos, intensidades, seed, definições pedidas e recursos concluídos, para que a comparação seguinte use a geração real.

Ailoot Ultra · Vídeo POST /v1/videos dop-lite

dop-lite

Higgsfield /dop-lite

Introdução

DOP Lite anima uma imagem fornecida com modelos de movimento documentados, intensidade ajustável e instruções escritas. Este seletor exato dop-lite usa o pedido de conversão de imagem em vídeo e devolve o vídeo através de uma tarefa assíncrona.

Entradas aceites
Imagens · Texto
Resultados
Vídeo

Disponível no Ailoot · entradas e métodos

Ailoot Ultra · Vídeo POST /v1/videos
Entrada
image, text
Saída
video
CampoTipoRequisitoValores e limitesPredefinição
CampomodelTipostringRequisitoObrigatórioValores e limites
dop-lite
Condições: Seletor de modelos da Ailoot.
Predefinição—
CampoparamsTipoobjectRequisitoObrigatórioValores e limites
Condições: Parâmetros de imagem para vídeo; conserve esta estrutura envolvente.
Predefinição—
Campoparams.modelTipostringRequisitoObrigatórioValores e limites
dop-lite
Condições: Utilize o mesmo seletor do modelo de nível superior.
Predefinição—
Campoparams.promptTipostringRequisitoObrigatórioValores e limites
Condições: Mantenha este campo presente; está documentada uma cadeia vazia. As orientações escritas influenciam fortemente o efeito de movimento selecionado.
Predefinição—
Campoparams.secondsTipointegerRequisitoOpcionalValores e limites
Condições: Duração solicitada; não é indicado qualquer intervalo ou valor predefinido documentado.
Predefinição—
Campoparams.motionsTipoarrayRequisitoOpcionalValores e limites
Condições: Escolha um ou dois modelos de movimento documentados.
Predefinição—
Campoparams.motions[].idTipostringRequisitoObrigatórioValores e limites
Condições: Identificador de movimento no exemplo documentado de pedido funcional.
Predefinição—
Campoparams.motions[].strengthTiponumberRequisitoObrigatórioValores e limites
Mínimo: 0
Máximo: 1
Condições: Intensidade do movimento: 0.3 é descrito como subtil e 1 como forte.
Predefinição0,8
Campoparams.input_imagesTipoarrayRequisitoOpcionalValores e limites
Condições: Imagens de referência, utilizando a matriz de objetos image_url apresentada no exemplo funcional.
Predefinição—
Campoparams.input_images[].typeTipostringRequisitoObrigatórioValores e limites
image_url
Condições: Representação da referência.
Predefinição—
Campoparams.input_images[].image_urlTipostringRequisitoObrigatórioValores e limites
Condições: O URL real e acessível da sua imagem de referência.
Predefinição—
Campoparams.enhance_promptTipobooleanRequisitoOpcionalValores e limites
Condições: Melhoria da instrução.
Predefiniçãotrue
Campoparams.check_nsfwTipobooleanRequisitoOpcionalValores e limites
Condições: Filtragem de conteúdo.
Predefiniçãotrue
Campoparams.seedTipointegerRequisitoOpcionalValores e limites
Mínimo: 1
Máximo: 1 000 000
Condições: Semente para resultados consistentes.
Predefinição—
CampowebhookTipoobjectRequisitoOpcionalValores e limites
Condições: Definições opcionais de webhook documentadas; a obtenção de resultados pertencentes ao utilizador utiliza os caminhos de tarefas da Ailoot.
Predefinição—
Campowebhook.urlTipostringRequisitoOpcionalValores e limites
Condições: O URL do seu recetor.
Predefinição—
Campowebhook.secretTipostringRequisitoOpcionalValores e limites
Condições: O segredo do seu recetor.
Predefinição—
CampocallbackTipostringRequisitoOpcionalValores e limites
Condições: Recetor opcional de callback; o recetor documentado responde com HTTP 200.
Predefinição—
Combinações de materiais de entrada

Parâmetros e ciclo de vida do método
ParâmetroContrato
Parâmetrocontent_typeContratoapplication/json
ParâmetrorequiredContratomodel, params
ParâmetrooptionalContratoparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback
Parâmetromaterial_typesContratoimage, text
Parâmetroadditional_propertiesContratotrue
Parâmetrovalidation_scopeContratoO modelo encaminha o pedido; a estrutura envolvente dos parâmetros segue o pedido demonstrado de imagem para vídeo.

Aliases do método: /v1/videos/generations

Ciclo de vida: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Utilize o mesmo seletor de modelo no nível superior e dentro de params.

Crie uma única vez e utilize depois o id público e o polling_url devolvidos para a operação original.

Obtenha todos os vídeos concluídos que pertencem ao utilizador; verifique a duração e as dimensões reais no resultado.

Substitua YOUR_ACCESSIBLE_IMAGE_URL no exemplo pelo URL real da sua imagem de referência.

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çãoTabela de tarifasQuantidade previstaCusto
ConfiguraçãoTarifas base por tokenTabela de tarifasTarifa baseQuantidade prevista—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çãoCusto estimado de geraçãoTabela de tarifas—Quantidade previstaestimativa para uma geraçãoCusto
Saída · Custo estimado de geração · Estimativa apenas para comparação $1.24 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 →

Exemplos de pedidos

Ailoot Ultra · Vídeo

JSON · crie um vídeocurl · consulte a tarefa original
{
  "model": "dop-lite",
  "params": {
    "model": "dop-lite",
    "prompt": "a cat",
    "seed": 500000,
    "motions": [
      {
        "id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",
        "strength": 0.5
      }
    ],
    "input_images": [
      {
        "type": "image_url",
        "image_url": "YOUR_ACCESSIBLE_IMAGE_URL"
      }
    ],
    "enhance_prompt": true,
    "check_nsfw": true
  }
}
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json

Receber e guardar os resultados

Ailoot Ultra · Vídeo

Conserve as tarefas devolvidas e os respetivos estados. Consulte todos os resultados de vídeo concluídos que pertencem ao utilizador.

  • GET /v1/videos/{request_id}
  • GET /v1/videos/generations/{request_id}
  • GET /v1/videos/{request_id}/content
  • GET /v1/videos/generations/{request_id}/content
Guardar todos os resultados concluídos

Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.

Obtenha todas as saídas reais concluídas; não presuma uma quantidade fixa.

Se for necessário verificar a resposta original

Conserve a resposta original e a identidade da tarefa devolvida; um estado não reconhecido ou um envio de resultado ambíguo não autoriza uma nova criação.

Campos da resposta
CampoTipoSignificado
CampoidTipostringSignificadoIdentificador público de tarefa ou operação da Ailoot.
Campoprovider_task_idTipostringSignificadoIdentificador da tarefa original, distinto do id público.
Campopolling_urlTipostringSignificadoCaminho de consulta devolvido pela Ailoot.
Campojobs[].idTipostringSignificadoIdentificador real da tarefa devolvido.
Campojobs[].statusTipostringSignificadoEstado de cada tarefa devolvida.
Campojobs[].results.raw.urlTipostringSignificadoCada vídeo concluído é disponibilizado através de um URL assinado pertencente à Ailoot.
Erros e passos seguintes
RespostaCondiçãoPasso seguinte
Resposta400 · invalid_request_errorCondiçãoJSON/model inválido ou um índice de conteúdo inválido.Passo seguinte
Resposta401 · authentication_errorCondiçãoChave API da Ailoot inválida.Passo seguinte
Resposta403 · permission_errorCondiçãoO grupo da chave API não tem acesso a esta rota multimédia.Passo seguinte
Resposta404 · not_found_errorCondiçãoA tarefa original ou o resultado pedido não existe ou não pertence ao mesmo utilizador/chave API/grupo.Passo seguinte
Resposta502 · result_pending_checkCondiçãoO envio original ou o respetivo estado está incompleto ou não pode ser reconciliado; conserve o ID original e não volte a enviar.Passo seguinte
Resposta503 · result_pending_checkCondiçãoA associação original, a rota ou o conteúdo multimédia pertencente ao utilizador ainda está em verificação; continue a consultar essa operação original.Passo seguinte
Resposta503 · server_errorCondiçãoO serviço multimédia ou o armazenamento da tarefa original não está disponível.Passo seguinte

Aliases

Aliases do modelo

Ailoot Ultra dop-lite

Aliases dos caminhos dos métodos

/v1/videos/generations

IDs de chamada relacionados

dop-lite

FAQ · Higgsfield: DOP Lite
Que entradas e resultados estão disponíveis?

POST /v1/videos · dop-lite: image, text → video

Que campos utiliza o pedido?

POST /v1/videos · dop-lite: model, params, webhook, callback

Que limites se aplicam?

POST /v1/videos · dop-lite: params.motions[].strength.minimum: 0; params.motions[].strength.maximum: 1; params.seed.minimum: 1; params.seed.maximum: 1000000

Mais detalhes

Ligue o Ailoot ao Claude Code, OpenCode, Hermes ou à sua aplicação.

A empresa e a sua carteira de projetos

A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.

Compre tokens com desconto.

Desconto por subscrição para trabalho regular. Códigos promocionais — até 50% na compra de tokens.

Subscrição
Escolha um plano com desconto para os pedidos regulares.
Código promocional até 50%
Introduza o código na compra. O preço é recalculado conforme a campanha em vigor.
Custos no histórico
O modelo, os tokens e o montante são guardados para cada pedido.

Escolher subscrição · Ver preços dos modelos

Ligue a API ao produto que vende.

SaaS, aplicações e bots — ao abrigo da oferta e do contrato de licença Ailoot. Para revenda, peça uma licença de revendedor.

Aplicação comercial
Integre geração de texto, imagens, vídeo e som nas funcionalidades pagas do seu serviço.
Licença de revendedor
Envie uma descrição do projeto e do modelo de acesso. Peça condições escritas de utilização e revenda.
Documentos no site
A oferta, o contrato de licença e a política de tratamento de dados estão disponíveis antes da ligação.

Pedir licença de revendedor · Oferta e contrato de licença