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.
", "aboutText": "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.\n\nPrepare 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.\n\nA 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.\n\nA 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.\n\nO 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.\n\nO 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.\n\nA 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.\n\nVerifique 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "91a774c6bcb3d075b021ef7951b462a882d25fa2e37e2276a577961dfe3de467", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pt-pt", "methods": [ { "html": "dop-liteDOP 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.
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.
POST /v1/videosimage, textvideo| 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— |
| 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.
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.
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 →
{\n "model": "dop-lite",\n "params": {\n "model": "dop-lite",\n "prompt": "a cat",\n "seed": 500000,\n "motions": [\n {\n "id": "2bae49e6-ffe7-42a8-a73f-d44632c4acaa",\n "strength": 0.5\n }\n ],\n "input_images": [\n {\n "type": "image_url",\n "image_url": "YOUR_ACCESSIBLE_IMAGE_URL"\n }\n ],\n "enhance_prompt": true,\n "check_nsfw": true\n }\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_POLL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote,urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\ni=r.get("id")\nif not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")\nu=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")\nPath("poll-url.txt").write_text(u)\nPY_POLL\ncurl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\nConserve 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}/contentGuarde 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.
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.
| 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. |
| 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 |
Ailoot Ultra dop-lite
/v1/videos/generations