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-liteIntroduçã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
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites dop-lite Condições: Seletor de modelos da Ailoot. | Predefinição— |
Campoparams | Tipoobject | RequisitoObrigatório | Valores e limites Condições: Parâmetros de imagem para vídeo; conserve esta estrutura envolvente. | Predefinição— |
Campoparams.model | Tipostring | RequisitoObrigatório | Valores e limites dop-lite Condições: Utilize o mesmo seletor do modelo de nível superior. | Predefinição— |
Campoparams.prompt | Tipostring | RequisitoObrigatório | Valores 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.seconds | Tipointeger | RequisitoOpcional | Valores e limites Condições: Duração solicitada; não é indicado qualquer intervalo ou valor predefinido documentado. | Predefinição— |
Campoparams.motions | Tipoarray | RequisitoOpcional | Valores e limites Condições: Escolha um ou dois modelos de movimento documentados. | Predefinição— |
Campoparams.motions[].id | Tipostring | RequisitoObrigatório | Valores e limites Condições: Identificador de movimento no exemplo documentado de pedido funcional. | Predefinição— |
Campoparams.motions[].strength | Tiponumber | RequisitoObrigatório | Valores 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_images | Tipoarray | RequisitoOpcional | Valores e limites Condições: Imagens de referência, utilizando a matriz de objetos image_url apresentada no exemplo funcional. | Predefinição— |
Campoparams.input_images[].type | Tipostring | RequisitoObrigatório | Valores e limites image_url Condições: Representação da referência. | Predefinição— |
Campoparams.input_images[].image_url | Tipostring | RequisitoObrigatório | Valores e limites Condições: O URL real e acessível da sua imagem de referência. | Predefinição— |
Campoparams.enhance_prompt | Tipoboolean | RequisitoOpcional | Valores e limites Condições: Melhoria da instrução. | Predefiniçãotrue |
Campoparams.check_nsfw | Tipoboolean | RequisitoOpcional | Valores e limites Condições: Filtragem de conteúdo. | Predefiniçãotrue |
Campoparams.seed | Tipointeger | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 1 000 000 Condições: Semente para resultados consistentes. | Predefinição— |
Campowebhook | Tipoobject | RequisitoOpcional | Valores 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.url | Tipostring | RequisitoOpcional | Valores e limites Condições: O URL do seu recetor. | Predefinição— |
Campowebhook.secret | Tipostring | RequisitoOpcional | Valores e limites Condições: O segredo do seu recetor. | Predefinição— |
Campocallback | Tipostring | RequisitoOpcional | Valores 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âmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, params |
Parâmetrooptional | Contratoparams.seconds, params.motions, params.input_images, params.enhance_prompt, params.check_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback |
Parâmetromaterial_types | Contratoimage, text |
Parâmetroadditional_properties | Contratotrue |
Parâmetrovalidation_scope | ContratoO 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ção | Tabela de tarifas | Quantidade prevista | Custo |
|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade 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ção | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Custo 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
{
"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}/contentGET /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
| Campo | Tipo | Significado |
|---|---|---|
Campoid | Tipostring | SignificadoIdentificador público de tarefa ou operação da Ailoot. |
Campoprovider_task_id | Tipostring | SignificadoIdentificador da tarefa original, distinto do id público. |
Campopolling_url | Tipostring | SignificadoCaminho de consulta devolvido pela Ailoot. |
Campojobs[].id | Tipostring | SignificadoIdentificador real da tarefa devolvido. |
Campojobs[].status | Tipostring | SignificadoEstado de cada tarefa devolvida. |
Campojobs[].results.raw.url | Tipostring | SignificadoCada vídeo concluído é disponibilizado através de um URL assinado pertencente à Ailoot. |
Erros e passos seguintes
| Resposta | Condição | Passo seguinte |
|---|---|---|
Resposta400 · invalid_request_error | CondiçãoJSON/model inválido ou um índice de conteúdo inválido. | Passo seguinte |
Resposta401 · authentication_error | CondiçãoChave API da Ailoot inválida. | Passo seguinte |
Resposta403 · permission_error | CondiçãoO grupo da chave API não tem acesso a esta rota multimédia. | Passo seguinte |
Resposta404 · not_found_error | Condiçã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_check | Condiçã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_check | Condiçã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_error | Condiçã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
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