PowerPost APIv1
PowerPost APIv1
PowerPost APIQuickstartAuthenticationWorkspacesInput Types

API Reference

Upload MediaGenerate ContentGenerationsGenerate ImagesPosts & PublishingGet Credits

Guides

WebhooksError CodesChangelog

Get Credits

Check your current credit balance.

GET /api/v1/account/credits

Get your current credit balance.

Request

Headers

HeaderValue
x-api-keyYour API key

Example Request

curl https://powerpost.ai/api/v1/account/credits \
  -H "x-api-key: pp_live_sk_YOUR_KEY"
const res = await fetch('https://powerpost.ai/api/v1/account/credits', {
  headers: { 'x-api-key': 'pp_live_sk_YOUR_KEY' },
})
const data = await res.json()
import requests

res = requests.get(
"https://powerpost.ai/api/v1/account/credits",
headers={"x-api-key": "pp_live_sk_YOUR_KEY"},
)
data = res.json()

Response

{
  "balance": 47
}

Response Fields

FieldTypeDescription
balancenumberCurrent credit balance

Credit System

Credits are purchased in packs and never expire. New accounts receive 50 free credits on signup. Buy more credits anytime from the pricing page or in the dashboard.

How Credits Are Used

Credits are consumed across three types of actions:

  • Caption generation — Cost depends on research mode (regular or deep), with additional charges for image and video analysis. Deep research costs more than regular. The number of platforms does not affect the cost.
  • Image generation — Cost varies by model. Generating multiple images multiplies the per-image cost. Higher-quality models cost more credits.
  • Publishing — A flat 1-credit base fee per publish action, with premium platforms (X) adding a surcharge due to higher API costs. All other platforms are included in the base fee.

The exact credit cost for each action is shown in the app before you confirm, and included in API responses.

Sample: A typical text post with regular research, generated for 3 platforms, with one image and published to all 3, might cost around 10–15 credits total.

Credits are refunded for failed generations. Publishing credits are only charged for items that publish successfully — no charge for failed items. Image generations with partial failures receive a partial refund.

See Also

  • Generate Content — Caption generation
  • Generate Images — Image generation
  • Posts & Publishing — Publish to platforms

Posts & Publishing

Create posts and publish them to connected social platforms.

Webhooks

Receive real-time notifications when generations complete.

On this page

RequestHeadersExample RequestResponseResponse FieldsCredit SystemHow Credits Are UsedSee Also