4Z API

Subject (old)

Endpoint: POST https://4zapi.com/kling/v1/general/custom-elements

Parameters

  • Content-Type (header, string): Request body Content-Type, usually application/json
  • Authorization (header, string): Bearer API Key

Request body (application/json)

  • element_description (string, required): Subject description max 100 characters
  • element_frontal_image (string, required): Frontal subject reference image. Accepts Base64 or reachable URL; .jpg/.jpeg/.png; max 10MB; min side 300px; aspect ratio 1:2.5–2.5:1
  • element_name (string, required): Subject name max 20 characters
  • element_refer_list (array<object>, required): Additional subject reference list. Upload 1–3 refs from different angles to define appearance, as key:value, e.g. "element_refer_list":[{"image_url":"image_url_1"}, ...]

Request example

{
  "element_description": "",
  "element_frontal_image": "",
  "element_name": "",
  "element_refer_list": []
}