Skip to main content
POST
cURL
Utilisez ce endpoint pour réaliser l’outpainting d’une image au-delà de ses bordures d’origine lorsque vous avez besoin de plus de surface autour du contenu source.

Fonctionnement des ratios d’extension

  • Chaque ratio est mesuré par rapport à la largeur ou à la hauteur d’origine
  • La zone de canevas étendue combinée doit toujours rester dans les limites de surface documentées par Kling
  • Commencez avec de petites valeurs comme 0.1 de chaque côté avant de tenter des extensions plus importantes

Flux de requête

  • Envoyez les quatre champs de ratio, en utilisant 0 pour tout côté que vous ne souhaitez pas étendre
  • Enregistrez le task_id renvoyé
  • Interrogez le chemin de requête d’image Kling correspondant jusqu’à ce que la tâche atteigne un état terminal
Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

Autorisations

Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

En-têtes

Content-Type
string
défaut:application/json

Must be application/json.

Corps

application/json
image
string
requis

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
requis

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

Plage requise: 0 <= x <= 2
down_expansion_ratio
number
requis

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

Plage requise: 0 <= x <= 2
left_expansion_ratio
number
requis

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

Plage requise: 0 <= x <= 2
right_expansion_ratio
number
requis

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

Plage requise: 0 <= x <= 2
prompt
string

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

n
integer
défaut:1

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

Plage requise: 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.

Réponse

200 - application/json

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

code
requis

Response code. 0 means the task request was accepted.

message
string
requis

Response message.

data
object
requis
request_id
string

Request identifier returned when present.