API Reference

List current account task records

List current account task records within the current credential scope.

GET https://api.tu-zi.com/api/task/self
Preview guide

Paste into an AI assistant to help with integration. Documentation and examples only; no real credentials.

Preview guide

List current account task records

Updated · Reviewed

Endpoint and authentication

GET https://api.tu-zi.com/api/task/self

Transport: json

Use an account system token and New-Api-User (account ID), or a valid site login session. Manage system tokens in account settings. Inference API keys are not substitutes; keep system tokens out of frontend code.

Authorization: Bearer YOUR_SYSTEM_TOKEN
New-Api-User: YOUR_USER_ID

Before calling

  • Examples use this site's address. For another gateway, replace only the site address and keep the full endpoint path.
  • Python / JavaScript read SYSTEM_TOKEN (account system token) and USER_ID (account ID) from the environment. In cURL, replace YOUR_SYSTEM_TOKEN and YOUR_USER_ID.

Constraints

This lists stored account task records and does not actively refresh upstream tasks. Use the corresponding model retrieval endpoint for task results.

Query parameters

FieldTypeRequiredDescription / constraints
pintegerNoPage number starting at 1. Example: 1
page_sizeintegerNoPage size up to 100; omitted uses the site setting. Example: 10
task_idstringNoGateway task ID.
request_idstringNoRequest ID.
platformstringNoPlatform filter.
model_namestringNoModel filter.
statusstringNoStatus filter.
actionstringNoAction filter.
start_timestampintegerNoStart Unix seconds.
end_timestampintegerNoEnd Unix seconds.

Response fields

FieldTypeDescription / constraints
successbooleanBusiness success.
data.pageintegerPage number.
data.page_sizeintegerEffective page size.
data.totalintegerMatching count.
data.items[]objectCurrent page records.

Illustrative response; some endpoints show essential fields only. Optional fields may be absent.

{
  "success": true,
  "data": {
    "page": 1,
    "page_size": 10,
    "total": 0,
    "items": []
  }
}

Errors and retries

Check HTTP status and success. Business validation errors may return HTTP 200 with {"success":false,"message":"..."}; some include error.code. Authentication may return 401/403 and rate limiting 429. HTTP 200 alone does not guarantee success.

Use bounded exponential backoff for reads. Do not blindly retry task creation, generation, or key mutations, to avoid duplicate billing or execution.