Getting Started

Authentication

All API requests require authentication via an API key. Include your key in every request using one of these methods:

# Header method (recommended)
X-API-Key: your_api_key_here

# Bearer token method
Authorization: Bearer your_api_key_here

Base URL

https://pikokit.com/api/v1

Making Your First Request

curl -X GET "https://pikokit.com/api/v1/tools" \
  -H "Accept: application/json"

Error Codes

Credits

API calls consume credits from your account balance. Credits are deducted before the request is proxied; if the upstream tool fails, credits are automatically refunded.

Each tool lists its credit cost in the docs. Costs:

• •1 credit — standard tools (text processing, simple conversions)
• •2 credits — medium tools (image processing, structured extraction)
• •4 credits — heavy tools (PDF manipulation, multi-file operations)

Every response includes credit headers:

• •X-Credit-Cost— credits consumed by this request
• •X-Credits-Remaining— total credits remaining (sub + purchased)
• •X-Credits-Subscription— subscription credits remaining
• •X-Credits-Purchased— purchased pack credits remaining
• •X-Overdraft-Active— present and true when using overdraft

Rate Limiting

Rate limits vary by plan. Response headers include:

• •X-RateLimit-Limit— maximum requests per minute
• •X-RateLimit-Remaining— remaining requests in window
• •Retry-After— seconds until rate limit resets (when limited)

Tool Categories