SEEAPISEEAPI
Developer CenterDocs
Get API Key
  • Getting Started
  • Authentication
  • List Model Prices
  • Create a Generation
  • Get Task Details
Image Models
Alibaba
Black Forest Labs
ByteDance
Google
Grok
Kling
MiniMax
OpenAI
SeeAPI
Video Models
Alibaba
ByteDance
Google
Grok
Kling
Lightricks
MiniMax
PixVerse
Runway
SeeAPI
Vidu
Music Models
Text Models
Templates
  • 24K Magic AI API
  • Alors on Danse API
  • Apartment Dance API
  • Christmas Dance Trend API
  • Crazy Frog AI API
  • Enzo Fernandez Celebration API
  • Goodbye 2026, Welcome 2027 API
  • Hotel Lobby AI API
  • Neon Duo Dance API
  • Rap Video API
  • Rumpelstiltskin AI Dance API

Policies

  • Data Handling & Privacy
  • Terms of Service
  • Privacy Policy
  • Commercial Use Policy
www.seeapi.com

One AI API for every leading model. Create images, videos, music, and multimodal AI assets online, or build with one unified API.

Follow SeeAPI
𝕏
Explore
  • AI Model Collections
  • AI Tool Alternatives
Developers
  • AI Models
  • API Pricing
  • AI Integrations
  • API Keys
  • Documentation
Support
  • Pricing
  • [email protected]
Legal
  • Privacy Policy
  • Refund Policy
  • Terms & Conditions

Copyright 2026 © SeeAPI. All rights reserved.

GROWCRAFT PTE. LTD.

·5 RAFFLES PLACE, #06-00, RAFFLES PLACE MRT STATION, SINGAPORE 048618

Text to ImageImage EditLong Image

Kling Image 4.0 · Image Edit

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)

Add-on

Additional reference images: +0.674 credits/image (≈ $0.003/image) (billed per additional image)

Request

POST/v1/generations
AuthorizationSend your API key in the Authorization header using the Bearer scheme.Authorization: Bearer ****************

Header Params

stringrequired

Stable key for retrying the same request. Reuse it only with an identical request body. Maximum length is 255 characters.

max length: 255
Example:
order-20260818-001

Body Params

application/json
stringrequired

Use kling-image-4-0.

Allowed:kling-image-4-0
Default:
kling-image-4-0
Example:
kling-image-4-0
stringrequired

Use image-edit for reference-based image generation.

Allowed:image-edit
Default:
image-edit
Example:
image-edit
stringoptional

Optional public provider name. Use seeapi or omit it to use the default route.

Allowed:seeapi
Default:
seeapi
Example:
seeapi
objectrequired

Object containing the prompt, reference images or named subjects, output mode, aspect ratio, and resolution.

Provider parameters

SeeAPIseeapiDefault Provider
stringrequired

Describe the requested edit or transformation in 1–20,000 characters.

min length: 1max length: 20000
Example:
A cinematic city at night
array <uri>optional

Optional direct reference image URLs for source images that should guide the edit. Reference material is a billing dimension.

  • Supported formats: PNG, JPEG
  • Maximum file size: 20MB;
  • Maximum files: 10
max items: 10
Example:
["https://client.example.com/reference.png"]
array <object>optional

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.

  • Referenced in the prompt as @name.
  • Each element needs 2-4 images.
  • Image_urls and elements together cannot exceed 10.
max items: 10
Example:
[{"name":"subject_1","image_urls":["https://client.example.com/front.png","https://client.example.com/side.png"]}]
stringrequired

Stable subject name used to identify this element in the prompt.

min length: 1max length: 20
Example:
subject_1
array <uri>required

Reference image URLs for the named subject. Provide the subject views required by the generation.

  • Supported formats: PNG, JPEG
  • Maximum file size: 20MB
min items: 2max items: 4
Example:
["https://client.example.com/front.png","https://client.example.com/side.png"]
stringoptional

Optional short tag for the named subject.

  • Allowed values: character、animal、prop、costume、scene、effect、others
stringoptional

Optional description of the subject and the role it should play.

  • Optional subject description, max 100 characters.
stringoptional

Generation mode. Use default for one image per request or series for a coherent group.

  • default: standard generation; num_output_images can be 1–9.
  • series: generates a coherent set of images (e.g. the same character from morning to night); num_output_images is required and can be 2–10.
Allowed:defaultseries
Default:
default
numberoptional

Maximum number of images requested. The provider may return fewer. Requested count, resolution, and reference material are billing dimensions.

  • Standard mode supports 1–9 images.
  • Series mode requires 2–10 images.
min: 1max: 10
Default:
1
stringoptional

Output aspect ratio.

Allowed:auto1:116:99:164:33:43:22:321:9
Default:
auto
stringoptional

Output resolution. Use 2K, 4K, or 8K. Resolution and requested count are billing dimensions.

Allowed:2K4K8K
Default:
2K
string <uri>optional

Optional absolute HTTPS URL for terminal generation webhooks.

max length: 2048
Example:
https://client.example.com/webhooks/seeapi

Responses

202The generation request was accepted and is being processed.
Bodyapplication/json
  • Use generation.id with the unified task-status endpoint to retrieve progress and results. If callback_url was supplied, wait for the terminal webhook.
objectrequired

Accepted generation record and its current lifecycle state.

stringrequired

Unique generation ID used to query status and retrieve results.

Example:
task_xxx
stringrequired

Model slug from the request.

Example:
kling-image-4-0
stringrequired

Endpoint used for the request.

Example:
image-edit
stringrequired

Public provider name used for routing.

Allowed:seeapi
  • seeapi: SeeAPI
Example:
seeapi
stringrequired

Current lifecycle status. An accepted request starts in processing.

Allowed:processing
Example:
processing
numberrequired

Reserved credits for this request based on the requested output and references.

Example:
16.579
numberrequired

Credits consumed after provider processing is reconciled.

Example:
0
numberrequired

Credits returned after a failed or cancelled request, when applicable.

Example:
0
string <date-time>required

Timestamp when the generation record was created.

Example:
2026-08-18T10:00:00Z
string <date-time>required

Timestamp when the generation record was last updated.

Example:
2026-08-18T10:00:00Z
booleanrequired

Whether this response replays an earlier request with the same Idempotency-Key.

Example:
false
200The existing generation request was replayed idempotently.
Bodyapplication/json
  • Reuse the same Idempotency-Key only with the identical request body.
objectrequired

Accepted generation record and its current lifecycle state.

stringrequired

Unique generation ID used to query status and retrieve results.

Example:
task_xxx
stringrequired

Model slug from the request.

Example:
kling-image-4-0
stringrequired

Endpoint used for the request.

Example:
image-edit
stringrequired

Public provider name used for routing.

Allowed:seeapi
  • seeapi: SeeAPI
Example:
seeapi
stringrequired

Current lifecycle status. An accepted request starts in processing.

Allowed:processing
Example:
processing
numberrequired

Reserved credits for this request based on the requested output and references.

Example:
16.579
numberrequired

Credits consumed after provider processing is reconciled.

Example:
0
numberrequired

Credits returned after a failed or cancelled request, when applicable.

Example:
0
string <date-time>required

Timestamp when the generation record was created.

Example:
2026-08-18T10:00:00Z
string <date-time>required

Timestamp when the generation record was last updated.

Example:
2026-08-18T10:00:00Z
booleanrequired

Whether this response replays an earlier request with the same Idempotency-Key.

Example:
false
400

Invalid JSON, parameters, Schema, or API Policy

401

Invalid API Key or authentication failed

402

Insufficient credits

403

The current request is not allowed

404

Model, Endpoint, or task not found

409

Idempotency conflict or the same request is still being created

413

Request body is too large

429

Too many requests

503

Service temporarily unavailable

Query Task Status

After submitting a task, use the unified query endpoint to check progress and retrieve results:

Get Task DetailsLearn how to query task status and retrieve generation results

For production workloads, prefer Webhooks for terminal updates and use task-status queries as a fallback when a callback is not available.

Related Resources

Market Overview

Explore all available models

Credits & Billing

View credit balance, plans, and billing activity

Usage

Review API usage and credit consumption

Callbacks

Manage the secret used to verify generation webhook signatures. Callback URLs are supplied when you create each generation.

Webhook flow

Callback URL per generation.

Webhook signing key
Code Examples
Request
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();
ResponseHTTP 202
{
  "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
}
PreviousKling Image 4.0 · Text to ImageNextKling Image 4.0 · Long Image
Request
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();
ResponseHTTP 202
{
  "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
}