API Reference
List current account task records
List current account task records within the current credential scope.
Preview guide
Paste into an AI assistant to help with integration. Documentation and examples only; no real credentials.
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) andUSER_ID(account ID) from the environment. In cURL, replaceYOUR_SYSTEM_TOKENandYOUR_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
| Field | Type | Required | Description / constraints |
|---|---|---|---|
| p | integer | No | Page number starting at 1. Example: 1 |
| page_size | integer | No | Page size up to 100; omitted uses the site setting. Example: 10 |
| task_id | string | No | Gateway task ID. |
| request_id | string | No | Request ID. |
| platform | string | No | Platform filter. |
| model_name | string | No | Model filter. |
| status | string | No | Status filter. |
| action | string | No | Action filter. |
| start_timestamp | integer | No | Start Unix seconds. |
| end_timestamp | integer | No | End Unix seconds. |
Response fields
| Field | Type | Description / constraints |
|---|---|---|
| success | boolean | Business success. |
| data.page | integer | Page number. |
| data.page_size | integer | Effective page size. |
| data.total | integer | Matching count. |
| data.items[] | object | Current 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.
兔子API