Saltar para o conteúdo principal
POST
Envie uma solicitação assíncrona para POST /v1/images/generations com model: "kling-v4-long-image". Obtenha data[0].task_id e consulte GET /v1/tasks/{task_id}. Cada solicitação retorna um PNG vertical; o modo web produz uma imagem do design da página.

Escolher modo

Autenticação

string
obrigatório
Use Authorization: Bearer <token>, em que <token> é sua chave de API da APIMart.

Parâmetros da solicitação

string
obrigatório
Deve ser kling-v4-long-image.
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de imagem.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Obrigatório, não pode conter apenas espaços. Até 166.000 caracteres em inglês e 71.000 em chinês ou idiomas semelhantes; textos mistos são calculados proporcionalmente. Descreva layout, seções, textos, estilo e sujeito.
string
obrigatório
Obrigatório: ecommerce para páginas de produto ou webpage para design web, sem distinção de maiúsculas. Cada modo usa campos de referência diferentes.
string
padrão:"medium"
Somente para skill: "ecommerce": short, medium (padrão) ou long, aproximadamente 2–5, 6–10 ou 11–18 seções. Conteúdo e altura reais dependem do resultado. Omita este campo no modo web; enviá-lo retorna HTTP 400.
string
padrão:"1K"
Aceita 1K (padrão) e 2K, sem distinção de maiúsculas, em todos os comprimentos comerciais, incluindo long + 2K. A largura de saída é 1024 ou 2048 px, respectivamente; a altura depende do conteúdo. 4K não é suportado.
string[]
Somente para comércio: 1–3 imagens de produto obrigatórias. No modo web, omita o campo e use image_with_roles. Forneça URLs diretas públicas. Para arquivos locais, use a API de upload de imagens e envie a url retornada.
object[]
Opcional, somente para web. No máximo uma imagem style e uma subject; uma ou ambas podem ser omitidas. Omita o campo no modo comércio.
integer
Cada solicitação gera uma imagem longa. Omita o campo ou use o inteiro 1; outros valores retornam HTTP 400.
boolean
Omita o campo ou use false; true retorna HTTP 400.
Não envie size, aspect_ratio, width, height, mask_url, sequential_image_generation ou sequential_image_generation_options. Mesmo null ou string vazia nesses campos retorna HTTP 400.

Requisitos e referências no prompt

Aceita JPG / JPEG / PNG. No máximo 30 MB por imagem, pelo menos 300 px em cada lado e proporção de 2:5 a 5:2. URL com HTTP 403 / 404 / 410, dimensões ou proporção inválidas e arquivo grande demais retornam HTTP 400 síncrono, sem tarefa ou cobrança de geração. Outras falhas de obtenção, como tempo limite do servidor de origem, são aceitas inicialmente; depois a tarefa falha e o valor antecipado é reembolsado. Use @Image1, @Image2 etc. No comércio, a ordem segue image_urls; no modo web, estilo primeiro e sujeito depois. Se houver apenas uma imagem, ela será @Image1.

Exemplos de solicitação

Envie para POST /v1/images/generations. Substitua as URLs de exemplo por links diretos acessíveis.

Página de produto longa em 2K

Página web com referências de estilo e sujeito

Página web apenas com prompt

Consultar a tarefa

Consulte a API de tarefas aproximadamente a cada 10 segundos. Guarde o task_id e evite duplicar a solicitação durante esperas longas.
Este exemplo mostra a estrutura de um resultado bem-sucedido. images e url são arrays; este modelo retorna uma imagem longa por solicitação.
Baixe a imagem antes do timestamp Unix em segundos em data.result.images[0].expires_at. O link expira depois.
A geração costuma levar vários minutos; uma amostra long + 2K levou 432 segundos. estimated_time retorna atualmente 60 segundos fixos: não use como contagem regressiva ou limite de espera. O tempo varia com conteúdo e carga; a amostra não é um limite máximo.Altura e tamanho do arquivo variam com o conteúdo. Uma amostra long + 2K tinha 2048×46615 e 63,9 MB; esses valores não são limites de saída. Resultados podem ultrapassar 50 MB: considere o custo de download e exibição de imagens grandes.

Cobrança

Cada solicitação cobra uma imagem longa na faixa escolhida, mais as referências: preço da faixa de saída + quantidade de referências × preço por referência. Produto, estilo e sujeito são contados; a primeira referência também é cobrada. As 8 faixas de saída estão abaixo. Chaves: kling-v4-long-image@<faixa> e kling-v4-long-image@input para referências. Na solicitação de geração, resolution continua aceitando apenas 1K ou 2K. O valor é descontado no envio, liquidado no sucesso e totalmente reembolsado na falha. Consulte a página de preços para tarifas e descontos da conta.

Erros comuns

Estes erros retornam HTTP 400 síncrono, sem tarefa ou cobrança de geração. Leia error.message para erros de envio e data.error.message para falhas após criar a tarefa.