Skip to main content
POST
cURL
Verwenden Sie diesen Endpunkt, um ein Bild per Outpainting über seine ursprünglichen Ränder hinaus zu erweitern, wenn Sie mehr Fläche um den Quellinhalt benötigen.

Wie die Erweiterungsverhältnisse funktionieren

  • Jedes Verhältnis wird im Vergleich zur ursprünglichen Breite oder Höhe gemessen
  • Die kombinierte erweiterte Zeichenfläche muss weiterhin innerhalb der dokumentierten Flächenlimits von Kling bleiben
  • Beginnen Sie mit kleinen Werten wie 0.1 auf jeder Seite, bevor Sie größere Erweiterungen versuchen

Anfrageablauf

  • Senden Sie alle vier Verhältnisfelder und verwenden Sie 0 für jede Seite, die Sie nicht erweitern möchten
  • Speichern Sie die zurückgegebene task_id
  • Fragen Sie den passenden Kling-Pfad zur Bildabfrage ab, bis die Aufgabe einen Endzustand erreicht
Die vollständige Parameterreferenz finden Sie in der offiziellen Kling-Dokumentation.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Header

Content-Type
string
Standard:application/json

Must be application/json.

Body

application/json
image
string
erforderlich

Source image to expand. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

up_expansion_ratio
number
erforderlich

Upward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

Erforderlicher Bereich: 0 <= x <= 2
down_expansion_ratio
number
erforderlich

Downward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

Erforderlicher Bereich: 0 <= x <= 2
left_expansion_ratio
number
erforderlich

Leftward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

Erforderlicher Bereich: 0 <= x <= 2
right_expansion_ratio
number
erforderlich

Rightward expansion ratio as a multiple of the original image dimension. Range: 0-2. Send 0 for sides you do not want to expand.

Erforderlicher Bereich: 0 <= x <= 2
prompt
string

Optional text prompt to guide the expanded area content. Maximum 2500 characters.

n
integer
Standard:1

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

Erforderlicher Bereich: 1 <= x <= 9
watermark_info
object

Watermark options.

callback_url
string

Webhook URL for task status notifications.

external_task_id
string

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

Antwort

200 - application/json

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

code
erforderlich

Response code. 0 means the task request was accepted.

message
string
erforderlich

Response message.

data
object
erforderlich
request_id
string

Request identifier returned when present.