{% extends 'base.html' %}

{% block title %}API Documentation{% endblock %}

{% block content %}
<div class="container mt-4">
    <h1>API Documentation</h1>
    <p class="lead">Programmatic access to Video AI functionality.</p>

    <div class="alert alert-info">
        <strong>Authentication:</strong> All endpoints require authentication via login session or API token (Bearer token in Authorization header).
    </div>

    <h2>Endpoints</h2>

    <div class="endpoint" id="stats">
        <h3>GET /api/stats</h3>
        <p>Get system statistics including CPU, RAM, and GPU information.</p>
        <h4>Curl Example:</h4>
        <pre><code>curl -H "Authorization: Bearer YOUR_API_TOKEN" {{ request.host_url }}api/stats</code></pre>
        <h4>Response:</h4>
        <pre><code>{
  "status": "Idle",
  "gpu_count": 1,
  "gpus": [{"name": "NVIDIA RTX 3080", "memory_used": 0.5, "memory_total": 10.0, "utilization": 0}],
  "cpu_percent": 15.2,
  "ram_used": 4.2,
  "ram_total": 16.0
}</code></pre>
    </div>

    <div class="endpoint" id="analyze">
        <h3>POST /api/analyze</h3>
        <p>Perform media analysis using AI models. Costs 10 tokens (free for admins).</p>
        <h4>Parameters:</h4>
        <ul>
            <li><code>model_path</code> (string, optional): Model to use (default: "Qwen/Qwen2.5-VL-7B-Instruct")</li>
            <li><code>prompt</code> (string, optional): Analysis prompt (default: "Describe this image.")</li>
            <li><code>file_path</code> (string, required): Path to media file</li>
            <li><code>interval</code> (int, optional): Frame interval for video (default: 10)</li>
        </ul>
        <h4>Curl Example:</h4>
        <pre><code>curl -X POST -H "Authorization: Bearer YOUR_API_TOKEN" -H "Content-Type: application/json" -d '{
  "model_path": "Qwen/Qwen2.5-VL-7B-Instruct",
  "prompt": "Describe this video",
  "file_path": "/path/to/video.mp4",
  "interval": 30
}' {{ request.host_url }}api/analyze</code></pre>
        <h4>Response:</h4>
        <pre><code>{
  "result": "Analysis result here...",
  "tokens_used": 10,
  "remaining_tokens": 90
}</code></pre>
    </div>

    <div class="endpoint" id="api_tokens">
        <h3>GET /api/api_tokens</h3>
        <p>List your API tokens.</p>
        <h4>Curl Example:</h4>
        <pre><code>curl -H "Authorization: Bearer YOUR_API_TOKEN" {{ request.host_url }}api/api_tokens</code></pre>
        <h4>Response:</h4>
        <pre><code>{
  "tokens": [
    {"id": 1, "name": "My Token", "created_at": "2024-01-01T00:00:00Z", "last_used": null}
  ]
}</code></pre>
    </div>

</div>
{% endblock %}