Kling V3 Image 2 Image Serverless API

Transform images into photorealistic, production-ready visuals.

~66.42s

$0.035 per generation

~66.42s

$0.035 per generation

 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/kling-3-image2image"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "prompt": "Transform this Japanese garden into a magical winter wonderland. Snow covering the cherry blossom branches with delicate white blooms still visible beneath, frozen koi pond with crystalline ice patterns, stone lanterns dusted with snow, soft blue twilight lighting, aurora borealis faintly visible in the sky, mystical and ethereal atmosphere, photorealistic, 8K, cinematic",
12    "image_url": "https://segmind-resources.s3.amazonaws.com/input/kling3-i2i-input.webp",
13    "resolution": "1K",
14    "aspect_ratio": "16:9",
15    "output_format": "png"
16}
17
18response = requests.post(url, headers=headers, json=data)
19
20if response.status_code == 200:
21    result = response.json()
22    print(json.dumps(result, indent=2))
23else:
24    print(f"Error: {response.status_code}")
25    print(response.text)

 1import requests
 2import json
 3
 4url = "https://api.segmind.com/v1/kling-3-image2image"
 5headers = {
 6    "x-api-key": "YOUR_API_KEY",
 7    "Content-Type": "application/json"
 8}
 9
10data = {
11    "prompt": "Transform this Japanese garden into a magical winter wonderland. Snow covering the cherry blossom branches with delicate white blooms still visible beneath, frozen koi pond with crystalline ice patterns, stone lanterns dusted with snow, soft blue twilight lighting, aurora borealis faintly visible in the sky, mystical and ethereal atmosphere, photorealistic, 8K, cinematic",
12    "image_url": "https://segmind-resources.s3.amazonaws.com/input/kling3-i2i-input.webp",
13    "resolution": "1K",
14    "aspect_ratio": "16:9",
15    "output_format": "png"
16}
17
18response = requests.post(url, headers=headers, json=data)
19
20if response.status_code == 200:
21    result = response.json()
22    print(json.dumps(result, indent=2))
23else:
24    print(f"Error: {response.status_code}")
25    print(response.text)

API Endpoint

POSThttps://api.segmind.com/v1/kling-3-image2image

Parameters

image_urlrequired

string (uri)

The image to transform.

promptrequired

string

Describe the desired transformation of the input image.

aspect_ratiooptional

string

Frame dimensions for the output image.

Default: "16:9"

Allowed values :

"16:9""9:16""1:1""4:3""3:4""3:2""2:3"

elementsoptional

object[]

Character/object elements to include.

Array items:

frontal_image_urloptional

string (uri)

Frontal view image of the character or object.

reference_image_urlsoptional

string[]

Up to 3 reference images for this element.

output_formatoptional

string

Select output format.

Default: "png"

Allowed values :

PNG→"png"

JPEG→"jpeg"

WebP→"webp"

resolutionoptional

string

Output resolution. 1K for standard, 2K for higher quality.

Default: "1K"

Allowed values :

"1K""2K"

Response Type

Returns: Image

Common Error Codes

The API returns standard HTTP status codes. Detailed error messages are provided in the response body.

400

Bad Request

Invalid parameters or request format

401

Unauthorized

Missing or invalid API key

403

Forbidden

Insufficient permissions

404

Not Found

Model or endpoint not found

406

Insufficient Credits

Not enough credits to process request

429

Rate Limited

Too many requests

500

Server Error

Internal server error

502

Bad Gateway

Service temporarily unavailable

504

Timeout

Request timed out