Skip to main content
GET
/
eleven
/
tasks
查询任务状态
curl --request GET \
  --url https://api.mountsea.ai/eleven/tasks \
  --header 'Authorization: Bearer <token>'
{
  "taskId": "<string>",
  "status": "pending",
  "result": {},
  "errorMessage": "<string>",
  "errorCode": 123,
  "finishedAt": "2023-11-07T05:31:56Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "traceId": "<string>"
}
All async endpoints (music, plan, video-to-music, stems, upload) return a taskId. Use this endpoint to poll until the task reaches a terminal status (completed, failed, or timeout).

Task Status Values

StatusDescription
pendingTask is queued
readyTask is ready to be processed
assignedTask has been assigned to a worker
processingTask is being processed
completedTask completed — check result for data
failedTask failed — check errorMessage
cancelledTask was cancelled
timeoutTask timed out
Use 3-5 second polling intervals. Music generation typically takes 30-120 seconds depending on track length.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

taskId
string
required

任务ID (eleven-xxxxxxxx-...)

Response

200 - application/json

任务状态

taskId
string
required

任务 ID

status
enum<string>
required

任务状态

Available options:
pending,
ready,
assigned,
processing,
completed,
failed,
cancelled,
timeout
result
object

任务结果(直接透传协议层返回,类型根据任务类型不同而变化)

errorMessage
string

错误信息

errorCode
number

错误代码

finishedAt
string<date-time>

完成时间

createdAt
string<date-time>

创建时间

traceId
string

追踪 ID