← Documentation home

FAQ and Troubleshooting

FAQ

  • Which Base URL should I use?

OpenAI-compatible clients use https://www.zltokens.com/v1. Only use https://www.zltokens.com/v1/chat/completions when the tool explicitly asks for the full chat endpoint. Do not omit /v1.

  • Where do I get the API Key?

The Key is provided after service activation or created on the API Key page. API Key lists are masked. A signed-in owner can retrieve the full Key from the API Key page when needed; keep it secure and rotate it immediately if exposed. Use separate Keys for separate services, devices, or clients when possible.

  • Should I use platform model names or upstream names?

Use public platform model names. They may differ from upstream model names. If an administrator renames a model, clients must use the renamed public name.

  • Why is the model list empty?

Check login status, account quota, model enablement, channel mapping, model pricing, and whether the account or API Key is restricted from using the model.

  • Where can I find API errors and troubleshooting?

For status-specific actions, streaming failures, timeouts, and the safe support checklist, see [API errors and troubleshooting](/en/docs/api-errors-and-troubleshooting).

  • What does unpriced model mean?

The public model has no executable price yet. The platform blocks real calls for unpriced models to avoid unauditable deductions; ask an administrator to configure pricing first.

  • Why is usage higher than expected?

Check prompt tokens, completion tokens, cached tokens, media tokens, model name, and request time in usage logs. Coding clients often attach project context, files, or images automatically.

  • How are images and videos billed?

They follow administrator pricing. Images, audio, and videos may be billed by tokens, requests, seconds, resolution, quality tier, or expression rules.

  • Which price wins when customer prices conflict with normal pricing?

Customer model prices win over global model pricing. Normal model pricing and Tidal rules apply only when no customer price matches.

  • What are Tidal Tokens?

Tidal Tokens are model-specific multiplier rules for a daily time window. The current UI has no weekday selector, so an enabled rule applies every day during its configured time window. Disabled or unmatched rules do not affect billing.

  • Where are invoices handled?

Customers submit and view invoice information in Wallet or Invoices. Administrators review and register invoices in the backend. Actual invoice rules follow orders, contracts, or mutual agreements.

  • What should I provide when troubleshooting or contacting support?

Use the checklist in [API errors and troubleshooting](/en/docs/api-errors-and-troubleshooting). Do not send a complete API Key, password, or unnecessary business data.