Edit or restyle an image with direct reference images or named multi-angle subjects. Choose standard or coherent series output at 2K, 4K, or 8K.
Developer API pricing
Provider: SeeAPI
USD estimate: $0.0037 / credit · Estimated equivalent, not an additional charge.
2K: 15.231 credits/gen (≈ $0.057/gen)
4K: 22.913 credits/gen (≈ $0.086/gen)
8K: 38.143 credits/gen (≈ $0.14/gen)
Additional reference images: +0.674 credits/image (≈ $0.003/image) (billed per additional image)
/v1/generationsStable key for retrying the same request. Reuse it only with an identical request body. Maximum length is 255 characters.
order-20260818-001Use kling-image-4-0.
kling-image-4-0kling-image-4-0kling-image-4-0Use image-edit for reference-based image generation.
image-editimage-editimage-editOptional public provider name. Use seeapi or omit it to use the default route.
seeapiseeapiseeapiObject containing the prompt, reference images or named subjects, output mode, aspect ratio, and resolution.
Provider parameters
seeapiDefault ProviderDescribe the requested edit or transformation in 1–20,000 characters.
A cinematic city at nightOptional direct reference image URLs for source images that should guide the edit. Reference material is a billing dimension.
["https://client.example.com/reference.png"]Optional named subjects for multi-angle or consistent subject generation. Each element groups a name with its reference images and optional metadata. Reference material is a billing dimension.
[{"name":"subject_1","image_urls":["https://client.example.com/front.png","https://client.example.com/side.png"]}]Stable subject name used to identify this element in the prompt.
subject_1Reference image URLs for the named subject. Provide the subject views required by the generation.
["https://client.example.com/front.png","https://client.example.com/side.png"]Optional short tag for the named subject.
Optional description of the subject and the role it should play.
Generation mode. Use default for one image per request or series for a coherent group.
defaultseriesdefaultMaximum number of images requested. The provider may return fewer. Requested count, resolution, and reference material are billing dimensions.
1Output aspect ratio.
auto1:116:99:164:33:43:22:321:9autoOutput resolution. Use 2K, 4K, or 8K. Resolution and requested count are billing dimensions.
2K4K8K2KOptional absolute HTTPS URL for terminal generation webhooks.
https://client.example.com/webhooks/seeapiAccepted generation record and its current lifecycle state.
Unique generation ID used to query status and retrieve results.
task_xxxModel slug from the request.
kling-image-4-0Endpoint used for the request.
image-editPublic provider name used for routing.
seeapiseeapi: SeeAPIseeapiCurrent lifecycle status. An accepted request starts in processing.
processingprocessingReserved credits for this request based on the requested output and references.
16.579Credits consumed after provider processing is reconciled.
0Credits returned after a failed or cancelled request, when applicable.
0Timestamp when the generation record was created.
2026-08-18T10:00:00ZTimestamp when the generation record was last updated.
2026-08-18T10:00:00ZWhether this response replays an earlier request with the same Idempotency-Key.
falseAccepted generation record and its current lifecycle state.
Unique generation ID used to query status and retrieve results.
task_xxxModel slug from the request.
kling-image-4-0Endpoint used for the request.
image-editPublic provider name used for routing.
seeapiseeapi: SeeAPIseeapiCurrent lifecycle status. An accepted request starts in processing.
processingprocessingReserved credits for this request based on the requested output and references.
16.579Credits consumed after provider processing is reconciled.
0Credits returned after a failed or cancelled request, when applicable.
0Timestamp when the generation record was created.
2026-08-18T10:00:00ZTimestamp when the generation record was last updated.
2026-08-18T10:00:00ZWhether this response replays an earlier request with the same Idempotency-Key.
falseInvalid JSON, parameters, Schema, or API Policy
Invalid API Key or authentication failed
Insufficient credits
The current request is not allowed
Model, Endpoint, or task not found
Idempotency conflict or the same request is still being created
Request body is too large
Too many requests
Service temporarily unavailable
After submitting a task, use the unified query endpoint to check progress and retrieve results:
For production workloads, prefer Webhooks for terminal updates and use task-status queries as a fallback when a callback is not available.
Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.
Callback URL per generation.
const response = await fetch("https://api.seeapi.com/v1/generations", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Idempotency-Key": "order-20260818-001",
"Content-Type": "application/json"
},
body: JSON.stringify({
"model": "kling-image-4-0",
"endpoint": "image-edit",
"provider": "seeapi",
"input": {
"prompt": "A cinematic city at night",
"input_images": [
"https://client.example.com/reference.png"
],
"elements": [
{
"name": "subject_1",
"image_urls": [
"https://client.example.com/front.png",
"https://client.example.com/side.png"
]
}
],
"mode": "default",
"num_output_images": 1,
"aspect_ratio": "auto",
"resolution": "2K"
},
"callback_url": "https://client.example.com/webhooks/seeapi"
})
});
const result = await response.json();{
"generation": {
"id": "task_xxx",
"model": "kling-image-4-0",
"endpoint": "image-edit",
"provider": "seeapi",
"status": "processing",
"estimated_credits": 16.579,
"consumed_credits": 0,
"refunded_credits": 0,
"created_at": "2026-08-18T10:00:00Z",
"updated_at": "2026-08-18T10:00:00Z"
},
"idempotent": false
}