Authentication Errors

{
  "detail": "Authentication required. Provide Authorization: Bearer <token> header (OAuth 2.1) or X-API-Key header."
}

{
  "detail": "Invalid API key"
}

{
  "detail": "Invalid API key" or "API key has been revoked"
}

# REST API
curl -X POST "https://poe.poesius.com/api/v1/slides/generate-from-doc" \
  -H "X-API-Key: pk_your_api_key_here" \
  -F "document=@document.pdf"

# Python
import requests

headers = {
    "X-API-Key": "pk_your_api_key_here"
}

response = requests.post(
    "https://poe.poesius.com/api/v1/slides/generate-from-doc",
    headers=headers,
    files={"document": open("document.pdf", "rb")}
)

def verify_api_key(api_key):
    """Verify API key is valid"""
    try:
        response = requests.get(
            "https://poe.poesius.com/api/v1/presentations",
            headers={"X-API-Key": api_key},
            params={"limit": 1}
        )
        return response.status_code == 200
    except:
        return False

# Usage
if not verify_api_key(API_KEY):
    print("Invalid API key!")
    exit(1)

import requests

def make_authenticated_request(url, method="GET", api_key=None, **kwargs):
    """Make request with automatic authentication error handling"""
    if not api_key:
        raise ValueError("API key is required")
    
    headers = kwargs.get("headers", {})
    headers["X-API-Key"] = api_key
    kwargs["headers"] = headers
    
    try:
        response = requests.request(method, url, **kwargs)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.HTTPError as e:
        if e.response.status_code == 401:
            raise Exception("Authentication failed. Check your API key.")
        raise