Skip to main content
The SmartlyQ API is pay-as-you-go. There are no API plan tiers — you top up a prepaid wallet of SmartlyQ Credits (SQC), and each request deducts credits for the AI resources it actually uses. Build and test for free in sandbox, then switch to a live key when you ship.

Free to test

Build against the API with a sqk_test_ key — sample responses, no credits charged. Endpoints with no sample response need a live key.

Pay per request

Live calls deduct SQC based on the model, tokens, and operation type. No subscription for API access.

Top up anytime

Add credits in packages from the Developer Dashboard, or turn on auto-recharge.

Credit packages

Top up your Developer wallet from the Developer Dashboard:
Enable auto-recharge to keep your wallet funded automatically, so requests never fail for a low balance.

What a request costs

Credit cost per request depends on:
  1. AI model used — larger, more capable models cost more
  2. Token count — input + output tokens consumed
  3. Operation type — text, image, video, audio, or presentations
A small minimum charge applies per operation type: Read-only calls - listing posts, fetching analytics, managing accounts - don’t consume credits. Generation and publishing actions do. The exception is X (Twitter): X charges for every call, reads included, see below.

X (Twitter) calls

X charges for every call to its API (pay per use), and these charges are passed on at X’s own price. Calls you make through the API, and posts created through the API, are deducted from your Developer wallet; actions in the app are charged in the workspace’s credits.
  • Only calls X accepts are charged: a refused or failed call costs nothing.
  • A read is charged per item returned, and an item read again on the same day (UTC) is not charged twice, matching how X bills.
  • Items X returns alongside a read are charged too: for example each reply comes with its author’s profile (a profile read), and each direct message with its sender’s profile.
  • A link anywhere in the text (https://..., www.... or a bare domain such as example.com) makes a post the link price.
  • Before each X call the wallet must hold its price. If it does not, the call is not sent and you get 402 INSUFFICIENT_BALANCE with the price in the message.
  • Account-connection and token-refresh calls are free.
  • Connecting X needs the workspace’s agreement that X is charged: send accept_x_charges: true on POST /social/connect/twitter (or the profile connect endpoints), or tick the box in the app. Until then X calls return an error and nothing is charged.
  • Each X account may publish up to 50 posts and send up to 100 DMs per day (spam guard); more returns an error until midnight UTC.
  • During a trial, X is limited to 50 credits in all; it unlocks when the plan starts.

Track your spend

Check your wallet balance any time:
For how the wallet, per-request deductions, and low-balance errors work in detail, see Billing & Credits.