Skip to main content

API Overview

Introduction​

The I Hate PPT API provides developers with a complete programming interface, allowing you to integrate AI PPT generation functionality into your own applications.

πŸ‘‰ Get Started with API

Basic Information​

Base URL​

https://api.ihateppt.com/v1

Authentication​

All API requests require an API key in the request header:

Authorization: Bearer YOUR_API_KEY

Data Format​

  • Request Format: JSON
  • Response Format: JSON
  • Character Encoding: UTF-8

Quick Start​

1. Get API Key​

  1. Log in to I Hate PPT Console
  2. Go to "API Management" page
  3. Create a new API key
  4. Copy the key and save it securely

2. Send Your First Request​

curl -X POST https://api.ihateppt.com/v1/ppt/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "AI Development Trends",
    "mode": "quick",
    "language": "en"
  }'

3. Handle Response​

{
  "success": true,
  "data": {
    "ppt_id": "ppt_123456",
    "title": "AI Development Trends",
    "pages": 8,
    "status": "completed",
    "download_url": "https://api.ihateppt.com/v1/ppt/ppt_123456/download"
  }
}

Core Features​

PPT Generation​

  • Quick Generation - Generate complete PPT in 30 seconds
  • Smart Editing - Edit content through API
  • Document Import - Generate PPT from existing documents
  • Batch Processing - Generate multiple PPTs in batch

Content Management​

  • File Upload - Upload documents and images
  • Version Control - Manage different versions of PPTs
  • Collaborative Editing - Support multi-user collaboration
  • Permission Management - Control access permissions

Data Query​

  • Usage Statistics - Query API usage
  • Credit Balance - Check remaining credits
  • History Records - Get operation history
  • Error Logs - View error information

Ready to integrate with your app?

Get started with our powerful API and SDK. Build amazing presentation features into your own applications.

View API Docs

Error Handling​

HTTP Status Codes​

  • 200 - Request successful
  • 400 - Invalid request parameters
  • 401 - Authentication failed
  • 403 - Insufficient permissions
  • 404 - Resource not found
  • 429 - Rate limit exceeded
  • 500 - Internal server error

Error Response Format​

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "Parameter topic cannot be empty",
    "details": {
      "field": "topic",
      "value": null
    }
  }
}

Rate Limits​

Free Users​

  • Request Rate: 10 requests per minute
  • Daily Limit: 100 requests
  • Concurrent Limit: 2 concurrent requests
  • Request Rate: 100 requests per minute
  • Daily Limit: 10,000 requests
  • Concurrent Limit: 10 concurrent requests

Enterprise Users​

  • Request Rate: 1,000 requests per minute
  • Daily Limit: Unlimited
  • Concurrent Limit: 100 concurrent requests

SDK Support​

Official SDKs​

  • Python - pip install aippt-python
  • JavaScript - npm install aippt-js
  • Java - Maven/Gradle dependency
  • PHP - Composer package

Community SDKs​

  • Go - Community maintained
  • Ruby - Community maintained
  • C# - Community maintained
  • Swift - Community maintained

Best Practices​

Request Optimization​

  1. Batch Operations - Use batch APIs whenever possible
  2. Cache Results - Cache data that doesn't change frequently
  3. Async Processing - Use async APIs for long-running tasks
  4. Error Retry - Implement exponential backoff retry mechanism

Security Recommendations​

  1. Protect API Keys - Don't expose API keys in client-side code
  2. Use HTTPS - Always use HTTPS for API calls
  3. Validate Input - Validate all input parameters
  4. Monitor Usage - Monitor API usage and anomalies

Performance Optimization​

  1. Connection Reuse - Reuse HTTP connections
  2. Compression - Enable gzip compression
  3. Pagination - Use pagination to avoid large data sets
  4. Smart Caching - Use caching wisely to reduce requests

Support and Help​

Documentation Resources​

Technical Support​

Ready to integrate with your app?

Get started with our powerful API and SDK. Build amazing presentation features into your own applications.

View API Docs

Start Using the API - Check out the API Reference Documentation for detailed API interface descriptions.