API Prompt Optimizera

Zamień surową myśl w gotowy, zoptymalizowany prompt jednym zapytaniem HTTP. Ten sam silnik co interaktywny edytor - bez przeklikiwania wywiadu.

PRO Dostęp przez klucz API. Spec maszynowy: openapi.json

Uwierzytelnianie

Każde zapytanie wymaga nagłówka X-API-Key z Twoim kluczem. Klucze generujesz i odwołujesz w panelu konta: Konto -> Klucze API. Klucz pokazujemy tylko raz przy tworzeniu - zapisz go bezpiecznie.

X-API-Key: sk_twoj_klucz_api

Klucz daje dostęp do Twojego konta i zużywa Twój miesięczny limit generacji. Nie umieszczaj go w kodzie front-end ani w repozytorium.

Endpoint

POST https://sukcesai.com/optimizer/api/v1/optimize.php

Generuje zoptymalizowany prompt z surowego opisu. Zużywa jedną generację z miesięcznego limitu konta (tak samo jak w edytorze).

Parametry (JSON body)

Pole	Typ	Wymagane	Opis
`input`	string	tak	Surowa myśl / opis czego potrzebujesz (max 5000 znaków). Alias: `raw_thoughts`.
`answers`	object	nie	Opcjonalne doprecyzowanie (ton, długość, odbiorca).
`preset`	string	nie	Opcjonalny preset (slug lub ID) zawężający styl.

Odpowiedź 200

{
  "prompt": "=== ROLA I CEL ===\n...",
  "run_id": 1129,
  "model": "gpt-4o-mini",
  "tokens_used": 4415,
  "cost_usd": 0.001013,
  "usage": { "requests_today": 3, "requests_month": 42 }
}

Kody błędów

Kod	error	Znaczenie
`401`	`unauthorized`	Brak lub nieprawidłowy klucz API.
`403`	`limit_exceeded`	Przekroczony miesięczny limit generacji.
`422`	`invalid_input`	Brak pola `input` lub złe dane.
`429`	`rate_limit_exceeded`	Za dużo zapytań (limit 20/min).
`502`	`generation_failed`	Błąd generacji po stronie modelu - powtórz.

Przykłady

curl -X POST https://sukcesai.com/optimizer/api/v1/optimize.php \
  -H "X-API-Key: sk_twoj_klucz_api" \
  -H "Content-Type: application/json" \
  -d '{"input":"post na LinkedIn o premierze naszego narzedzia AI dla marketerow"}'

const res = await fetch("https://sukcesai.com/optimizer/api/v1/optimize.php", {
  method: "POST",
  headers: {
    "X-API-Key": "sk_twoj_klucz_api",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ input: "post na LinkedIn o premierze narzedzia AI" })
});
const data = await res.json();
console.log(data.prompt);

import requests

res = requests.post(
    "https://sukcesai.com/optimizer/api/v1/optimize.php",
    headers={"X-API-Key": "sk_twoj_klucz_api"},
    json={"input": "post na LinkedIn o premierze narzedzia AI"},
)
res.raise_for_status()
print(res.json()["prompt"])

Limity

Tempo: do 20 zapytań na minutę na adres IP. Wolumen: liczy się do Twojego miesięcznego limitu generacji wspólnie z edytorem - widocznego w panelu konta. Licznik zapytań per-klucz (dzienny i miesięczny) widzisz na liście kluczy.

Uwagi

Endpoint przyjmuje również sesję zalogowaną (cookie + token CSRF) - przydatne do wywołań z własnego front-endu na tej samej domenie. Dla integracji serwerowych używaj klucza API.