API Documentation

Complete guide to integrating AptRouter's prompt optimization API. Save up to 25% on token usage while maintaining quality and semantic meaning.

Quickstart

Get started with the AptRouter API in just a few steps.

1Create an Account

2Purchase Credits

Add credits to your account. £0.10 per 1M tokens (£1 = 10M tokens). Minimum purchase £5.

3Generate an API Key

Go to the API Keys page and create a new key. Save it securely - it won't be shown again.

4Start Optimizing

Use your API key to send prompts and receive optimized versions.

Authentication

All protected endpoints require an API key. Get your API key from your dashboard.

API Key Format

text

Authentication Methods

Option 1: X-API-Key Header (Recommended)

bash

Option 2: Authorization Bearer Token

bash

Security Notes:

⚠️ Never expose your API key in client-side code
✅ Store keys in environment variables
🔄 Rotate keys regularly
🚫 Don't commit keys to version control

bash

API Reference

POST

/v1/optimize

Optimize a prompt to reduce token usage while maintaining semantic meaning and quality.

Request Body

json

Response (200 OK)

json

Error Responses

400

Bad Request - Invalid input

401

Unauthorized - Invalid API key

413

Payload Too Large - Exceeds token limit

429

Rate Limit Exceeded

Examples

bash

Error Codes

Common error responses and how to handle them.

400

Bad Request

Invalid request format or missing required fields. Check your request body.

401

Unauthorized

Missing or invalid API key. Ensure your X-API-Key header is set correctly.

402

Insufficient Credits

Your account has run out of credits. Add more credits to continue.

429

Rate Limit Exceeded

Too many requests. Current limit: 100 requests per minute.

500

Internal Server Error

Something went wrong on our end. Please try again or contact support.

Error Response Format

json

Support

Need help with your integration? We're here to assist.

Email Support

support@aptrouter.ai

Get help with technical questions, billing issues, or general inquiries.

Community Discord

Join our Discord server

Connect with other developers, share tips, and get quick answers from the community.

Best Practices

Implement retry logic with exponential backoff for failed requests
Cache optimized prompts to reduce API calls and costs
Monitor your credit balance regularly
Store API keys in environment variables, never in code
Review the Activity page for usage insights