Skip to main content
POST
cURL

Tạo hình ảnh

Để xem tài liệu tham khảo tham số đầy đủ, hãy xem tài liệu Kling chính thức.
Sử dụng endpoint này để tạo hình ảnh tĩnh thông qua API tạo hình ảnh của Kling. Endpoint này hỗ trợ cả yêu cầu chỉ dùng văn bản và yêu cầu dùng ảnh tham chiếu thông qua cùng một luồng tác vụ bất đồng bộ.

Yêu cầu đầu tiên

Bắt đầu với model_name: kling-v3, prompt, naspect_ratio. Chỉ thêm ảnh tham chiếu, các thiết lập độ trung thực hoặc các trường nâng cao sau khi yêu cầu đầu tiên trả về một tác vụ có thể sử dụng được. Nếu bỏ qua model_name, hệ thống sẽ dùng một giá trị mặc định tương thích cũ, vì vậy hãy gửi rõ ràng kling-v3 cho các tích hợp mới.

Đọc phản hồi

Lưu task_id được trả về, sau đó poll route truy vấn hình ảnh Kling tương ứng cho đến khi task_status đạt trạng thái kết thúc. Nếu quy trình của bạn cần lưu trữ bền vững, hãy sao chép asset cuối cùng vào lớp lưu trữ của riêng bạn sau khi quá trình tạo hoàn tất.

Ủy quyền

Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Tiêu đề

Content-Type
string
mặc định:application/json

Must be application/json.

Nội dung

application/json
prompt
string
bắt buộc

Text prompt describing the image to generate. Maximum 2500 characters.

model_name
enum<string>
mặc định:kling-v1

Kling image model variant. Use kling-v3 for new requests. Omitting model_name uses the legacy CometAPI route default.

Tùy chọn có sẵn:
kling-v1,
kling-v1-5,
kling-v2,
kling-v2-1,
kling-v3
negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.

image
string

Reference image as a raw Base64 string without a data: prefix, or a public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

image_reference
enum<string>

Reference mode for legacy image-to-image requests when image is provided.

Tùy chọn có sẵn:
subject,
face
image_fidelity
number
mặc định:0.5

How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.

Phạm vi bắt buộc: 0 <= x <= 1
human_fidelity
number
mặc định:0.45

Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.

Phạm vi bắt buộc: 0 <= x <= 1
element_list
object[]

Optional Kling element references. The total count of element references and input images must not exceed 10.

resolution
enum<string>
mặc định:1k

Output resolution. Defaults to 1k.

Tùy chọn có sẵn:
1k,
2k
n
integer
mặc định:1

Number of images to generate. Range: 1-9.

Phạm vi bắt buộc: 1 <= x <= 9
aspect_ratio
enum<string>
mặc định:16:9

Output aspect ratio (width:height).

Tùy chọn có sẵn:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
watermark_info
object

Watermark options.

callback_url
string

Webhook URL to receive task status updates when the task completes.

external_task_id
string

Optional user-defined task ID for your own tracking. Must be unique per account.

Phản hồi

200 - application/json

Task request accepted or an error response returned by the API.

code
bắt buộc

Response code. 0 means the task request was accepted.

message
string
bắt buộc

Response message.

data
object
bắt buộc
request_id
string

Request identifier returned when present.