Dokumentacija

Per kelias minutes pateikite pirmąją API užklausą.

Prieš pradėdami įsitikinkite, kad tenkinami šie trys reikalavimai.

{
  "text": "Sudėtingas šaltinio turinys pasirinkta kalba.",
  "locale": "lt",
  "mode": "simple-language"
}

Galimi SDK ir cURL pavyzdžiai

Išankstiniai reikalavimai

Aktyvus Scale planas
API raktas
cURL, JavaScript, PHP arba Python. Pateikiame visų keturių variantų pavyzdžius.

1 žingsnis: Pastabokite raktą

export SIMPLE8_API_KEY="replace-with-your-live-key"
export SIMPLE8_API_BASE_URL="https://api.simple8.de"

2 žingsnis: išsiųskite prašymą

Viešoji 2 versijos API suteikia:

POST /api/v2/translate
POST /api/v2/translate/stream
POST /api/v2/jobs
GET /api/v2/jobs/{id}
POST /api/v2/batches
GET /api/v2/batches/{id}

Gamyboje naudokite https://api.simple8.de. Siųskite API raktą kaip nešiklio prieigos raktą iš savo serverio.

curl --request POST \
  --url "$SIMPLE8_API_BASE_URL/api/v2/translate" \
  --header "Authorization: Bearer $SIMPLE8_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "text": "To complete the application, submit a valid identity document.",
    "locale": "en",
    "mode": "simple-language"
  }'

const response = await fetch(`${process.env.SIMPLE8_API_BASE_URL}/api/v2/translate`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SIMPLE8_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    text: "To complete the application, submit a valid identity document.",
    locale: "en",
    mode: "simple-language"
  })
});

const result = await response.json();

if (!response.ok) {
  throw new Error(`${result.error.code}: ${result.error.message}`);
}

console.log(result.output);

<?php

$payload = json_encode([
    "text" => "To complete the application, submit a valid identity document.",
    "locale" => "en",
    "mode" => "simple-language"
]);

$baseUrl = rtrim(getenv("SIMPLE8_API_BASE_URL"), "/");
$request = curl_init($baseUrl . "/api/v2/translate");

curl_setopt_array($request, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("SIMPLE8_API_KEY"),
        "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => $payload
]);

$response = curl_exec($request);
$status = curl_getinfo($request, CURLINFO_HTTP_CODE);
curl_close($request);

if ($status < 200 || $status >= 300) {
    throw new RuntimeException($response);
}

$result = json_decode($response, true);
echo $result["output"];

import os
import requests

base_url = os.environ["SIMPLE8_API_BASE_URL"].rstrip("/")

response = requests.post(
    f"{base_url}/api/v2/translate",
    headers={
        "Authorization": f"Bearer {os.environ['SIMPLE8_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "text": "To complete the application, submit a valid identity document.",
        "locale": "en",
        "mode": "simple-language",
    },
    timeout=30,
)

response.raise_for_status()
print(response.json()["output"])

3 žingsnis: Patikrinkite atsakymą

{
  "requestId": "req_sync_001",
  "locale": "en",
  "mode": "simple-language",
  "output": "Send a valid identity document with your application.",
  "usage": {
    "inputCharacters": 67,
    "cacheHit": false
  }
}

4 žingsnis: bandykite antrąjį režimą

Plain Language ir Easy Language yra skirtingi gaminio režimai. Pasirinkite režimą, kuris tinka žmonėms, kuriuos norite pasiekti.

{
  "text": "To complete the application, submit a valid identity document.",
  "locale": "en",
  "mode": "easy-language"
}

Kitos žingsniai

Pažvelkite į visus palaikytus vietos kodus
Perkabiname pristatymo modelius
Skaityti autentifikavimo gaires
Apdoroti didesnius kiekius su fono užsakymais ir surinkimo prašymais
Programoje sukonfigūruokite „Webhook“ galinį tašką
Peržiūrėkite talpyklą, naudojimą ir atsiskaitymo veiksmus

Šiame puslapyje

Per kelias minutes pateikite pirmąją API užklausą.

Pradėkite naudotis Simple8 nemokamai.