API GenPosts

lockAuthentification

Toutes les demandes nécessitent votre clé API dans l'en-tête d'autorisation.

Authorization: Bearer YOUR_API_KEY

Vous pouvez utilisez également l'en-tête X-Api-Key: YOUR_API_KEY

apiEndpoints

Méthode	Endpoint	Description
POST	`/generate`	Générer du contenu avec un outil et renvoie le résultat.
GET	`/tools`	Liste les outils disponibles et leurs champs.
GET	`/me`	Renvoie votre compte : solde de mots/crédits, plan et limite de demande.

terminalExemple : générer du contenu

Envoie l'outil et ses champs ; Elle est facturée aux paroles produites.

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);

tuneChamps de l'article

Champs acceptés par l'outil "article" dans "fields". Seul le « titre » est requis ; les autres sont facultatifs.

Champ	Type	Obligatoire	Valeurs prises en charge
`title`	text	✓	—
`keywords`	text	—	—
`article_type`	select	—	`blog_post`, `guide`, `comparison`, `review`, `tutorial`, `listicle`, `pillar_page`, `case_study`
`intent`	select	—	`informational`, `commercial`, `transactional`
`note`	textarea	—	—
`tone`	select	—	`professional`, `casual`, `friendly`, `persuasive`, `informative`, `authoritative`, `humorous`, `inspirational`, `formal`, `conversational`
`length`	select	—	`1000`, `2000`, `3000`

Interrogez les champs de n'importe quel outil avec GET /tools.

data_objectRéponse

L'API renvoie JSON avec le résultat et les mots consommés.

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

errorErreurs

Code	Signification
`401`	Clé API manquante ou non valide.
`402`	Il ne vous reste pas assez de mots.
`403`	Votre forfait ne permet pas l'accès à l'API.
`422`	Paramètres manquants ou non valides.
`429`	Trop de demandes ; attendez un instant.