API Reference

Get model pricing

Get model pricing. Fields and permissions follow this gateway implementation.

GET https://api.tu-zi.com/api/pricing

Preview guide

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

# Get model pricing

Get model pricing. Fields and permissions follow this gateway implementation.

## Endpoint and authentication

`GET https://api.tu-zi.com/api/pricing`

Transport: json

Anonymous access is allowed. Authenticated requests may return account-specific data; system tokens require New-Api-User.

## Request parameters

No request body is needed; send the authentication described above.

## Before running

Replace https://api.tu-zi.com with this site origin (do not append /v1 twice), and YOUR_MODEL with the exact marketplace model ID. Install requests for Python; use Node.js 20+ and save JavaScript as .mjs. WebSocket samples list their own dependencies.

Start with a minimal request, then read the result using the response fields below. For async APIs, a returned task ID requires polling; acceptance does not mean generation has finished.

## Code examples

### curl

```bash
curl --request GET 'https://api.tu-zi.com/api/pricing'
```

### python

```python
import json
import os
import requests

url = "https://api.tu-zi.com/api/pricing"
headers = json.loads("{}")
response = requests.request("GET", url, headers=headers, timeout=120)
response.raise_for_status()
result = response.json()
if isinstance(result, dict) and (result.get("success") is False or result.get("error")):
    raise RuntimeError(json.dumps(result, ensure_ascii=False))
print(result)  # Also inspect protocol-specific status/code fields.
```

### javascript

```javascript
// Node.js 20+
const url = "https://api.tu-zi.com/api/pricing";
const headers = {};
const response = await fetch(url, { method: "GET", headers });
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
if (result?.success === false || result?.error) throw new Error(JSON.stringify(result));
console.log(result); // Also inspect protocol-specific status/code fields.
```

## Response fields

| Field | Type | Description / constraints |
| --- | --- | --- |
| success | boolean | Business success. |
| data[] | object | Model prices: ratio, per-request or expression billing. |
| data[].model_name | string | Model name. |
| supported_endpoint | object | Protocol and endpoint definitions. |
| group_ratio | object | Effective group ratios. |
| usable_group | object | Available groups. |
| group_model_pricing | object | Per-group model pricing. |
| schema_version | integer | Response schema version. |

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

```json
{
  "success": true,
  "data": [],
  "supported_endpoint": {},
  "group_ratio": {},
  "usable_group": {}
}
```

## 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.

## Constraints

Anonymous requests return reference pricing; authenticated requests may include account-specific prices. Reference prices are not settlement amounts. The example shows essential fields; additional metadata is present.

## Documentation source

Definition version: 1

Reviewed: 2026-11-02

Source: https://api.tu-zi.com/en/docs/api/reference-model-pricing

This export contains documentation and examples only, without real credentials, account data or user requests.

Updated 2026-11-02 · Reviewed 2026-11-02

Endpoint and authentication

GET https://api.tu-zi.com/api/pricing

Transport: json

Anonymous access is allowed. Authenticated requests may return account-specific data; system tokens require New-Api-User.

Before running

Replace https://api.tu-zi.com with this site origin (do not append /v1 twice), and YOUR_MODEL with the exact marketplace model ID. Install requests for Python; use Node.js 20+ and save JavaScript as .mjs. WebSocket samples list their own dependencies.

Start with a minimal request, then read the result using the response fields below. For async APIs, a returned task ID requires polling; acceptance does not mean generation has finished.

Constraints

Anonymous requests return reference pricing; authenticated requests may include account-specific prices. Reference prices are not settlement amounts. The example shows essential fields; additional metadata is present.

Request parameters

No request body is needed; send the authentication described above.

Response fields

Field	Type	Description / constraints
success	boolean	Business success.
data[]	object	Model prices: ratio, per-request or expression billing.
data[].model_name	string	Model name.
supported_endpoint	object	Protocol and endpoint definitions.
group_ratio	object	Effective group ratios.
usable_group	object	Available groups.
group_model_pricing	object	Per-group model pricing.
schema_version	integer	Response schema version.

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

{
  "success": true,
  "data": [],
  "supported_endpoint": {},
  "group_ratio": {},
  "usable_group": {}
}

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.

Document information and sources

Documentation source

Definition version: 1

Reviewed: 2026-11-02

Source: https://api.tu-zi.com/en/docs/api/reference-model-pricing

This export contains documentation and examples only, without real credentials, account data or user requests.

Request examples

curl --request GET 'https://api.tu-zi.com/api/pricing'

import json
import os
import requests

url = "https://api.tu-zi.com/api/pricing"
headers = json.loads("{}")
response = requests.request("GET", url, headers=headers, timeout=120)
response.raise_for_status()
result = response.json()
if isinstance(result, dict) and (result.get("success") is False or result.get("error")):
    raise RuntimeError(json.dumps(result, ensure_ascii=False))
print(result)  # Also inspect protocol-specific status/code fields.

// Node.js 20+
const url = "https://api.tu-zi.com/api/pricing";
const headers = {};
const response = await fetch(url, { method: "GET", headers });
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
if (result?.success === false || result?.error) throw new Error(JSON.stringify(result));
console.log(result); // Also inspect protocol-specific status/code fields.