Zurück zur Startseite

API-Dokumentation

Integriere TextNova AI in deine eigenen Anwendungen

Übersicht

Die TextNova AI API ermöglicht es dir, KI-gestützte Textgenerierung direkt in deine Anwendungen, Workflows und Automatisierungen zu integrieren. Die API ist exklusiv für Nutzer mit dem Business-Plan verfügbar.

Authentifizierung

Bearer Token via API-Schlüssel

Format

JSON Request & Response

Rate Limit

60 Anfragen / Minute

Basis-URL
https://www.textnova.de/api/v1
Authentifizierung
Alle API-Anfragen erfordern einen gültigen API-Schlüssel im Authorization-Header.
Authorization: Bearer tn_dein_api_schluessel_hier
POST
/v1/generate
Generiert einen Text basierend auf den angegebenen Parametern.

Request Body (JSON)

ParameterTypPflichtBeschreibung
textTypestringJaproduktbeschreibung, blogartikel, social-media, email, werbeanzeige
contextstringJaKontext oder Thema des Textes (max. 5000 Zeichen)
keywordsstringNeinSchlüsselwörter, kommagetrennt
tonestringNeinprofessionell, kreativ, freundlich, ueberzeugend, informativ
languagestringNeinde (Standard), en, fr, es

Beispiel-Anfrage (cURL)

curl -X POST https://www.textnova.de/api/v1/generate \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tn_dein_api_schluessel" \
  -d '{
    "textType": "produktbeschreibung",
    "context": "Premium Bluetooth Kopfhörer mit Noise Cancelling",
    "keywords": "kabellos, ANC, Musikgenuss",
    "tone": "ueberzeugend",
    "language": "de"
  }'

Beispiel-Antwort

{
  "success": true,
  "data": {
    "id": 42,
    "textType": "produktbeschreibung",
    "language": "de",
    "generatedText": "Erleben Sie Musik in einer neuen Dimension...",
    "createdAt": "2026-02-24T12:00:00.000Z"
  }
}
GET
/v1/usage
Gibt die aktuelle Nutzungsstatistik zurück.
{
  "success": true,
  "data": {
    "plan": "business",
    "todayGenerations": 15,
    "limit": null
  }
}
GET
/v1/text-types, /v1/languages, /v1/tones
Listet die verfügbaren Texttypen, Sprachen und Tonalitäten auf. Keine Authentifizierung erforderlich.
GET /api/v1/text-types
GET /api/v1/languages
GET /api/v1/tones
Fehlercodes
HTTP-CodeFehlerBeschreibung
400bad_requestFehlende oder ungültige Parameter
401unauthorizedFehlender API-Schlüssel
403forbiddenUngültiger Schlüssel oder kein Business-Plan
429rate_limitedZu viele Anfragen (max. 60/min)
500internal_errorServerfehler bei der Generierung
Beispiel: Python
import requests

API_KEY = "tn_dein_api_schluessel"
BASE_URL = "https://www.textnova.de/api/v1"

response = requests.post(
    f"{BASE_URL}/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "textType": "blogartikel",
        "context": "Die Zukunft der KI im Marketing",
        "tone": "informativ",
        "language": "de"
    }
)

data = response.json()
print(data["data"]["generatedText"])
Beispiel: JavaScript / Node.js
const API_KEY = "tn_dein_api_schluessel";
const BASE_URL = "https://www.textnova.de/api/v1";

const response = await fetch(`${BASE_URL}/generate`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${API_KEY}`,
  },
  body: JSON.stringify({
    textType: "email",
    context: "Einladung zum Webinar über KI-Tools",
    tone: "freundlich",
    language: "de",
  }),
});

const data = await response.json();
console.log(data.data.generatedText);

Cookie-Einstellungen

Wir verwenden technisch notwendige Cookies, um die Funktionalität unserer Website sicherzustellen, sowie optionale Analyse-Cookies zur Verbesserung unseres Angebots. Weitere Informationen findest du in unserer Datenschutzerklärung.