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