Skip to main content
GET
/
v1
/
task
/
{task_id}
Get Task Status
curl --request GET \
  --url https://apis.finevoice.ai/v1/task/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "status": 123,
  "url": "https://cdn.finevoice.ai/output/result.mp3",
  "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "urls": [
    "<string>"
  ],
  "service": "<string>",
  "port": "<string>",
  "timestamp": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer token (API key). Format: Bearer {your_api_key}

Path Parameters

​
task_id
string
required

The task identifier returned by a previous API call.

Response

Task status and result.

Response for task status polling.

​
status
integer<int32>

HTTP-style status code (200 for completed, 202 for in-progress).

​
url
string

Download URL of the result.

Example:

"https://cdn.finevoice.ai/output/result.mp3"

​
taskId
string

Task identifier.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
error
object
​
urls
string[]

Multiple output URLs.

​
service
string
​
port
string
​
timestamp
string