get_credits
Get credit balance
Use only the account's existing entitlements: when work is unavailable, explain the limit without offering purchases, upgrades, subscriptions or checkout links. Read who pays for a press: the user's own vendor keys (fal, Replicate…) in their payer order, each with its state and, for Runware and Siray, what is left; then the house's free allowance; then credits. Also the plan and account-wide AI requests per minute. A press a key or the allowance covers costs no credits. AI requests share the rate limit across the app and agents; on RATE_LIMITED, wait retry_after_seconds before retrying.
Scope
media.read— Reads the account: media, uploads, boards, runs, Subjects, models and the balance.
Behaviour
- Read-only
- Reads the caller's own account and changes nothing.
- Stays in the account
- Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.
- Idempotent
- Calling it again with the same arguments has no further effect.
Credits
What the tool's description says about credits, verbatim.
- Read who pays for a press: the user's own vendor keys (fal, Replicate…) in their payer order, each with its state and, for Runware and Siray, what is left; then the house's free allowance; then credits.
- A press a key or the allowance covers costs no credits.
Inputs
It takes no arguments.
Example call
A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_credits",
"arguments": {}
}
}Input schema
As the server sends it in tools/list.
{
"type": "object",
"properties": {}
}Related tools
- generate_image
Make an image in the user's Kuro account.
- generate_clip
Start a short video clip generation.