API GenPosts

lockAutenticação

Todas as solicitações exigem sua chave de API no cabeçalho de autorização.

Authorization: Bearer YOUR_API_KEY

Você também pode usar o cabeçalho X-Api-Key: YOUR_API_KEY

apiEndpoints

Método	Endpoint	Descrição
POST	`/generate`	Gera conteúdo com uma ferramenta e retorna o resultado.
GET	`/tools`	Lista as ferramentas disponíveis e seus campos.
GET	`/me`	Retorna sua conta: saldo de palavra/crédito, plano e limite de solicitação.

terminalExemplo: gerar conteúdo

Envia a ferramenta e seus campos; É cobrado pelas palavras produzidas.

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

tuneCampos de artigo

Campos aceitos pela ferramenta "artigo" em "campos". Apenas “título” é obrigatório; o restante é opcional.

Campo	Tipo	Obrigatório	Valores suportados
`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`

Consulte os campos de qualquer ferramenta com GET /tools.

data_objectResposta

A API retorna JSON com o resultado e as palavras consumidas.

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

errorErros

Código	Significado
`401`	Chave de API ausente ou inválida.
`402`	Você não tem palavras suficientes.
`403`	Seu plano não permite acesso à API.
`422`	Parâmetros ausentes ou inválidos.
`429`	Muitas solicitações; espere um momento.