General Questions
What is AppleRouter?
What is AppleRouter?
AppleRouter is a unified AI API gateway that provides access to multiple AI model providers (OpenAI, Anthropic Claude, Google Gemini, etc.) through a single API interface. You only need one API key to access all supported models.
Which models are supported?
Which models are supported?
AppleRouter supports models from:
- OpenAI: GPT-4o, GPT-4 Turbo, GPT-3.5, DALL-E 3, Whisper, TTS, Sora
- Anthropic: Claude Opus 4.5, Claude Sonnet 4, Claude 3.5 Sonnet, Claude 3 Haiku
- Google: Gemini 2.0 Flash, Gemini 1.5 Pro, Imagen, Veo
- Others: Kling, Jimeng, and more
Is AppleRouter compatible with OpenAI SDK?
Is AppleRouter compatible with OpenAI SDK?
Yes! AppleRouter is fully compatible with the OpenAI API format. Just change the
base_url to https://api.applerouter.ai/v1 and use your AppleRouter API key.Can I use Claude or Gemini's native API format?
Can I use Claude or Gemini's native API format?
Yes, AppleRouter auto-detects the API format based on request headers:
| Headers | Detected Format |
|---|---|
x-api-key + anthropic-version | Anthropic Claude |
x-goog-api-key or key query param | Google Gemini |
| Default | OpenAI |
How is pricing calculated?
How is pricing calculated?
AppleRouter uses pay-as-you-go pricing based on token usage. Visit the Console to view current pricing for each model.
Error Handling
Error 401: Invalid API Key
Error 401: Invalid API Key
Cause: The API key is missing, invalid, or expired.Solutions:
- Verify your API key is correct
- Check the key hasn’t been deleted in the Console
- Ensure the
Authorizationheader format is correct:Bearer YOUR_API_KEY
Error 429: Rate Limited
Error 429: Rate Limited
Cause: Too many requests in a short period.Solutions:
- Implement exponential backoff retry logic
- Reduce request frequency
- Contact support for higher rate limits
Error 400: Invalid Request
Error 400: Invalid Request
Cause: Request parameters are incorrect or missing.Common issues:
- Missing required fields (e.g.,
model,messages) - Invalid model name
- Incorrect message format
- Unsupported parameters for the selected model
Error 500/502/503: Server Error
Error 500/502/503: Server Error
Cause: Temporary server or upstream provider issue.Solutions:
- Retry after a short delay
- If persistent, check status page for outages
- Consider implementing model fallback
Timeout errors
Timeout errors
Cause: Request took too long to complete.Solutions:
- Reduce
max_tokensto get shorter responses - Set appropriate timeout values in your client
- Use streaming for long responses
- For video generation, use async polling instead of waiting
Usage Tips
How to reduce token usage?
How to reduce token usage?
- Be concise: Write clear, focused prompts
- Limit history: Only include relevant conversation context
- Use system prompts: Set expectations upfront to reduce back-and-forth
- Set max_tokens: Limit response length when appropriate
- Choose the right model: Use smaller models (GPT-3.5, Haiku) for simple tasks
How to choose between models?
How to choose between models?
| Use Case | Recommended Models |
|---|---|
| Complex reasoning | GPT-4o, Claude Opus 4.5, Gemini 1.5 Pro |
| Fast responses | GPT-4o-mini, Claude 3 Haiku, Gemini 2.0 Flash |
| Code generation | Claude Sonnet 4, GPT-4o |
| Creative writing | Claude Opus 4.5, GPT-4o |
| Cost-sensitive | GPT-3.5 Turbo, Claude 3 Haiku |
| Image generation | DALL-E 3, Gemini Imagen |
| Video generation | Sora, Kling, Veo |
How to use streaming effectively?
How to use streaming effectively?
Streaming improves perceived latency by showing responses as they’re generated.
How to handle long conversations?
How to handle long conversations?
- Summarize history: Periodically summarize older messages
- Sliding window: Keep only the last N messages
- Selective context: Only include messages relevant to the current topic
Account & Billing
How do I check my usage?
How do I check my usage?
Log in to the AppleRouter Console to view:
- Current balance
- Usage history by model
- API request logs
How do I add funds?
How do I add funds?
Visit the billing section in the Console to add credits to your account.
What happens when my balance is zero?
What happens when my balance is zero?
API requests will return a
402 Payment Required error. Add funds to continue using the service.