Source: https://ailoot.ai/models/pt-pt/dop-turbo/ Canonical: https://ailoot.ai/models/pt-pt/dop-turbo/ Language: pt-pt # Higgsfield: DOP Turbo [Markdown](https://ailoot.ai/models/pt-pt/dop-turbo/index.md) · [JSON](https://ailoot.ai/models/pt-pt/dop-turbo/facts.json) ## [Higgsfield: DOP Turbo](https://ailoot.ai/models/pt-pt/dop-turbo/) DOP Turbo é o seletor dop-turbo do fluxo de conversão de imagem em vídeo da Higgsfield. Forneça a imagem de referência e os modelos de movimento selecionados, depois guarde strength, prompt, seed e o vídeo concluído num único registo de geração. - [**Ailoot Ultra · Vídeo** `POST /v1/videos` `dop-turbo`](https://ailoot.ai/models/pt-pt/dop-turbo/#method-0) 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 Turbo anima as imagens fornecidas através do fluxo de conversão de imagem em vídeo documentado pela Higgsfield. O seletor exato é dop-turbo. Use dop-turbo 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-turbo` [`dop-turbo`](https://ailoot.ai/models/pt-pt/#m=dop-turbo&route=Ultra&caller=dop-turbo&fmt=videos) Higgsfield /`dop-turbo` ### Introdução DOP Turbo é o seletor dop-turbo do fluxo de conversão de imagem em vídeo da Higgsfield. Forneça a imagem de referência e os modelos de movimento selecionados, depois guarde strength, prompt, seed e o vídeo concluído num único registo de geração. 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 | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObrigatório | Valores e limites dop-turbo Condições: Seletor de modelos da Ailoot. | Predefinição— | | Campo`params` | Tipo`object` | RequisitoObrigatório | Valores e limites Condições: Parâmetros de imagem para vídeo; conserve esta estrutura envolvente. | Predefinição— | | Campo`params.model` | Tipo`string` | RequisitoObrigatório | Valores e limites dop-turbo Condições: Utilize o mesmo seletor do modelo de nível superior. | Predefinição— | | Campo`params.prompt` | Tipo`string` | 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— | | Campo`params.seconds` | Tipo`integer` | RequisitoOpcional | Valores e limites Condições: Duração solicitada; não é indicado qualquer intervalo ou valor predefinido documentado. | Predefinição— | | Campo`params.motions` | Tipo`array` | RequisitoOpcional | Valores e limites Condições: Escolha um ou dois modelos de movimento documentados. | Predefinição— | | Campo`params.motions[].id` | Tipo`string` | RequisitoObrigatório | Valores e limites Condições: Identificador de movimento no exemplo documentado de pedido funcional. | Predefinição— | | Campo`params.motions[].strength` | Tipo`number` | 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 | | Campo`params.input_images` | Tipo`array` | RequisitoOpcional | Valores e limites Condições: Imagens de referência, utilizando a matriz de objetos image\_url apresentada no exemplo funcional. | Predefinição— | | Campo`params.input_images[].type` | Tipo`string` | RequisitoObrigatório | Valores e limites image\_url Condições: Representação da referência. | Predefinição— | | Campo`params.input_images[].image_url` | Tipo`string` | RequisitoObrigatório | Valores e limites Condições: O URL real e acessível da sua imagem de referência. | Predefinição— | | Campo`params.enhance_prompt` | Tipo`boolean` | RequisitoOpcional | Valores e limites Condições: Melhoria da instrução. | Predefiniçãotrue | | Campo`params.check_nsfw` | Tipo`boolean` | RequisitoOpcional | Valores e limites Condições: Filtragem de conteúdo. | Predefiniçãotrue | | Campo`params.seed` | Tipo`integer` | RequisitoOpcional | Valores e limites Mínimo: 1 Máximo: 1 000 000 Condições: Semente para resultados consistentes. | Predefinição— | | Campo`webhook` | Tipo`object` | 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— | | Campo`webhook.url` | Tipo`string` | RequisitoOpcional | Valores e limites Condições: O URL do seu recetor. | Predefinição— | | Campo`webhook.secret` | Tipo`string` | RequisitoOpcional | Valores e limites Condições: O segredo do seu recetor. | Predefinição— | | Campo`callback` | Tipo`string` | 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âmetro`content_type` | Contratoapplication/json | | Parâmetro`required` | Contratomodel, params | | Parâmetro`optional` | Contratoparams.seconds, params.motions, params.input\_images, params.enhance\_prompt, params.check\_nsfw, params.seed, webhook, webhook.url, webhook.secret, callback | | Parâmetro`material_types` | Contratoimage, text | | Parâmetro`additional_properties` | Contratotrue | | Parâmetro`validation_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 →](https://ailoot.ai/docs/pt-pt/billing/reserve/) ### Exemplos de pedidos #### Ailoot Ultra · Vídeo JSON · crie um vídeocurl · consulte a tarefa original ```json { "model": "dop-turbo", "params": { "model": "dop-turbo", "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 } } ``` ```bash 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 | Campo | Tipo | Significado | | --- | --- | --- | | Campo`id` | Tipostring | SignificadoIdentificador público de tarefa ou operação da Ailoot. | | Campo`provider_task_id` | Tipostring | SignificadoIdentificador da tarefa original, distinto do id público. | | Campo`polling_url` | Tipostring | SignificadoCaminho de consulta devolvido pela Ailoot. | | Campo`jobs[].id` | Tipostring | SignificadoIdentificador real da tarefa devolvido. | | Campo`jobs[].status` | Tipostring | SignificadoEstado de cada tarefa devolvida. | | Campo`jobs[].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-turbo`](https://ailoot.ai/models/pt-pt/#m=dop-turbo&route=Ultra&caller=dop-turbo&fmt=videos) #### Aliases dos caminhos dos métodos `/v1/videos/generations` #### IDs de chamada relacionados [`dop-turbo`](https://ailoot.ai/models/pt-pt/#m=dop-turbo&route=Ultra&caller=dop-turbo&fmt=videos) FAQ · Higgsfield: DOP Turbo Que entradas e resultados estão disponíveis? `POST /v1/videos` · `dop-turbo`: `image`, `text` → `video` Que campos utiliza o pedido? `POST /v1/videos` · `dop-turbo`: `model`, `params`, `webhook`, `callback` Que limites se aplicam? `POST /v1/videos` · `dop-turbo`: `params.motions[].strength.minimum`: `0`; `params.motions[].strength.maximum`: `1`; `params.seed.minimum`: `1`; `params.seed.maximum`: `1000000` 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](https://ailoot.ai/docs/pt-pt/billing/subscriptions/) · [Ver preços dos modelos](https://ailoot.ai/models/pt-pt/) ## 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](mailto:support@ailoot.ai) · [Oferta e contrato de licença](https://ailoot.ai/legal/offer?lang=pt-pt) ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.