PowerPost APIv1
PowerPost APIv1
PowerPost APIQuickstartAuthenticationWorkspacesInput Types

API Reference

Upload MediaGenerate ContentGenerationsGenerate ImagesGenerate VideosPosts & PublishingAnalyticsCalendarGet 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 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.
  • Image generation — Cost varies by model and quantity. Higher-quality models cost more credits.
  • Video generation — Cost varies by model, duration, and audio settings.
  • Publishing — Cost per publish action, with premium platforms (X) costing more due to higher API costs.

The exact credit cost for each action is included in API responses via credits_used. See the pricing page for current rates.

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
  • Generate Videos — Video generation
  • Posts & Publishing — Publish to platforms

Calendar

Manage content calendar entries for planning and scheduling posts.

Webhooks

Receive real-time notifications when generations complete.

On this page

RequestHeadersExample RequestResponseResponse FieldsCredit SystemHow Credits Are UsedSee Also