apiREST API

GenPosts API

Integrieren Sie die GenPosts-Inhaltsgenerierung in Ihre Apps, Skripte und Automatisierungen.

Basis-URL https://genposts.app/api/v1

keyHolen Sie sich einen Schlüssel codeSiehe Beispiele

lockAuthentifizierung

Alle Anfragen erfordern Ihren API-Schlüssel im Autorisierungsheader.

Authorization: Bearer YOUR_API_KEY

Sie können auch den Header verwenden X-Api-Key: YOUR_API_KEY

apiEndpunkte

Methode	Endpoint	Beschreibung
POST	`/generate`	Generieren Sie Inhalte mit einem Tool und geben Sie das Ergebnis zurück.
GET	`/tools`	Listet die verfügbaren Tools und ihre auf Felder.
GET	`/me`	Gibt Ihr Konto zurück: Wort-/Kreditsaldo, Plan und Anforderungslimit.

terminalBeispiel: generieren ab content

Sendet das Tool und seine Felder; Es werden die produzierten Wörter in Rechnung gestellt.

curl -X POST https://genposts.app/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"article","fields":{"title":"Guía de email marketing","keywords":"email marketing, automatización","article_type":"guide","intent":"informational","tone":"professional","length":"2000"},"language":"es"}'

import requests

r = requests.post(
    "https://genposts.app/api/v1/generate",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"tool": "article",
          "fields": {"title": "Guía de email marketing",
                     "keywords": "email marketing, automatización",
                     "article_type": "guide", "intent": "informational",
                     "tone": "professional", "length": "2000"},
          "language": "es"},
)
print(r.json())

const res = await fetch("https://genposts.app/api/v1/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    tool: "article",
    fields: { title: "Guía de email marketing", keywords: "email marketing",
             article_type: "guide", intent: "informational",
             tone: "professional", length: "2000" },
    language: "es",
  }),
});
console.log(await res.json());

$ch = curl_init("https://genposts.app/api/v1/generate");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "tool"     => "article",
        "fields"   => ["title" => "Guía de email marketing", "keywords" => "email marketing",
                       "article_type" => "guide", "intent" => "informational",
                       "tone" => "professional", "length" => "2000"],
        "language" => "es",
    ]),
]);
echo curl_exec($ch);

tuneFelder des Artikels

Vom „Artikel“-Tool akzeptierte Felder in „Felder“. Es ist nur „Titel“ erforderlich; Der Rest ist optional.

Feld	Typ	Obligatorisch	Unterstützten Werten
`title`	text	✓	—
`keywords`	text	—	—
`article_type`	select	—	`guide`, `review`, `listicle`, `tutorial`, `blog_post`, `case_study`, `comparison`, `pillar_page`
`intent`	select	—	`commercial`, `informational`, `transactional`
`note`	textarea	—	—
`tone`	select	—	`casual`, `formal`, `friendly`, `humorous`, `persuasive`, `informative`, `professional`, `authoritative`, `inspirational`, `conversational`
`length`	select	—	`1000`, `2000`, `3000`

Fragen Sie die Felder eines beliebigen Tools mit GET /tools.

data_objectAntwort

Die API gibt JSON mit dem Ergebnis und den verbrauchten Wörtern zurück.

{
  "ok": true,
  "tool": "article",
  "result": "<h1>…</h1>",
  "words_used": 1240,
  "words_balance": 8760,
  "generation_id": 482
}

errorFehler

Code	Bedeutung
`401`	Fehlender oder ungültiger API-Schlüssel.
`402`	Sie haben nicht genügend Wörter übrig.
`403`	Ihr Plan erlaubt keinen Zugriff auf die API.
`422`	Fehlende oder ungültige Parameter.
`429`	Zu viele Anfragen; Warte einen Moment.