모델별 경로
Kling 모델 라우트 작업 가져오기
작업 ID로 Kling 모델 라우트 작업의 상태와 비디오 출력을 가져옵니다.
GET
/
tasks
cURL
task_id="<task_id>"
curl "https://api.cometapi.com/tasks?task_ids=${task_id}" \
-H "Authorization: Bearer $COMETAPI_KEY"import os
import requests
task_id = "<task_id>"
response = requests.get(
"https://api.cometapi.com/tasks",
params={"task_ids": task_id},
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
)
response.raise_for_status()
payload = response.json()
task = payload.get("data", payload)
if isinstance(task, list):
task = task[0]
print(task["status"], task.get("outputs", []))
const taskId = "<task_id>";
const url = new URL("https://api.cometapi.com/tasks");
url.searchParams.set("task_ids", taskId);
const response = await fetch(url, {
headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const payload = await response.json();
const data = payload.data ?? payload;
const task = Array.isArray(data) ? data[0] : data;
console.log(task.status, task.outputs ?? []);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cometapi.com/tasks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.cometapi.com/tasks"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cometapi.com/tasks")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cometapi.com/tasks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"code": 0,
"message": "SUCCEED",
"data": [
{
"id": "<task_id>",
"status": "submitted"
}
]
}Kling 모델 라우트 생성 요청 후 이 엔드포인트를 사용하세요. 생성 응답에서
하나의 작업을 조회하려면
생성 직후 응답에는 제출된 작업이 포함됩니다:
반환된 URL을 사용할 수 있는 기간 이후에도 보관해야 한다면 완료된 비디오를 자체 스토리지에 저장하세요.
data.id을 저장하고 해당 ID를 task_ids로 전달하세요.
요청 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
task_ids | 예 | 모델 라우트 생성 요청에서 반환되는 작업 ID는 data.id. |
<task_id>을 생성 응답의 data.id 값으로 바꾸세요:
task_id="<task_id>"
curl "https://api.cometapi.com/tasks?task_ids=${task_id}" \
-H "Authorization: Bearer $COMETAPI_KEY"
{
"code": 0,
"message": "SUCCEED",
"data": [
{
"id": "<task_id>",
"status": "submitted"
}
]
}
결과 읽기
data[0]에서 작업을 읽고 status이 종료 상태가 될 때까지 계속 쿼리하세요. 상태가 succeeded이면 해당 작업의 outputs 배열에서 비디오 URL을 읽으세요. 관찰된 일부 Comet 호환성 응답은 래핑되지 않은 작업 객체를 반환하거나 최상위 status을 포함합니다. 이는 표준 envelope가 아닌 호환성 형식입니다. data이 있으면 data[0].status을 사용하세요.
완료된 작업의 응답 형식은 다음과 같습니다:
{
"code": 0,
"message": "SUCCEED",
"data": [
{
"id": "<task_id>",
"status": "succeeded",
"outputs": [
{
"type": "video",
"url": "https://media.example.com/video.mp4",
"duration": "5.041"
}
]
}
]
}
| 필드 | 설명 |
|---|---|
id | 생성 응답의 작업 ID입니다. |
status | 현재 작업 상태입니다. 종료 상태에 도달할 때까지 계속 쿼리하세요. |
message | 사용 가능한 경우 반환되는 작업 세부 정보입니다. |
outputs[].type | 출력 미디어 유형입니다. 다음을 포함하는 항목을 선택하세요 type: video. |
outputs[].url | 작업이 성공하면 다운로드하거나 저장할 비디오 URL입니다. |
outputs[].duration | 반환되는 경우 비디오 길이(초)입니다. |
인증
Use your CometAPI API key as a Bearer token.
쿼리 매개변수
Task ID from the data.id field of a creation response. This CometAPI route documents one task_ids value per request.
응답
200 - application/json
The task state and available outputs are returned in the data array.
Canonical task response for the CometAPI route. Read the selected task from data[0]; a bare task object is a compatibility form.
The task record returned for the requested task. The current CometAPI route returns it as data[0].
Required array length:
1 elementShow child attributes
Show child attributes
Response code returned with the task list.
Response message returned with the task list.
Observed Comet compatibility response-level status when returned. Read the selected task state from data[0].status.
Request ID for support when returned.
마지막 수정일 2026년 9월 25일
⌘I
cURL
task_id="<task_id>"
curl "https://api.cometapi.com/tasks?task_ids=${task_id}" \
-H "Authorization: Bearer $COMETAPI_KEY"import os
import requests
task_id = "<task_id>"
response = requests.get(
"https://api.cometapi.com/tasks",
params={"task_ids": task_id},
headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
)
response.raise_for_status()
payload = response.json()
task = payload.get("data", payload)
if isinstance(task, list):
task = task[0]
print(task["status"], task.get("outputs", []))
const taskId = "<task_id>";
const url = new URL("https://api.cometapi.com/tasks");
url.searchParams.set("task_ids", taskId);
const response = await fetch(url, {
headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const payload = await response.json();
const data = payload.data ?? payload;
const task = Array.isArray(data) ? data[0] : data;
console.log(task.status, task.outputs ?? []);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.cometapi.com/tasks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.cometapi.com/tasks"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cometapi.com/tasks")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cometapi.com/tasks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"code": 0,
"message": "SUCCEED",
"data": [
{
"id": "<task_id>",
"status": "submitted"
}
]
}