Hurtig start
Lav din første API-anmodning om et par minutter.
Brug din konto, en privat API-nøgle, en understøttet output-lokalitet og en af de to sprogtilstande.
{
"text": "Kompleks kildeindhold på det valgte sprog.",
"locale": "da",
"mode": "simple-language"
}Eksempler på SDK og cURL tilgængelige
Forudsætninger
- En gratis eller betalt Simple8-konto med en bekræftet e-mailadresse
- En aktiv API-nøgle oprettet i applikationen
- cURL eller en af de eksempelvise køretider
- Det offentlige, ikke-fortrolige testindhold
Trin 1: Sæt nøglen
export SIMPLE8_API_KEY="replace-with-your-sandbox-key"
export SIMPLE8_API_BASE_URL="https://api.simple8.de"Trin 2: Send anmodningen
Den offentlige version 2 API giver:
- 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}
Brug https://api.simple8.de i produktionen. Send API-nøglen som et bærer-token fra din server.
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"])Trin 3: Undersøg svaret
{
"requestId": "req_sync_001",
"locale": "en",
"mode": "simple-language",
"output": "Send a valid identity document with your application.",
"usage": {
"inputCharacters": 67,
"cacheHit": false
}
}Trin 4: Prøv anden modus
Almindeligt sprog og let sprog er forskellige produkttilstande. Vælg den tilstand, der passer til de personer, du vil nå ud til.
{
"mode": "easy-language"
}Næste trin
- Se alle støttede lokalkoder
- Sammenlign leveringsmønstre
- Læs vejledning om autentisering
- Opret job og batches til større arbejdsgange
- Konfigurer et webhook-slutpunkt i applikationen
- Gennemgå cache, brug og faktureringsadfærd