Pomelo API Documentation

Welcome to the Pomelo API documentation. This API provides access to various AI services including text generation, image generation, speech synthesis, and more.

Base URL

https://www.pomeloapi.com/api

Authentication

All API endpoints (except status checks) require authentication using API keys. Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

API Versions

• v1: Current stable version (/api/v1/)

Quick Start

1. Get your API key
2. Check the status endpoint to verify API availability
3. Review the task endpoint for AI operations
4. Monitor your billing and credits

Endpoints Overview

Core Endpoints

• Tasks (/api/v1/task) - Main AI processing endpoint
• Models (/api/v1/models) - Model information and pricing

Management Endpoints

• API Keys (/api/keys) - Manage your API keys
• Billing (/api/billing) - Credits and payment management

System Endpoints

• Status (/api/status) - API health checks
• Authentication (/api/auth) - User authentication

Supported AI Services

Text Generation

• OpenAI GPT Models: GPT-4, GPT-3.5-turbo, and other OpenAI models
• Claude Models: Anthropic's Claude family of models
• Mixtral: Open-source language models

Image Generation

• Black Forest Labs: High-quality image generation models

Speech Services

• ElevenLabs:
  • Text-to-speech synthesis
  • Speech-to-speech conversion
  • Speech-to-text transcription

Rate Limits

API requests are subject to rate limiting based on your subscription plan. Rate limit information is included in response headers.

Error Handling

All errors follow a consistent format:

{
  "error": {
    "message": "Error description",
    "type": "error_type",
    "code": "error_code"
  }
}

Common error types:

• invalid_request_error: Request format or parameters are invalid
• authentication_error: Invalid or missing API key
• rate_limit_error: Rate limit exceeded
• insufficient_credits_error: Not enough credits for the operation

SDKs and Libraries

Coming soon - official SDKs for popular programming languages.

Support

For API support, please contact our support team or check the documentation for specific endpoints.