Kling VIDEO 3.0 Pro é o perfil profissional do modelo VIDEO 3.0 da Kuaishou. O seu modo Pro documentado produz vídeo a 1080p a partir de instruções em texto ou de uma cena orientada por imagem, com clipes de três a quinze segundos. A edição 3.0 combina áudio nativo, controlos de consistência dos sujeitos e direção de vários planos, dando a uma produção curta uma forma clara de especificar o aspeto, a ação, a cobertura da câmara e o som.
Comece pela ação principal da cena. Num plano orientado por texto, descreva o sujeito, o ambiente, a luz e o ponto de vista que torna a ação compreensível. Num plano orientado por imagem, deixe que a imagem inicial estabeleça o aspeto e a composição e utilize depois o texto para indicar o que muda ao longo do tempo. Num conceito original de produto, uma imagem preparada pode mostrar o objeto numa superfície de estúdio enquanto a instrução descreve uma revelação lenta do seu material e da sua forma.
A direção de vários planos oferece cobertura automática ou uma sequência personalizada. A geração automática de vários planos planeia mudanças de enquadramento e de ângulo da câmara a partir das instruções; uma cena que caiba numa vista contínua pode ainda manter-se num único plano. Um storyboard personalizado permite definir o conteúdo e a duração de cada plano. O perfil de planos personalizados do produtor permite entre um e seis planos, com um máximo de 512 caracteres por plano e um mínimo de um segundo para cada um; as suas durações têm de perfazer a duração total do clipe.
Numa narrativa curta, descreva uma vista de apresentação, a ação principal e um pormenor final como planos separados. Indique o tratamento da câmara e aquilo em que o público deve reparar em cada um. Mantenha consistente nas instruções o aspeto de um sujeito recorrente, alterando deliberadamente a ação e a cobertura. O campo de instrução única na referência do fabricante aceita até 2 500 caracteres; uma sequência personalizada utiliza as suas descrições separadas por plano.
As referências de sujeitos podem apoiar uma cena orientada por imagem quando a personagem, o produto ou o cenário devem manter-se reconhecíveis. Escolha vistas claras que comuniquem as características que precisa de conservar e nomeie cada sujeito de referência de forma consistente. O perfil documentado orientado por imagem permite até três elementos preparados. Mantenha os papéis das referências bem focados, em vez de combinar vários recursos que dão instruções contraditórias sobre o aspeto do sujeito.
Os fotogramas inicial e final fornecem limites visuais para uma transição condicionada por imagem. Prepare fotogramas coerentes quanto ao sujeito e à cena pretendida e descreva depois como o movimento os liga. A entrada de fotogramas suportada pelo fabricante utiliza imagens JPG, JPEG ou PNG, com ficheiros até 10 MB, dimensões de pelo menos 300 píxeis e uma proporção da imagem inicial entre 1:2.5 e 2.5:1. Uma tarefa controlada por fotogramas e um storyboard personalizado têm formas próprias de tratar as entradas, pelo que deve organizar o material para o fluxo de trabalho selecionado antes de escrever as instruções completas.
O áudio nativo pode combinar falas, atmosfera e a interpretação visual. O áudio está desativado por predefinição na referência do fabricante e é ativado para uma cena audiovisual. O perfil linguístico da versão 3.0 inclui chinês, inglês, japonês, coreano e espanhol, juntamente com alternância entre idiomas e os tratamentos de dialeto ou sotaque suportados. O guia do fabricante indica que o diálogo introduzido noutro idioma é traduzido para inglês. Atribua cada fala ao sujeito pretendido e distinga o diálogo do som de fundo, para que as instruções de áudio expliquem quem fala e o que envolve a ação.
Uma instrução original para duas personagens pode identificar o Interlocutor A e o Interlocutor B, dar uma fala curta a cada um e descrever a resposta visível entre ambos. Mantenha o diálogo proporcional à duração do clipe e identifique quem fala quando o ponto de vista muda. A direção de voz e uma referência de personagem servem propósitos diferentes; as instruções devem indicar a interpretação pretendida, em vez de presumir que uma imagem de referência contém as palavras a dizer.
VIDEO 3.0 melhora também o tratamento do texto visível numa cena orientada por imagem. Se um sinal, um rótulo ou uma legenda forem importantes, identifique-os nas instruções e preserve o seu aspeto de referência. Reveja a ortografia, a legibilidade e o movimento desse texto no clipe concluído, sobretudo quando transmite uma mensagem de produto ou de campanha. A funcionalidade de texto do modelo orienta a geração sem substituir uma verificação visual final.
O perfil Pro é a 1080p; o perfil Standard é a 720p. O modo 4K do produtor, selecionado separadamente, é outro perfil de saída, pelo que Pro não deve ser tratado como sinónimo de todas as definições de resolução superior. Para geração orientada por texto, as opções documentadas de enquadramento incluem 16:9, 9:16 e 1:1. Escolha o enquadramento para o local de utilização pretendido e mantenha a composição legível dentro dele.
A geração decorre como uma tarefa cujo resultado bem-sucedido disponibiliza o ficheiro de vídeo concluído e a duração real. A documentação de resultados do fabricante indica que os vídeos gerados são eliminados após 30 dias, pelo que deve guardar o clipe concluído prontamente. Preserve o vídeo com as suas instruções e os recursos de referência e reveja depois a continuidade dos sujeitos, a ordem dos planos pedida, o movimento da câmara, o diálogo e o texto. Utilize o clipe selecionado como conceito cinematográfico, cena de produto ou narrativa curta e faça uma revisão focada na parte que não correspondeu ao resultado pretendido.
", "aboutText": "Kling VIDEO 3.0 Pro é o perfil profissional do modelo VIDEO 3.0 da Kuaishou. O seu modo Pro documentado produz vídeo a 1080p a partir de instruções em texto ou de uma cena orientada por imagem, com clipes de três a quinze segundos. A edição 3.0 combina áudio nativo, controlos de consistência dos sujeitos e direção de vários planos, dando a uma produção curta uma forma clara de especificar o aspeto, a ação, a cobertura da câmara e o som.\n\nComece pela ação principal da cena. Num plano orientado por texto, descreva o sujeito, o ambiente, a luz e o ponto de vista que torna a ação compreensível. Num plano orientado por imagem, deixe que a imagem inicial estabeleça o aspeto e a composição e utilize depois o texto para indicar o que muda ao longo do tempo. Num conceito original de produto, uma imagem preparada pode mostrar o objeto numa superfície de estúdio enquanto a instrução descreve uma revelação lenta do seu material e da sua forma.\n\nA direção de vários planos oferece cobertura automática ou uma sequência personalizada. A geração automática de vários planos planeia mudanças de enquadramento e de ângulo da câmara a partir das instruções; uma cena que caiba numa vista contínua pode ainda manter-se num único plano. Um storyboard personalizado permite definir o conteúdo e a duração de cada plano. O perfil de planos personalizados do produtor permite entre um e seis planos, com um máximo de 512 caracteres por plano e um mínimo de um segundo para cada um; as suas durações têm de perfazer a duração total do clipe.\n\nNuma narrativa curta, descreva uma vista de apresentação, a ação principal e um pormenor final como planos separados. Indique o tratamento da câmara e aquilo em que o público deve reparar em cada um. Mantenha consistente nas instruções o aspeto de um sujeito recorrente, alterando deliberadamente a ação e a cobertura. O campo de instrução única na referência do fabricante aceita até 2 500 caracteres; uma sequência personalizada utiliza as suas descrições separadas por plano.\n\nAs referências de sujeitos podem apoiar uma cena orientada por imagem quando a personagem, o produto ou o cenário devem manter-se reconhecíveis. Escolha vistas claras que comuniquem as características que precisa de conservar e nomeie cada sujeito de referência de forma consistente. O perfil documentado orientado por imagem permite até três elementos preparados. Mantenha os papéis das referências bem focados, em vez de combinar vários recursos que dão instruções contraditórias sobre o aspeto do sujeito.\n\nOs fotogramas inicial e final fornecem limites visuais para uma transição condicionada por imagem. Prepare fotogramas coerentes quanto ao sujeito e à cena pretendida e descreva depois como o movimento os liga. A entrada de fotogramas suportada pelo fabricante utiliza imagens JPG, JPEG ou PNG, com ficheiros até 10 MB, dimensões de pelo menos 300 píxeis e uma proporção da imagem inicial entre 1:2.5 e 2.5:1. Uma tarefa controlada por fotogramas e um storyboard personalizado têm formas próprias de tratar as entradas, pelo que deve organizar o material para o fluxo de trabalho selecionado antes de escrever as instruções completas.\n\nO áudio nativo pode combinar falas, atmosfera e a interpretação visual. O áudio está desativado por predefinição na referência do fabricante e é ativado para uma cena audiovisual. O perfil linguístico da versão 3.0 inclui chinês, inglês, japonês, coreano e espanhol, juntamente com alternância entre idiomas e os tratamentos de dialeto ou sotaque suportados. O guia do fabricante indica que o diálogo introduzido noutro idioma é traduzido para inglês. Atribua cada fala ao sujeito pretendido e distinga o diálogo do som de fundo, para que as instruções de áudio expliquem quem fala e o que envolve a ação.\n\nUma instrução original para duas personagens pode identificar o Interlocutor A e o Interlocutor B, dar uma fala curta a cada um e descrever a resposta visível entre ambos. Mantenha o diálogo proporcional à duração do clipe e identifique quem fala quando o ponto de vista muda. A direção de voz e uma referência de personagem servem propósitos diferentes; as instruções devem indicar a interpretação pretendida, em vez de presumir que uma imagem de referência contém as palavras a dizer.\n\nVIDEO 3.0 melhora também o tratamento do texto visível numa cena orientada por imagem. Se um sinal, um rótulo ou uma legenda forem importantes, identifique-os nas instruções e preserve o seu aspeto de referência. Reveja a ortografia, a legibilidade e o movimento desse texto no clipe concluído, sobretudo quando transmite uma mensagem de produto ou de campanha. A funcionalidade de texto do modelo orienta a geração sem substituir uma verificação visual final.\n\nO perfil Pro é a 1080p; o perfil Standard é a 720p. O modo 4K do produtor, selecionado separadamente, é outro perfil de saída, pelo que Pro não deve ser tratado como sinónimo de todas as definições de resolução superior. Para geração orientada por texto, as opções documentadas de enquadramento incluem 16:9, 9:16 e 1:1. Escolha o enquadramento para o local de utilização pretendido e mantenha a composição legível dentro dele.\n\nA geração decorre como uma tarefa cujo resultado bem-sucedido disponibiliza o ficheiro de vídeo concluído e a duração real. A documentação de resultados do fabricante indica que os vídeos gerados são eliminados após 30 dias, pelo que deve guardar o clipe concluído prontamente. Preserve o vídeo com as suas instruções e os recursos de referência e reveja depois a continuidade dos sujeitos, a ordem dos planos pedida, o movimento da câmara, o diálogo e o texto. Utilize o clipe selecionado como conceito cinematográfico, cena de produto ou narrativa curta e faça uma revisão focada na parte que não correspondeu ao resultado pretendido.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "ce4f4138156a7b369622b325a2c9b4f48ff79adc050e6fca4d945abbc63db923", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pt-pt", "methods": [ { "html": "kwaivgi/kling-v3.0-proKling VIDEO 3.0 Pro é o perfil profissional de vídeo a 1080p da Kuaishou para cenas orientadas por texto e imagem. Combina clipes de três a quinze segundos, áudio nativo, fotogramas de início e fim guiados e direção num único plano ou em vários planos para conceitos cinematográficos e produções curtas.
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.
Kling VIDEO 3.0 Pro é o perfil profissional do modelo VIDEO 3.0 da Kuaishou. O seu modo Pro documentado produz vídeo a 1080p a partir de instruções em texto ou de uma cena orientada por imagem, com clipes de três a quinze segundos. A edição 3.0 combina áudio nativo, controlos de consistência dos sujeitos e direção de vários planos, dando a uma produção curta uma forma clara de especificar o aspeto, a ação, a cobertura da câmara e o som.
Comece pela ação principal da cena. Num plano orientado por texto, descreva o sujeito, o ambiente, a luz e o ponto de vista que torna a ação compreensível. Num plano orientado por imagem, deixe que a imagem inicial estabeleça o aspeto e a composição e utilize depois o texto para indicar o que muda ao longo do tempo. Num conceito original de produto, uma imagem preparada pode mostrar o objeto numa superfície de estúdio enquanto a instrução descreve uma revelação lenta do seu material e da sua forma.
A direção de vários planos oferece cobertura automática ou uma sequência personalizada. A geração automática de vários planos planeia mudanças de enquadramento e de ângulo da câmara a partir das instruções; uma cena que caiba numa vista contínua pode ainda manter-se num único plano. Um storyboard personalizado permite definir o conteúdo e a duração de cada plano. O perfil de planos personalizados do produtor permite entre um e seis planos, com um máximo de 512 caracteres por plano e um mínimo de um segundo para cada um; as suas durações têm de perfazer a duração total do clipe.
Numa narrativa curta, descreva uma vista de apresentação, a ação principal e um pormenor final como planos separados. Indique o tratamento da câmara e aquilo em que o público deve reparar em cada um. Mantenha consistente nas instruções o aspeto de um sujeito recorrente, alterando deliberadamente a ação e a cobertura. O campo de instrução única na referência do fabricante aceita até 2 500 caracteres; uma sequência personalizada utiliza as suas descrições separadas por plano.
As referências de sujeitos podem apoiar uma cena orientada por imagem quando a personagem, o produto ou o cenário devem manter-se reconhecíveis. Escolha vistas claras que comuniquem as características que precisa de conservar e nomeie cada sujeito de referência de forma consistente. O perfil documentado orientado por imagem permite até três elementos preparados. Mantenha os papéis das referências bem focados, em vez de combinar vários recursos que dão instruções contraditórias sobre o aspeto do sujeito.
Os fotogramas inicial e final fornecem limites visuais para uma transição condicionada por imagem. Prepare fotogramas coerentes quanto ao sujeito e à cena pretendida e descreva depois como o movimento os liga. A entrada de fotogramas suportada pelo fabricante utiliza imagens JPG, JPEG ou PNG, com ficheiros até 10 MB, dimensões de pelo menos 300 píxeis e uma proporção da imagem inicial entre 1:2.5 e 2.5:1. Uma tarefa controlada por fotogramas e um storyboard personalizado têm formas próprias de tratar as entradas, pelo que deve organizar o material para o fluxo de trabalho selecionado antes de escrever as instruções completas.
O áudio nativo pode combinar falas, atmosfera e a interpretação visual. O áudio está desativado por predefinição na referência do fabricante e é ativado para uma cena audiovisual. O perfil linguístico da versão 3.0 inclui chinês, inglês, japonês, coreano e espanhol, juntamente com alternância entre idiomas e os tratamentos de dialeto ou sotaque suportados. O guia do fabricante indica que o diálogo introduzido noutro idioma é traduzido para inglês. Atribua cada fala ao sujeito pretendido e distinga o diálogo do som de fundo, para que as instruções de áudio expliquem quem fala e o que envolve a ação.
Uma instrução original para duas personagens pode identificar o Interlocutor A e o Interlocutor B, dar uma fala curta a cada um e descrever a resposta visível entre ambos. Mantenha o diálogo proporcional à duração do clipe e identifique quem fala quando o ponto de vista muda. A direção de voz e uma referência de personagem servem propósitos diferentes; as instruções devem indicar a interpretação pretendida, em vez de presumir que uma imagem de referência contém as palavras a dizer.
VIDEO 3.0 melhora também o tratamento do texto visível numa cena orientada por imagem. Se um sinal, um rótulo ou uma legenda forem importantes, identifique-os nas instruções e preserve o seu aspeto de referência. Reveja a ortografia, a legibilidade e o movimento desse texto no clipe concluído, sobretudo quando transmite uma mensagem de produto ou de campanha. A funcionalidade de texto do modelo orienta a geração sem substituir uma verificação visual final.
O perfil Pro é a 1080p; o perfil Standard é a 720p. O modo 4K do produtor, selecionado separadamente, é outro perfil de saída, pelo que Pro não deve ser tratado como sinónimo de todas as definições de resolução superior. Para geração orientada por texto, as opções documentadas de enquadramento incluem 16:9, 9:16 e 1:1. Escolha o enquadramento para o local de utilização pretendido e mantenha a composição legível dentro dele.
A geração decorre como uma tarefa cujo resultado bem-sucedido disponibiliza o ficheiro de vídeo concluído e a duração real. A documentação de resultados do fabricante indica que os vídeos gerados são eliminados após 30 dias, pelo que deve guardar o clipe concluído prontamente. Preserve o vídeo com as suas instruções e os recursos de referência e reveja depois a continuidade dos sujeitos, a ordem dos planos pedida, o movimento da câmara, o diálogo e o texto. Utilize o clipe selecionado como conceito cinematográfico, cena de produto ou narrativa curta e faça uma revisão focada na parte que não correspondeu ao resultado pretendido.
POST /v1/videostext, imagevideo| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites kwaivgi/kling-v3.0-pro | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites | Predefinição— |
Campoduration | Tipointeger | RequisitoObrigatório | Valores e limites 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mínimo: 1 Máximo: 600 | Predefinição— |
Camporesolution | Tipostring | RequisitoOpcional | Valores e limites 720p | Predefinição— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores e limites 16:9, 9:16, 1:1 | Predefinição— |
Campogenerate_audio | Tipoboolean | RequisitoOpcional | Valores e limites false, true Condições: Omitir esta opção seleciona o preço com áudio. Defina-a como false para selecionar o preço sem áudio. Verifique has_audio no resultado para saber se foi devolvida uma faixa de áudio. | Predefinição— |
Campoframe_images | Tipoarray | RequisitoOpcional | Valores e limites Número mínimo de elementos: 1 Número máximo de elementos: 2 Conteúdo de entrada: Matriz de objetos de fotograma. Cada objeto tem type=image_url, image_url com url e frame_type. Utilize um URL HTTPS de imagem e defina frame_type como first_frame ou last_frame. Cada função de fotograma aparece, no máximo, uma vez. Chaves exatas: type, image_url, frame_type Condições: Estas chaves descrevem cada objeto de fotograma; image_url contém apenas url. Omita frame_images num pedido apenas de texto. | Predefinição— |
Campoinput_references | Tipoarray | RequisitoOpcional | Valores e limites | Predefinição— |
Camposize | Tipostring | RequisitoOpcional | Valores e limites 1280x720, 720x1280, 720x720 Padrão: ^[1-9][0-9]*x[1-9][0-9]*$ | Predefinição— |
Campocallback_url | Tipostring | RequisitoOpcional | Valores e limites Padrão: ^https:// | Predefinição— |
Camposession_id | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campotrace | Tipoobject | RequisitoOpcional | Valores e limites | Predefinição— |
Campouser | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Texto para vídeo · Uma instrução escrita. · Obrigatório: model, prompt, duration
Forneça prompt como texto e duration em segundos inteiros. Escolha uma resolução suportada; adicione uma proporção ou utilize um tamanho enumerado.
model: Tipo: string · kwaivgi/kling-v3.0-pro
prompt: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim
Imagem para vídeo · Uma instrução escrita e uma imagem do primeiro fotograma. · Obrigatório: model, prompt, duration, frame_images
frame_images é uma matriz. Cada objeto de fotograma tem type, image_url e frame_type; image_url contém url. Defina type como image_url. Utilize first_frame com um last_frame opcional. Cada função de fotograma aparece, no máximo, uma vez. Forneça um URL HTTPS público de imagem para cada fotograma. Escolha uma resolução suportada; adicione uma proporção ou utilize um tamanho enumerado.
Chaves exatas: type, image_url, frame_type
model: Tipo: string · kwaivgi/kling-v3.0-pro
prompt: Tipo: string · Número máximo de bytes UTF-8: 10 000 · São obrigatórios caracteres que não sejam espaços: Sim
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt, duration |
Parâmetromaterial_types | Contratotext, image |
Parâmetroadditional_properties | Contratofalse |
Parâmetrooptional_controls | Contratoresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user |
Ciclo de vida: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Componente do custo | Resolução de referência | Modo de referência | Áudio de referência | Unidade de faturação | Condições de faturação | Custo |
|---|---|---|---|---|---|---|---|---|---|
| ConfiguraçãoTarifas base por token | Tabela de tarifasTarifa base | Quantidade prevista— | Componente do custo— | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturação— | Condições de faturação— | 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çãoSaída de vídeo · tarifa de referência | Tabela de tarifas— | Quantidade prevista— | Componente do custoreference_output_rate | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturaçãopor segundo de saída | Condições de faturação— | Custo Saída · Tarifa de referência por segundo de vídeo de saída · Estimativa apenas para comparação $0.224 por segundo de saída |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãoáudio: with_audio | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.336 por segundo de vídeo |
| ConfiguraçãoImagem para vídeo (imagens de fotogramas) · 1080p · tarifa de referência | Tabela de tarifas— | Quantidade prevista— | Componente do custoreference_output_rate | Resolução de referência1080p | Modo de referênciaImagem para vídeo (fotogramas) | Áudio de referênciaSem áudio | Unidade de faturaçãopor segundo de saída | Condições de faturação— | Custo Saída · Tarifa de referência por segundo de vídeo de saída · Estimativa apenas para comparação $0.224 por segundo de saída |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãomodo de geração: image_to_video; resolução: 720p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.224 por segundo de vídeo |
| ConfiguraçãoTexto para vídeo · 1080p · tarifa de referência | Tabela de tarifas— | Quantidade prevista— | Componente do custoreference_output_rate | Resolução de referência1080p | Modo de referênciaTexto para vídeo | Áudio de referênciaSem áudio | Unidade de faturaçãopor segundo de saída | Condições de faturação— | Custo Saída · Tarifa de referência por segundo de vídeo de saída · Estimativa apenas para comparação $0.224 por segundo de saída |
| ConfiguraçãoTexto para vídeo · 480p · tarifa de referência | Tabela de tarifas— | Quantidade prevista— | Componente do custoreference_output_rate | Resolução de referência480p | Modo de referênciaTexto para vídeo | Áudio de referênciaSem áudio | Unidade de faturaçãopor segundo de saída | Condições de faturação— | Custo Saída · Tarifa de referência por segundo de vídeo de saída · Estimativa apenas para comparação $0.224 por segundo de saída |
| ConfiguraçãoPreço do vídeo | Tabela de tarifas— | Quantidade prevista— | Componente do custo— | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturaçãopor segundo de vídeo | Condições de faturaçãomodo de geração: text_to_video; resolução: 720p | Custo Saída · Preço do vídeo · Estimativa apenas para comparação $0.224 por segundo de vídeo |
| ConfiguraçãoCusto estimado de geração | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Componente do custo— | Resolução de referência— | Modo de referência— | Áudio de referência— | Unidade de faturação— | Condições de faturação— | Custo Saída · Custo estimado de geração · Estimativa apenas para comparação $0.672 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 →
As tabelas de referência do modelo não alteram a seleção do método, as cotações ou os custos. Os custos ativos usam as tarifas do método Ailoot selecionado.
Associe cada custo às condições apresentadas. Use uma única tarifa para cada conjunto de configurações alternativas.
| Configuração | Condições de faturação | Custo |
|---|---|---|
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoNão é declarada nenhuma condição adicional nesta chave de preços. | Custo Saída · Preço do vídeo $0.224 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãoáudio: with_audio | Custo Saída · Preço do vídeo $0.336 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: text_to_video; resolução: 480p | Custo Saída · Preço do vídeo $0.224 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: text_to_video; resolução: 720p | Custo Saída · Preço do vídeo $0.224 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: image_to_video; resolução: 720p | Custo Saída · Preço do vídeo $0.224 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: text_to_video; resolução: 1080p | Custo Saída · Preço do vídeo $0.224 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
| ConfiguraçãoPreço do vídeo | Condições de faturaçãomodo de geração: image_to_video; resolução: 1080p | Custo Saída · Preço do vídeo $0.224 por segundo de vídeo Referência de preço publicada para a configuração apresentada. Os montantes finais cobrados seguem a configuração efetivamente faturada. |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\nURLs assinados para conteúdo pertencente ao utilizador
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\nGuarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.
Conserve todos os resultados reais que pertencem ao utilizador e os respetivos metadados medidos devolvidos.
503 result_pending_check + id original + X-Should-Retry:false; nunca repita o original
| Campo | Tipo | Significado |
|---|---|---|
Campoindex | Tipointeger | SignificadoPosição deste vídeo na lista de saídas, com contagem a partir de zero. |
Campocontent_url | Tipostring | SignificadoURL HTTPS assinado para transferir este vídeo concluído. |
Camposha256 | Tipostring | null | SignificadoResumo criptográfico SHA-256 dos bytes do vídeo original; null se não estiver disponível. |
Camposize_bytes | Tipointeger | null | SignificadoTamanho do ficheiro de vídeo original em bytes; null se não estiver disponível. |
Campoduration_ms | Tipointeger | null | SignificadoDuração medida do vídeo em milissegundos; null se não estiver disponível. |
Campowidth | Tipointeger | null | SignificadoLargura do vídeo em píxeis; null se não estiver disponível. |
Campoheight | Tipointeger | null | SignificadoAltura do vídeo em píxeis; null se não estiver disponível. |
Campovideo_codec | Tipostring | null | SignificadoIdentificador do codec de vídeo; null se não estiver registado. |
Campohas_audio | Tipoboolean | null | SignificadoIndica se o vídeo contém uma faixa de áudio; null se não tiver sido medido. |
Campoaudio_codec | Tipostring | null | SignificadoIdentificador do codec de áudio; null quando não está registado qualquer identificador. |
| Resposta | Condição | Passo seguinte |
|---|---|---|
Resposta404 · not_found_error | CondiçãoO acesso ao vídeo não está disponível ou este ID de vídeo não foi encontrado. | Passo seguinteVerifique o acesso ao vídeo. Para um vídeo existente, utilize o ID público original e a mesma chave API. |
Resposta401 · authentication_error | CondiçãoA chave API não corresponde à conta autenticada. | Passo seguinteVerifique a sua chave API e o acesso à conta antes de enviar. |
Resposta400 · invalid_request_error | CondiçãoNão foi possível ler o pedido ou o índice de transferência é inválido. | Passo seguinteCorrija o corpo do pedido. Para uma transferência, escolha um índice de saída devolvido pela tarefa original. |
Resposta422 · price_unavailable | CondiçãoNão é possível calcular o preço da configuração de vídeo selecionada. | Passo seguinteEscolha uma configuração de vídeo suportada e preencha as opções obrigatórias antes de enviar um pedido corrigido. |
Resposta422 · invalid_request_error | CondiçãoUma entrada de vídeo ou a tarefa original de continuação é inválida. | Passo seguinteUtilize entradas HTTPS válidas. Para continuação, utilize o ID público do seu vídeo original concluído com a mesma chave API. |
Resposta402 · billing_error | CondiçãoO saldo disponível ou os limites não permitem efetuar uma reserva. | Passo seguinteVerifique o saldo disponível e os limites antes de enviar um novo pedido. |
Resposta503 · server_error | CondiçãoA verificação, o armazenamento ou o acesso ao serviço de vídeo está temporariamente indisponível. | Passo seguinteAguarde a disponibilidade do serviço. Se já tiver um ID de vídeo, consulte essa tarefa original em vez de criar outra geração. |
Resposta503 · result_pending_check | CondiçãoO resultado e a cobrança do vídeo original precisam de verificação. | Passo seguinteConserve o ID de vídeo devolvido e consulte essa tarefa. Não envie um pedido de geração substituto enquanto estiver a ser verificada. |
Resposta503 · owned_result_unavailable | CondiçãoA transferência do vídeo existente está temporariamente indisponível. | Passo seguinteConsulte a mesma tarefa de vídeo mais tarde e transfira a saída existente. Uma nova geração cria uma operação separada. |
Resposta409 · video_not_ready | CondiçãoO conteúdo do vídeo não foi publicado. | Passo seguinteConsulte o estado da tarefa original. Transfira quando indicar completed; se indicar failed, siga o aviso de verificação da cobrança. |
Ailoot Ultra kwaivgi/kling-v3.0-pro
Use os caminhos dos métodos indicados acima.