Como gerar imagens com o Kling Image 4.0 pela API do Kling
6 min de leitura • 19 de novembro de 2026
Sumário
- Introdução
- Antes de começar
- Kling Image 4.0 em resumo
- Gere uma imagem 8K em duas chamadas
- Series Mode: uma história a partir de um prompt
- Estilos, tons e fontes
- Imagens de referência
- Páginas de produto
- Designs de páginas web
- Quanto custa
- Gere em lote com o script
- O mesmo a partir de um assistente de IA
- Perguntas frequentes
- Conclusão
Introdução
O Kling Image 4.0 é o novo modelo de imagem da Kuaishou, e a API do Kling da useapi.net o roda na sua assinatura do site do Kling AI: basta enviar "omni_version": "v4" para POST images/omni. Um único endpoint cobre tudo o que o app do Kling faz com ele: fotos de até 8K, histórias em Series Mode com 2 a 10 imagens que combinam entre si, presets de estilo, tom e fonte citados no prompt, e duas skills de design que geram, cada uma, uma imagem de página longa: uma página de produto a partir de uma foto do produto e o design de uma página web.
Este guia reúne execuções reais numa assinatura Kling Pro, uma por recurso, com as requisições exatas, as imagens geradas e o custo de cada uma. Uma imagem 2K usou 4 créditos, cerca de US$ 0,04 no Pro. A API de desenvolvedor do próprio Kling vende a mesma imagem por US$ 0,06, em pacotes pré-pagos de imagens a partir de US$ 300.
Antes de começar
Você precisa de um token da API da useapi.net e de uma conta do Kling conectada pelo Setup Kling, num plano pago do Kling (Standard ou superior). 4K e 8K também exigem um plano pago. Exporte o token para que os exemplos com curl rodem sem alterações:
export USEAPI_TOKEN="user:1234-..." # your useapi.net API token
export KLING_EMAIL="[email protected]" # your connected Kling account
Kling Image 4.0 em resumo
| Modo | Requisição | O que você recebe | Créditos |
|---|---|---|---|
| Imagem | omni_version: v4 | de 1 a 9 imagens em 2K, 4K ou 8K, em qualquer uma de 9 proporções ou auto | 4 / 6 / 10 por imagem |
| Series Mode | story_mode: true | de 2 a 10 imagens que contam uma história, ou quantas o Kling decidir | o mesmo, por imagem |
| Presets | @style:, @tone:, @font: no prompt | um visual, uma gradação de cor ou um letreiro das listas do Kling | sem custo extra |
| Página de produto | skill: product_detail + image_1 | uma página longa a partir da foto do seu produto, curta, média ou longa | de 15 a 55 por página |
| Web design | skill: web_design | o design de uma landing page longa | 35 em 1K, 38 em 2K |
Até 10 imagens de referência e elements salvos funcionam como em qualquer requisição Omni: cite-os no prompt como @image_1 ou @element_1.
Gere uma imagem 8K em duas chamadas
1. Envie o job
curl -s -X POST "https://api.useapi.net/v1/kling/images/omni" \
-H "Authorization: Bearer $USEAPI_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "'"$KLING_EMAIL"'",
"omni_version": "v4",
"resolution": "8k",
"aspect_ratio": "16:9",
"prompt": "Macro photograph of a hummingbird hovering at a red trumpet flower at sunrise, every iridescent feather sharp, dew drops on the petals, soft golden backlight, shallow depth of field"
}'
A resposta é a nova tarefa, com o id em task.id:
{
"task": {
"id": 123456789012345,
"type": "mmu_omni_image",
"status": 5,
"status_name": "submitted",
"status_final": false
}
}
2. Consulte o resultado
Leia a tarefa com GET tasks/task_id até status_final ser true. Cada imagem é um item de works, com a sua URL e o seu tamanho:
curl -s "https://api.useapi.net/v1/kling/tasks/123456789012345?email=$KLING_EMAIL" \
-H "Authorization: Bearer $USEAPI_TOKEN" | jq '{status_name, works: [.works[] | {url: .resource.resource, width: .resource.width, height: .resource.height}]}'
{
"status_name": "succeed",
"works": [
{ "url": "https://s15-kling.klingai.com/kimg/.../image.png", "width": 10880, "height": 6144 }
]
}
A nossa execução gerou uma imagem de 10880 x 6144, 67 megapixels, e usou 6 créditos. O preço de tabela do 8K é 10 créditos, e o Kling cobrou 6 por causa de uma promoção naquele dia. A mesma requisição com "resolution": "2k" gera uma imagem de 2720 x 1536 por 4 créditos, e com "4k", uma de 5440 x 3072 por 6.
Kling Image 4.0, 8k, 16:9, 10880 x 6144, 6 créditos. Exibida menor aqui: abra o original (PNG de 10880 x 6144, 3,5 MB) para vê-la em 8K completo.
No tamanho real, o detalhe do 8K se sustenta. Este é um recorte de 1600 x 900 do mesmo arquivo, sem redimensionar:
A mesma imagem em 100%, a cabeça do pássaro.
Series Mode: uma história a partir de um prompt
story_mode: true gera uma série de imagens que combinam entre si: os mesmos personagens, o mesmo estilo e a mesma luz de um quadro para o outro. O Kling Image 4.0 cria a série só a partir do prompt, sem imagem de referência. Defina imageCount de 2 a 10, ou deixe de fora e o Kling decide quantas imagens a história precisa.
curl -s -X POST "https://api.useapi.net/v1/kling/images/omni" \
-H "Authorization: Bearer $USEAPI_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "'"$KLING_EMAIL"'",
"omni_version": "v4",
"story_mode": true,
"aspect_ratio": "4:3",
"prompt": "A picture-book story in consistent watercolor style: a small paper boat is folded by a child on a rainy city street, floats down the gutter, slips into a river past old bridges, and finally reaches the open sea at sunset"
}'
O Kling escolheu 6 imagens para esta história, cada uma com 2336 x 1760, e cobrou 4 créditos por imagem, 24 no total.
Kling Image 4.0 em Series Mode, story_mode: true, sem imageCount, 6 imagens, 24 créditos. Originais, PNG de 2336 x 1760: 1, 2, 3, 4, 5, 6.
Estilos, tons e fontes
O Kling Image 4.0 tem três tipos de presets, e você os cita no prompt. GET images/presets lista todos com os seus ids e uma imagem de exemplo: 98 estilos, 16 tons e 76 fontes em inglês, japonês, coreano e chinês.
curl -s "https://api.useapi.net/v1/kling/images/presets" -H "Authorization: Bearer $USEAPI_TOKEN" \
| jq '{styles: [.styles[0:3][] | .id], tones: [.tones[] | .id], fonts: [.fonts[] | select(.languages | index("en")) | .id][0:5]}'
- Um tom (
@tone:<id>) aplica uma das gradações de cor e luz do Kling: estilos de diretores, visuais de câmera e paletas. - Uma fonte (
@font:<id>) define o lettering do texto entre aspas que vem logo depois dela. - Um estilo (
@style:<id>) define o visual geral: 3D, 2D, artesanato com materiais ou estilos de fotografia.
Esta é a mesma cena sem tom e com @tone:Nostalgic_Wuxia, 4 créditos cada:
À esquerda: A lone swordsman in a bamboo forest at dawn, mist between the stalks, wide cinematic shot. À direita: o mesmo prompt depois de @tone:Nostalgic_Wuxia. Originais, PNG de 2720 x 1536: sem tom, Nostalgic Wuxia.
E uma placa de loja sem fonte e com @font:elegant_brush_hand. Coloque entre aspas as palavras que devem aparecer na imagem, com a fonte logo antes delas:
{ "prompt": "A cozy corner coffee shop at night, warm light spilling onto a wet cobblestone street, a hand-painted shop sign above the door that reads @font:elegant_brush_hand \"Moonlight Roasters\"" }
À esquerda: sem fonte. À direita: @font:elegant_brush_hand "Moonlight Roasters". Originais, PNG de 2496 x 1664: sem fonte, fonte de pincel.
@style:3d_cartoon_with_exaggerated_perspective_pro A corgi astronaut stepping out of a tiny rocket onto a candy-colored planet, looking up at the camera, 1:1, 4 créditos. Original (PNG de 2048 x 2048, 8,5 MB).
Um id desconhecido recebe um 400 antes de qualquer coisa chegar ao Kling, então um erro de digitação nunca custa créditos.
Imagens de referência
Cite uma referência no prompt como @image_1. Primeiro geramos uma foto de produto, depois usamos a URL dela como image_1 numa foto publicitária em 4K. O produto, o rótulo e a tampa de bambu se mantêm:
{
"omni_version": "v4",
"resolution": "4k",
"aspect_ratio": "16:9",
"prompt": "The bottle from @image_1 standing on a mossy rock beside a mountain stream, morning mist, outdoor adventure ad",
"image_1": "https://s15-kling.klingai.com/kimg/.../bottle.png"
}
À esquerda: a foto do produto, 3:4, 4 créditos. À direita: 4k com ela como @image_1, 5440 x 3072, 6 créditos. Originais: foto do produto (PNG de 1760 x 2336, 4,8 MB), foto publicitária 4K (PNG de 5440 x 3072, 24 MB).
Para enviar a sua própria foto, use POST assets e passe a URL que ele retorna.
Páginas de produto
skill: product_detail transforma uma foto de produto numa página de produto longa: destaque principal, diferenciais, closes e uma tabela de especificações, tudo diagramado numa única imagem. image_1 é a foto, prompt diz o que o produto faz e length define o número de seções: short (2 a 5), medium (6 a 10) ou long (11 a 18).
curl -s -X POST "https://api.useapi.net/v1/kling/images/omni" \
-H "Authorization: Bearer $USEAPI_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "'"$KLING_EMAIL"'",
"omni_version": "v4",
"skill": "product_detail",
"length": "short",
"resolution": "2k",
"image_1": "https://s15-kling.klingai.com/kimg/.../bottle.png",
"prompt": "Insulated steel water bottle \"Trailhead\": keeps drinks cold 24 hours and hot 12, leak-proof bamboo lid, fits car cup holders, 750 ml, three colors"
}'
A página voltou como uma única imagem de 2048 x 13408 por 18 créditos. Uma página medium em 1K saiu com 1024 x 9936 por 30 créditos.
skill: product_detail, length: short, 2k, 2048 x 13408, 18 créditos. Role o quadro para ver a página inteira, ou abra o original (PNG, 1,3 MB).
Designs de páginas web
skill: web_design gera o design de uma landing page como uma única imagem longa. image_1 é opcional: uma imagem cujo estilo a página deve seguir. O Kling escreve o texto da página em chinês, a menos que o prompt indique o idioma, então termine o prompt com o idioma que você quer:
curl -s -X POST "https://api.useapi.net/v1/kling/images/omni" \
-H "Authorization: Bearer $USEAPI_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"email": "'"$KLING_EMAIL"'",
"omni_version": "v4",
"skill": "web_design",
"resolution": "1k",
"prompt": "Landing page for \"Ember & Oak\", a small-batch coffee roaster: warm browns and cream, elegant serif headlines, hero photo of a pour-over, three featured roasts, a monthly subscription offer and customer reviews. All text on the page in English."
}'
skill: web_design, 1k, 1024 x 5376, 35 créditos. Role o quadro para ver a página inteira, ou abra o original (PNG, 0,7 MB).
Sem a última frase, o mesmo prompt em 2K gerou a página em chinês (2048 x 8514, 38 créditos), e o mesmo aconteceu com um web design feito no app do Kling:
O topo da página sem “All text on the page in English.” A página inteira: original (PNG de 2048 x 8514, 1,4 MB).
Quanto custa
O Kling Image 4.0 usa os créditos da sua assinatura do Kling AI, os mesmos em todos os planos. A API de desenvolvedor do Kling o vende em pacotes de imagens próprios, o menor por US$ 300 com 78.216 unidades (US$ 0,00384 por unidade, válido por 180 dias), e ainda cobra 0,8 unidade por imagem de referência ou element. Pela useapi.net, as referências não custam nada a mais.
| Modelo | API oficial | Premier $80,96/mês 8.000 cr/mês | Pro $32,56/mês 3.000 cr/mês | Standard $8,80/mês 660 cr/mês |
|---|---|---|---|---|
| Kling Image 4.0 2K | $0,06 16 unidades | $0,04 / 4 cr 2.000 imagens/mês | $0,04 / 4 cr 750 imagens/mês | $0,05 / 4 cr 165 imagens/mês |
| Kling Image 4.0 4K | $0,09 24 unidades | $0,06 / 6 cr 1.333 imagens/mês | $0,07 / 6 cr 500 imagens/mês | $0,08 / 6 cr 110 imagens/mês |
| Kling Image 4.0 8K | $0,15 40 unidades | $0,10 / 10 cr 800 imagens/mês | $0,11 / 10 cr 300 imagens/mês | $0,13 / 10 cr 66 imagens/mês |
| Página de produto 2K, curta | $0,28 72 unidades | $0,18 / 18 cr 444 páginas/mês | $0,20 / 18 cr 166 páginas/mês | $0,24 / 18 cr 36 páginas/mês |
| Página de produto 2K, longa | $0,84 220 unidades | $0,56 / 55 cr 145 páginas/mês | $0,60 / 55 cr 54 páginas/mês | $0,73 / 55 cr 12 páginas/mês |
| Web design 2K | $0,58 152 unidades | $0,38 / 38 cr 210 páginas/mês | $0,41 / 38 cr 78 páginas/mês | $0,51 / 38 cr 17 páginas/mês |
Preços em dólares americanos, em 19 de novembro de 2026. Os preços do Kling para todos os planos estão na calculadora de preços do Kling. Toda a nossa execução para este guia, 13 jobs que geraram 18 imagens e páginas, usou 181 créditos, cerca de US$ 1,96 no Pro.
Gere em lote com o script
O exemplo image-4 no nosso repositório do GitHub lê uma lista de prompts do prompts.json (os prompts deste guia), envia cada um, espera o resultado e baixa todas as imagens:
git clone https://github.com/useapi/kling-api.git
cd kling-api/image-4
node ./kling-image-4.mjs $USEAPI_TOKEN $KLING_EMAIL
Ele confere cada prompt antes de gastar créditos: uma página de produto precisa de image_1, uma skill gera em 1K ou 2K, e length só funciona com product_detail.
O mesmo a partir de um assistente de IA
O servidor MCP do Kling hospedado em https://api.useapi.net/v1/kling/mcp dá ao Claude Code, ao Cursor, ao VS Code e ao app do Claude as mesmas chamadas: kling_omni_image com omni_version: v4, e kling_list_image_presets para os ids de estilo, tom e fonte. Peça “uma foto 8K de…” ou “uma página de produto a partir desta foto” e o assistente monta a requisição.
Perguntas frequentes
Existe uma API do Kling Image 4.0? Sim. A useapi.net roda o Kling Image 4.0 na sua assinatura do Kling AI por meio de POST images/omni com omni_version: v4: 8K, Series Mode, presets, páginas de produto e web designs, por 4 créditos a imagem 2K, cerca de US$ 0,04 no Kling Pro. A API de desenvolvedor do próprio Kling também vende o modelo, a US$ 0,06 a imagem 2K em pacotes pré-pagos a partir de US$ 300, mais uma taxa por imagem de referência. Pela assinatura, sai cerca de 30% mais barato (em 19 de novembro de 2026).
Como gero uma imagem 8K no Kling? Envie "omni_version": "v4", "resolution": "8k" para POST images/omni num plano pago do Kling. A nossa execução em 16:9 voltou com 10880 x 6144 por 10 créditos no preço de tabela (US$ 0,11 no Kling Pro), e o Kling cobrou 6 durante a promoção. A API de desenvolvedor do Kling cobra US$ 0,15 pela mesma imagem 8K.
Por que o meu web design do Kling sai em chinês? O Kling Image 4.0 escreve o texto de uma página web_design em chinês, a menos que o prompt indique o idioma, tanto no app do Kling quanto pela API. Termine o prompt com “All text on the page in English.” A nossa página em inglês voltou em 1K por 35 créditos.
Quais presets posso usar? GET images/presets lista os 98 estilos, 16 tons e 76 fontes atuais do Kling, com ids e exemplos, iguais para todas as contas. Cite-os num prompt v4 como @style:<id>, @tone:<id> e @font:<id> antes do texto entre aspas. Eles não custam créditos a mais.
Conclusão
O Kling Image 4.0 está a uma requisição de distância, na assinatura que você já tem: omni_version: v4 em POST images/omni, de uma imagem 2K de 4 créditos a uma foto 8K de 67 megapixels, uma história em seis quadros ou uma página de produto completa. Comece pela documentação da API do Kling, ou rode o script image-4 com os prompts acima.