Query Kling Omni Image Task

API Reference

Gateway path: GET /kling/v1/images/omni/{task_id}
Upstream capability: Kling OmniImage (/v1/images/omni-image)

Path Parameters

Parameter	Type	Required	Description
task_id	string	Yes	The `data.task_id` returned when creating the task

Request Example

curl --request GET \
  --url "https://www.maasunion.com/kling/v1/images/omni/your-task-id" \
  --header "Authorization: Bearer sk-xxxxxxxx"

Response Example (Succeeded · Single Image)

{
  "code": 0,
  "message": "string",
  "request_id": "string",
  "data": {
    "task_id": "your-task-id",
    "task_status": "succeed",
    "task_status_msg": "string",
    "task_info": {
      "external_task_id": "string"
    },
    "task_result": {
      "result_type": "single",
      "images": [
        {
          "index": 0,
          "url": "string",
          "watermark_url": "string"
        }
      ]
    },
    "watermark_info": {
      "enabled": false
    },
    "final_unit_deduction": "string",
    "created_at": 1722769557708,
    "updated_at": 1722769557708
  }
}

Response Example (Succeeded · Series)

{
  "code": 0,
  "data": {
    "task_id": "your-task-id",
    "task_status": "succeed",
    "task_result": {
      "result_type": "series",
      "series_images": [
        {
          "index": 0,
          "url": "string",
          "watermark_url": "string"
        },
        {
          "index": 1,
          "url": "string",
          "watermark_url": "string"
        }
      ]
    }
  }
}

Field	Description
data.task_result.result_type	`single` or `series`
data.task_result.images[]	Single image result (when `result_type=single`)
data.task_result.series_images[]	Series result (when `result_type=series`)
data.task_result.*.url	Image download URL (anti-hotlink, valid ~30 days)
data.final_unit_deduction	Credits deducted upstream

Task Status

task_status	Meaning
submitted	Submitted
processing	Processing
succeed	Succeeded
failed	Failed

Error Handling

When code != 0, the request fails and message contains the error description. Common cases:

task_id does not exist or has expired
Invalid token or insufficient balance
Content moderation (see task_status=failed and task_status_msg)

After creating a task, poll this endpoint at intervals of 10–30 seconds until task_status becomes succeed or failed. You may also use callback_url to let the gateway notify you on status change.