Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
Ringkasan

Gunakan DELETE /v1/tasks/{id} untuk membatalkan task asinkron yang belum mulai berjalan. Gunakan task ID yang sama dari respons create atau dari poll_url.

​
Task yang didukung

Pembatalan saat ini didukung untuk task video Volcengine Seedance yang masih antre dengan seedance-1.5-pro, seedance-2.0, atau seedance-2.0-fast. Task yang sudah processing/running tidak dapat dibatalkan. Task yang selesai, gagal, kedaluwarsa, atau tidak didukung tetap dapat ditanyakan untuk rekonsiliasi status dan billing, bukan menghapus record upstream.

​
Parameter path

​
id
string
wajib
Async task ID yang dikembalikan oleh permintaan create atau tertanam di poll_url.

​
Respons

​
id
string
Identifier async task kanonis.
​
task_id
string
Alias identifier async task.
​
poll_url
string
Polling URL yang disarankan untuk task. Tetap valid setelah pembatalan.
​
status
string
Status task. Task yang berhasil dibatalkan dikembalikan sebagai failed dengan cancelled: true agar kompatibel dengan nilai status yang ada.
​
cancelled
boolean
true ketika task dibatalkan sebelum eksekusi.
​
cancellation_status
string
Penanda pembatalan. Nilainya cancelled ketika pembatalan berhasil.
​
error
string
Alasan pembatalan atau pesan kegagalan task.

​
Perilaku error

400 unsupported_task_cancel berarti tipe task, provider, atau model tidak mendukung pembatalan. 409 task_not_cancellable berarti task sudah diproses, sudah terminal, atau tidak lagi dapat dibatalkan. 403 berarti API key tidak dapat mengakses task.

​
Contoh

curl -X DELETE "https://api.lemondata.cc/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "failed",
  "cancelled": true,
  "cancellation_status": "cancelled",
  "error": "Task cancelled before execution"
}