Saltar para o conteúdo principal
POST
Envie uma solicitação assíncrona para POST /v1/images/generations com model: "kling-v4-image". Obtenha data[0].task_id e consulte o resultado com GET /v1/tasks/{task_id}.

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-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 para geração a partir de texto, de imagens e em série. Descreva o conteúdo desejado e o que deve ser evitado. O limite é de 50.000 caracteres para texto apenas em inglês e 21.000 para texto apenas em chinês ou idiomas semelhantes; textos mistos são calculados proporcionalmente.
string[]
Até 10 imagens de referência por URLs diretas acessíveis publicamente. Para arquivos locais, use a API de upload de imagens e envie a url retornada.Aceita JPG / JPEG / PNG / GIF. Cada imagem deve ter no máximo 30 MB, largura e altura de pelo menos 300 px e proporção entre 2:5 e 5:2.As referências são verificadas no envio. Uma URL que retorna HTTP 403 / 404 / 410, um lado menor que 300 px, uma proporção fora de 2:5–5:2 ou uma imagem maior que 30 MB retorna HTTP 400 imediatamente, sem criar tarefa nem cobrar a geração. Outras falhas ao obter a imagem, como tempo limite do servidor de origem, são aceitas inicialmente; a tarefa falha depois e os valores de geração descontados antecipadamente são reembolsados integralmente.Use @Image1, @Image2 etc. no prompt para indicar as imagens na ordem do array. Elas também são usadas como referência sem esses marcadores.
integer
padrão:"1"
Quantidade de saídas no modo padrão: inteiro de 1 a 9, padrão 1. No modo série, n pode ser omitido ou definido como 1; sequential_image_generation_options.max_images determina a quantidade de saídas. Enviar n > 1 em uma série retorna HTTP 400.
string
padrão:"2K"
Aceita 2K (padrão), 4K e 8K, sem distinguir maiúsculas de minúsculas. A saída é PNG. Em 1:1, 2K corresponde a 2048×2048, 4K a 4096×4096 e 8K a 8192×8192. Para outras proporções, consulte as dimensões reais das imagens retornadas.8K também permite geração a partir de texto, de imagens e em série: 1–9 saídas no modo padrão, 2–4 em série e até 10 imagens de referência. Os formatos, dimensões e o limite de 30 MB por imagem de referência permanecem iguais.
string
padrão:"auto"
Proporção da saída. Aceita auto (padrão) e estas 8 proporções:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.auto escolhe a proporção com base no prompt ou nas referências. Dimensões em pixels como 2048x2048 não são aceitas.
string
Alias de size com os mesmos valores. Se ambos forem enviados, aspect_ratio tem prioridade.
string
padrão:"disabled"
disabled ou a omissão do campo ativa a geração padrão. auto gera uma série de imagens relacionadas e exige sequential_image_generation_options.max_images. Aqui, auto não decide automaticamente a quantidade de imagens.
object
Define a quantidade de imagens no modo série.
width, height, mask_url, size em pixels e watermark: true não são suportados e retornam HTTP 400.

Exemplos de solicitação

Envie estas solicitações para POST /v1/images/generations. Substitua as URLs de exemplo por links diretos acessíveis.

Geração a partir de imagem

Gerar três imagens 4K

Gerar uma imagem 8K

Gerar uma série de quatro imagens 8K relacionadas

Defina max_images entre 2 e 4. Em série, n pode ser omitido ou definido como 1, mas não pode ser maior que 1. Uma série pode levar vários minutos; guarde o task_id e consulte o status para evitar envios duplicados.

Exemplos de saída 8K e tempo de processamento

As medições abaixo são amostras do ambiente de teste. Dimensões, tamanhos de arquivo e tempos são ilustrativos; os resultados reais podem variar. Consulte a cada 5–10 segundos até completed ou failed. estimated_time é fixo em 60 segundos e não deve ser usado como estimativa real ou contagem regressiva. Guarde o task_id e evite reenviar a solicitação enquanto aguarda. Os resultados 8K são PNGs originais, e um arquivo pode ultrapassar 100 MB. Em listas e prévias, use miniaturas geradas por você ou carregue as imagens sob demanda. Ofereça o download do original e informe que o arquivo é grande.

Consultar a tarefa

Leia data.status pela API de consulta de tarefas: pending / processing indica processamento, completed indica sucesso e failed indica falha, com detalhes em data.error.message.
A seguir está a estrutura de um resultado bem-sucedido. As URLs estão em data.result.images[].url[]; url é um array. Percorra todas as saídas e baixe-as assim que possível.

Cobrança

A cobrança considera a quantidade real de imagens geradas e a resolução escolhida. As referências são cobradas separadamente por imagem. Consulte a página de preços.
  • Na geração padrão, n=3 equivale a 3 saídas cobradas; em séries, usa-se a quantidade realmente retornada.
  • Cada referência é contada uma vez por solicitação, sem multiplicação pela quantidade de saídas. Gerar 3 imagens com 2 referências resulta em 2 entradas e 3 saídas cobradas.
  • Tarefas de geração que falham não são cobradas; os valores de geração descontados antecipadamente são reembolsados integralmente.

Erros comuns de parâmetros

Estes erros retornam HTTP 400 de forma síncrona no envio, sem criar tarefa nem cobrar a geração. Leia error.message para erros no envio e data.error.message para falhas após a criação da tarefa.