Quickstart

The vizvuz API has one job: you send text, it sends the translation back. There is no session to establish, no job to poll and no SDK you have to install. A single POST is the whole integration.

1. Get a key

Create an account, confirm your e-mail address and open API keys in the dashboard. Every verified account starts with 100,000 characters of credit, so you do not need a payment method to finish this page.

A key looks like this:

vz_live_8Kq2xR7pLmN4vT1cW9sB3dF6gH0jY5uA2eZ8nQ4r

The key is shown once, at creation time. We store only its SHA-256 hash, so we cannot recover it for you — if you lose it, rotate it.

Keys come in two modes. vz_test_… keys translate for real and consume the same quota as live keys; the only difference is the prefix, so you can tell staging traffic from production traffic in your usage reports.

2. Send a request

curl -X POST https://api.vizvuz.com/v1/translate \
  -H "Authorization: Bearer vz_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
        "text": ["Hello world", "How are you?"],
        "target_lang": "DE"
      }'

3. Read the response

{
  "translations": [
    { "detected_source_language": "EN", "text": "Hallo Welt" },
    { "detected_source_language": "EN", "text": "Wie geht es dir?" }
  ],
  "request_id": "01J8ZC4M9XK3P7QW2NRT5V6YAB",
  "characters": 23
}

translations comes back in the same order as the text array you sent, always. characters is what we billed, and the same number is in the X-Characters-Billed response header.

4. Check what it cost

curl https://api.vizvuz.com/v1/usage \
  -H "Authorization: Bearer vz_live_xxxxxxxx"

{
  "character_count": 23,
  "character_limit": 100000,
  "billing": {
    "mode": "credit",
    "plan": "payg",
    "currency": "EUR",
    "period_end": null,
    "overage_characters": 0,
    "credit_balance": "1.499655"
  }
}

What to read next

• Authentication — the two accepted header formats and how

to rotate keys without downtime.

• Translate — every parameter of the main endpoint.
• Errors — the stable error codes and what to do about each one.

Rules worth knowing up front

• Up to 50 texts per request.
• Up to 50,000 characters per request on Pay as you go, 100,000 on Starter and

200,000 on Business.

• Characters are counted with every space, line break and markup character

included — exactly what you sent.

• Every response carries X-Request-Id. Quote it when you contact support.