{% extends 'base.html' %}

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

{% block head %}
<style>
.container { max-width: 1200px; margin: 2rem auto; padding: 0 2rem; }
.api-header {
    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
    color: white;
    padding: 2rem;
    border-radius: 12px;
    margin-bottom: 2rem;
    box-shadow: 0 4px 6px rgba(0, 0, 0, 0.07);
}

.api-header h1 {
    font-size: 3rem;
    font-weight: 700;
    margin-bottom: 1rem;
}

.api-header .lead {
    font-size: 1.25rem;
    opacity: 0.9;
}

.endpoint-card {
    background: white;
    border-radius: 12px;
    box-shadow: 0 4px 6px rgba(0, 0, 0, 0.07);
    border: 1px solid #e5e7eb;
    margin-bottom: 2rem;
    overflow: hidden;
    transition: transform 0.2s ease, box-shadow 0.2s ease;
}

.endpoint-card:hover {
    transform: translateY(-2px);
    box-shadow: 0 8px 25px rgba(0, 0, 0, 0.15);
}

.endpoint-header {
    background: linear-gradient(135deg, #10b981 0%, #059669 100%);
    color: white;
    padding: 1.5rem;
    border-bottom: 1px solid #e5e7eb;
}

.endpoint-header h3 {
    margin: 0;
    font-size: 1.5rem;
    font-weight: 600;
}

.endpoint-header .method {
    display: inline-block;
    background: rgba(255, 255, 255, 0.2);
    padding: 0.25rem 0.75rem;
    border-radius: 20px;
    font-size: 0.875rem;
    font-weight: 500;
    margin-right: 1rem;
}

.endpoint-content {
    padding: 1.5rem;
}

.endpoint-description {
    color: #6b7280;
    margin-bottom: 1.5rem;
    font-size: 1.1rem;
    line-height: 1.6;
}

.params-section h4,
.curl-section h4,
.response-section h4 {
    color: #374151;
    font-weight: 600;
    margin-bottom: 0.75rem;
    font-size: 1.1rem;
}

.params-list {
    background: #f8fafc;
    border-radius: 8px;
    padding: 1rem;
    margin-bottom: 1.5rem;
}

.param-item {
    margin-bottom: 0.75rem;
    padding-bottom: 0.75rem;
    border-bottom: 1px solid #e5e7eb;
}

.param-item:last-child {
    border-bottom: none;
    margin-bottom: 0;
    padding-bottom: 0;
}

.param-name {
    font-weight: 600;
    color: #667eea;
    font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
}

.param-type {
    color: #059669;
    font-size: 0.875rem;
    margin-left: 0.5rem;
}

.param-desc {
    color: #6b7280;
    margin-top: 0.25rem;
}

.code-block {
    background: #1f2937;
    color: #f9fafb;
    border-radius: 8px;
    padding: 1rem;
    font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
    font-size: 0.875rem;
    line-height: 1.5;
    overflow-x: auto;
    margin-bottom: 1.5rem;
}

.code-block .token {
    color: #60a5fa;
}

.auth-notice {
    background: linear-gradient(135deg, #fef3c7 0%, #fde68a 100%);
    border: 1px solid #f59e0b;
    border-radius: 8px;
    padding: 1.5rem;
    margin-bottom: 2rem;
}

.auth-notice .alert-icon {
    color: #d97706;
    font-size: 1.5rem;
    margin-right: 0.75rem;
}

.auth-notice strong {
    color: #92400e;
}

.auth-notice p {
    color: #78350f;
    margin: 0;
}

@media (max-width: 768px) {
    .api-header h1 {
        font-size: 2rem;
    }

    .endpoint-card {
        margin-bottom: 1.5rem;
    }

    .endpoint-header {
        padding: 1rem;
    }

    .endpoint-content {
        padding: 1rem;
    }
}
</style>
{% endblock %}

{% block content %}
<div class="container">
    <div class="api-header">
        <h1><i class="fas fa-code"></i> API Documentation</h1>
        <p class="lead">Programmatic access to Video AI functionality</p>
    </div>
    <div class="auth-notice">
        <div class="d-flex align-items-start">
            <i class="fas fa-shield-alt alert-icon"></i>
            <div>
                <strong>Authentication Required</strong>
                <p>All endpoints require authentication via login session or API token (Bearer token in Authorization header).</p>
            </div>
        </div>
    </div>

    <div class="row">
        <div class="col-12">
            <div class="endpoint-card" id="stats">
                <div class="endpoint-header">
                    <span class="method">GET</span>
                    <h3>/api/stats</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-chart-bar text-success"></i>
                        Get real-time system statistics including CPU usage, RAM consumption, and GPU information.
                    </p>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Example</h4>
                        <div class="code-block">curl -H "Authorization: Bearer YOUR_API_TOKEN" {{ request.host_url }}api/stats</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response</h4>
                        <div class="code-block">{
  "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
}</div>
                    </div>
                </div>
            </div>

            <div class="endpoint-card" id="analyze">
                <div class="endpoint-header">
                    <span class="method">POST</span>
                    <h3>/api/analyze</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-brain text-primary"></i>
                        Perform AI-powered media analysis using advanced language models. Costs 10 tokens (free for admins).
                    </p>

                    <div class="params-section">
                        <h4><i class="fas fa-cogs"></i> Parameters</h4>
                        <div class="params-list">
                            <div class="param-item">
                                <span class="param-name">model_path</span>
                                <span class="param-type">string (optional)</span>
                                <div class="param-desc">AI model to use (default: "Qwen/Qwen2.5-VL-7B-Instruct")</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">prompt</span>
                                <span class="param-type">string (optional)</span>
                                <div class="param-desc">Analysis prompt (default: "Describe this image.")</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">file</span>
                                <span class="param-type">file upload (required*)</span>
                                <div class="param-desc">Media file to upload and analyze</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">file_path</span>
                                <span class="param-type">string (admin only)</span>
                                <div class="param-desc">Path to existing media file on server (admin users only)</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">interval</span>
                                <span class="param-type">integer (optional)</span>
                                <div class="param-desc">Frame sampling interval for videos (default: 10)</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">upload_id</span>
                                <span class="param-type">string (optional)</span>
                                <div class="param-desc">Unique identifier for chunked uploads</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">chunk_number</span>
                                <span class="param-type">integer (optional)</span>
                                <div class="param-desc">Current chunk number (0-based) for chunked uploads</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">total_chunks</span>
                                <span class="param-type">integer (optional)</span>
                                <div class="param-desc">Total number of chunks for chunked uploads</div>
                            </div>
                            <div class="param-item">
                                <span class="param-name">filename</span>
                                <span class="param-type">string (optional)</span>
                                <div class="param-desc">Original filename for chunked uploads</div>
                            </div>
                        </div>
                        <div class="alert alert-info" style="margin-top: 1rem; padding: 0.75rem; background: #dbeafe; border: 1px solid #93c5fd; border-radius: 6px;">
                            <i class="fas fa-info-circle" style="color: #2563eb;"></i>
                            <strong style="color: #1e40af;">Note:</strong> Either <code>file</code> upload or <code>file_path</code> (admin only) must be provided. Chunked uploads are supported for large files.
                        </div>
                    </div>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Examples</h4>
                        <h5>File Upload:</h5>
                        <div class="code-block">curl -X POST -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "model_path=Qwen/Qwen2.5-VL-7B-Instruct" \
  -F "prompt=Describe this video" \
  -F "interval=30" \
  -F "file=@/path/to/video.mp4" \
  {{ request.host_url }}api/analyze</div>

                        <h5 style="margin-top: 1rem;">File Path (Admin Only):</h5>
                        <div class="code-block">curl -X POST -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -F "model_path=Qwen/Qwen2.5-VL-7B-Instruct" \
  -F "prompt=Describe this video" \
  -F "file_path=/server/path/to/video.mp4" \
  -F "interval=30" \
  {{ request.host_url }}api/analyze</div>

                        <h5 style="margin-top: 1rem;">Chunked Upload:</h5>
                        <div class="code-block"># Upload file in chunks (useful for large files)
# First chunk
curl -X POST -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "upload_id=my_upload_123" \
  -F "chunk_number=0" \
  -F "total_chunks=3" \
  -F "filename=large_video.mp4" \
  -F "file=@chunk_0.mp4" \
  {{ request.host_url }}api/analyze

# Second chunk
curl -X POST -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "upload_id=my_upload_123" \
  -F "chunk_number=1" \
  -F "total_chunks=3" \
  -F "filename=large_video.mp4" \
  -F "file=@chunk_1.mp4" \
  {{ request.host_url }}api/analyze

# Final chunk (triggers analysis)
curl -X POST -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "upload_id=my_upload_123" \
  -F "chunk_number=2" \
  -F "total_chunks=3" \
  -F "filename=large_video.mp4" \
  -F "model_path=Qwen/Qwen2.5-VL-7B-Instruct" \
  -F "prompt=Describe this video" \
  -F "file=@chunk_2.mp4" \
  {{ request.host_url }}api/analyze</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response</h4>
                        <div class="code-block">{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "accepted",
  "message": "Analysis job queued successfully",
  "tokens_used": 10,
  "remaining_tokens": 90
}</div>
                        <p style="margin-top: 1rem; color: #6b7280; font-size: 0.9rem;">
                            <strong>Note:</strong> Use the returned <code>job_id</code> with <code>/api/result/{job_id}</code> to check job status and get results.
                        </p>
                    </div>
                </div>
            </div>

            <div class="endpoint-card" id="result">
                <div class="endpoint-header">
                    <span class="method">GET</span>
                    <h3>/api/result/{job_id}</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-tasks text-info"></i>
                        Check the status and get results of an analysis job. Use the job_id returned from /api/analyze.
                    </p>

                    <div class="params-section">
                        <h4><i class="fas fa-cogs"></i> URL Parameters</h4>
                        <div class="params-list">
                            <div class="param-item">
                                <span class="param-name">job_id</span>
                                <span class="param-type">string (required)</span>
                                <div class="param-desc">The job ID returned from the analyze endpoint</div>
                            </div>
                        </div>
                    </div>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Example</h4>
                        <div class="code-block">curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  {{ request.host_url }}api/result/550e8400-e29b-41d4-a716-446655440000</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response Examples</h4>

                        <h5>Queued Job:</h5>
                        <div class="code-block">{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "queue_position": 3,
  "message": "Job is queued. 2 jobs ahead.",
  "created_at": 1640995200.0
}</div>

                        <h5>Processing Job:</h5>
                        <div class="code-block">{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "message": "Analysis is in progress...",
  "created_at": 1640995200.0
}</div>

                        <h5>Completed Job:</h5>
                        <div class="code-block">{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "result": "Analysis result here...",
  "tokens_used": 10,
  "created_at": 1640995200.0
}</div>

                        <h5>Failed Job:</h5>
                        <div class="code-block">{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "failed",
  "error": "Analysis failed: file not found",
  "created_at": 1640995200.0
}</div>
                    </div>
                </div>
            </div>

            <div class="endpoint-card" id="api_tokens">
                <div class="endpoint-header">
                    <span class="method">GET</span>
                    <h3>/api/api_tokens</h3>
                </div>
                <div class="endpoint-content">
                    <p class="endpoint-description">
                        <i class="fas fa-key text-warning"></i>
                        Retrieve a list of your active API tokens for programmatic access.
                    </p>

                    <div class="curl-section">
                        <h4><i class="fas fa-terminal"></i> Curl Example</h4>
                        <div class="code-block">curl -H "Authorization: Bearer YOUR_API_TOKEN" {{ request.host_url }}api/api_tokens</div>
                    </div>

                    <div class="response-section">
                        <h4><i class="fas fa-reply"></i> Response</h4>
                        <div class="code-block">{
  "tokens": [
    {
      "id": 1,
      "name": "My Token",
      "created_at": "2024-01-01T00:00:00Z",
      "last_used": null
    }
  ]
}</div>
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>
{% endblock %}