kling-v1-6
O perfil kling-v1-6 gera vídeo a partir de uma descrição escrita da cena. Planeie um plano curto com um sujeito, uma ação e uma orientação de câmara claros, utilizando as opções de duração documentadas de cinco ou dez segundos. A geração é assíncrona: conserve a identidade da tarefa devolvida e obtenha o vídeo concluído depois de a tarefa original terminar com sucesso.
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.
O seletor exato kling-v1-6 identifica o perfil Kling de texto para vídeo. Submeta JSON a POST /v1/videos/generations com model definido como kling-v1-6 e a cena escrita em prompt. POST /v1/videos também aceita o mesmo pedido de geração. Um pedido claro descreve o que é visível, o que acontece durante o plano e como a câmara o observa. O pedido mínimo de cena fornece o seletor do modelo e o prompt, deixando os controlos adicionais do plano por especificar.
Para um plano de produto, descreva o objeto, a superfície, a iluminação e uma ação visível, como uma rotação lenta ou uma mudança de posição da câmara. Para um conceito de cena, identifique o cenário, o sujeito principal e o movimento no enquadramento. Mantenha a ação legível no vídeo solicitado. Um prompt pode descrever um pequeno barco a atravessar um lago calmo, uma vista ampla a partir da margem, a luz do início da manhã e uma câmara estável a acompanhar a direção do barco.
O limite de prompt é de 500 carateres. O parâmetro opcional negative_prompt pode conter até 200 carateres e descreve os elementos indesejados. As opções de duration documentadas para este perfil são 5 e 10 segundos. Os valores de mode são std e pro. cfg_scale é um número de 0 a 1; a documentação descreve os valores mais elevados como uma maior adesão ao texto. Escolha os controlos para o plano exato e preserve os valores submetidos com o resultado.
O objeto camera_control documentado apresenta os tipos de câmara simple, down_back, forward_up, right_turn_forward e left_turn_forward. A sua configuração simple identifica os controlos horizontal, vertical, pan, tilt, roll e zoom. O exemplo mínimo de texto fornece um ponto de partida útil quando é possível descrever uma cena sem um objeto separado de controlo da câmara. Dê ao movimento da câmara um objetivo claro no prompt, como revelar o sujeito ou acompanhar o seu movimento.
A submissão inicia uma tarefa assíncrona. Conserve o id devolvido, o cabeçalho X-Ailoot-Task-Id e polling_url e utilize depois GET nesse polling_url com a mesma chave de API do Ailoot para consultar a tarefa original. O estado da tarefa encontra-se em data.task_status: submitted e processing indicam que está pendente, succeed indica sucesso e failed indica insucesso. Uma confirmação de submissão é, portanto, um resultado intermédio. Em caso de sucesso, obtenha todos os URLs em data.task_result.videos[].url; são ligações para ficheiros de resultados geridas pelo Ailoot. GET /v1/videos/{id}/content obtém o primeiro resultado e o seu parâmetro de consulta index seleciona um resultado devolvido pelo respetivo índice com base zero. Guarde a resposta de estado com o vídeo selecionado. Se ocorrer um tempo limite ou uma resposta result_pending_check, preserve a identidade original devolvida e consulte essa operação, em vez de voltar a submeter o plano.
Reveja a filmagem concluída ao longo de toda a sua duração: a ação pretendida, a aparência do sujeito, o enquadramento e o movimento fazem parte da descrição do plano. Este perfil exato fornece o fluxo de texto para vídeo aqui descrito. Uma tarefa devolvida que ainda necessite de uma consulta de estado deve ser acompanhada através da sua identidade original, incluindo quando um pedido do cliente excede o tempo limite; preserve essas informações da tarefa antes de considerar um novo pedido de geração.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6Introdução
O perfil kling-v1-6 gera vídeo a partir de uma descrição escrita da cena. Planeie um plano curto com um sujeito, uma ação e uma orientação de câmara claros, utilizando as opções de duração documentadas de cinco ou dez segundos. A geração é assíncrona: conserve a identidade da tarefa devolvida e obtenha o vídeo concluído depois de a tarefa original terminar com sucesso.
- Entradas aceites
- Texto
- Resultados
- Vídeo
Disponível no Ailoot · entradas e métodos
Ailoot Ultra · Video POST /v1/videos
- Entrada
text- Saída
video
| Campo | Tipo | Requisito | Valores e limites | Predefinição |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObrigatório | Valores e limites kling-v1-6 | Predefinição— |
Campoprompt | Tipostring | RequisitoObrigatório | Valores e limites | Predefinição— |
Campomode | Tipostring | RequisitoObrigatório | Valores e limites std, pro | Predefinição— |
Campomodel_name | Tipostring | RequisitoOpcional | Valores e limites kling-v1-6 | Predefinição— |
Campocfg_scale | Tiponumber | RequisitoOpcional | Valores e limites Mínimo: 0 Máximo: 1 | Predefinição— |
Campoaspect_ratio | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Camponegative_prompt | Tipostring | RequisitoOpcional | Valores e limites | Predefinição— |
Campoduration | Tipointeger | RequisitoOpcional | Valores e limites 5, 10 | Predefinição— |
Parâmetros e ciclo de vida do método
| Parâmetro | Contrato |
|---|---|
Parâmetrocontent_type | Contratoapplication/json |
Parâmetrorequired | Contratomodel, prompt, mode |
Parâmetrooptional | Contratomodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Parâmetromaterial_types | Contratotext |
Parâmetroconditions | Contratomodel selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
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/media/assets
GET /v1/media/assets/{asset_id}
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çãoEstimated generation cost | Tabela de tarifas— | Quantidade previstaestimativa para uma geração | Custo Entrada · Custo estimado de geração · Estimativa apenas para comparação $6 estimativa antes da geração This estimate is not an additional charge or a fixed rate for the completed generation. |
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 · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-6", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Receber e guardar os resultados
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Guardar todos os resultados concluídos
Guarde cada vídeo concluído ou ficheiro devolvido; obtenha cada URL de recurso efetivamente devolvido.
Retain the complete response, all actual results, original identifiers, usage and response headers.
Se for necessário verificar a resposta original
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
Campos da resposta
| Campo | Tipo |
|---|---|
Campodata.task_result.videos[].url | Tipostring or array, as returned |
Aliases
Aliases do modelo
Ailoot Ultra kling-v1-6
Aliases dos caminhos dos métodos
/v1/videos/generations
IDs de chamada relacionados
FAQ · kling-v1-6
- Que entradas e resultados estão disponíveis?
POST /v1/videos·kling-v1-6:text→video- Que campos utiliza o pedido?
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Que limites se aplicam?
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1