> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apistable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 积分与计费

> 美元购买积分，逐项核对结果费用。

> 当前为 API 预览。生成接口尚未接入供应商，成功认证后仍可能返回 503；不会创建任务或扣积分。

## 购买、冻结与可用

支付订单记录美元与到账积分，模型消费记为 Credits。购买积分不计入 API 用量。可用积分等于账面积分减去未释放冻结。

预览价格仅为示例。正式兑换比例、支付渠道和各渠道实际费率应在开放收费前发布。

[查看价格](https://apistable.com/pricing)
[打开账务](https://apistable.com/console/billing)

## 读取账户余额

GET /v1/balance 需要 usage:read，返回 balance\_credits、reserved\_credits 与 available\_credits。新账户返回零是正常情况，端点不会创建试用积分或执行支付。

```bash theme={null}
{
  "balance_credits": 0,
  "reserved_credits": 0,
  "available_credits": 0
}
```

## 四个结果，一笔清晰合计

| 结果 | 实扣 | 释放 |
| - | - | - |
| 低价成功 | 20 积分 | 40 积分 |
| 低价成功 | 20 积分 | 40 积分 |
| 官方成功 | 60 积分 | 0 积分 |
| 两次尝试均失败 | 0 积分 | 60 积分 |
| 合计 / 初始冻结 240 | 100 积分 | 140 积分 |

> 仅为示例。失败尝试是平台成本，不额外计入用户账单。每个结果项最多一笔最终消费。

## 受理时锁定价格

* 每渠道独立按参数计价，包含取整、最低单位及适用附加项。
* 官方成功按已披露官方价，低价成功按低价；之后调价不能提高已受理上限。
* 未知项只保留自身冻结，已明确成功或失败的其他项可独立结算或释放。
* LLM 流式中断与音乐原生组合使用各自已发布计量契约，不能直接套用图片/视频规则。


## OpenAPI

````yaml openapi.json GET /v1/balance
openapi: 3.1.0
info:
  title: APIstable API preview
  version: 0.1.0-preview
  description: >-
    Current implemented HTTP surface. / 当前已实现的 HTTP 接口。 Models and quote prices
    are illustrative. Real providers and paid generation are not connected. POST
    /v1/tasks and /v1/chat/completions return 503 provider_not_configured after
    authentication and applicable validation; no credits are reserved or
    charged. Live 202 acceptance, provider callbacks, SSE, idempotent task
    creation, and full model capability adapters remain future integration work.
    Website login sessions are separate from application API keys.
servers:
  - url: https://apistable.com
    description: APIstable API
security: []
tags:
  - name: Models
  - name: Quotes
  - name: Tasks
  - name: Credits
  - name: LLM
paths:
  /v1/balance:
    get:
      tags:
        - Credits
      summary: Read credit balance / 查询积分余额
      description: >-
        Requires usage:read. Reads the real account balance; never issues trial
        credits or executes a payment.
      operationId: getBalance
      responses:
        '200':
          description: Account credit balance
          content:
            application/json:
              schema:
                type: object
                required:
                  - balance_credits
                  - reserved_credits
                  - available_credits
                properties:
                  balance_credits:
                    type: number
                    minimum: 0
                    description: Credits, not USD. / 积分，非美元。
                  reserved_credits:
                    type: number
                    minimum: 0
                    description: Credits, not USD. / 积分，非美元。
                  available_credits:
                    type: number
                    minimum: 0
                    description: Credits, not USD. / 积分，非美元。
        '401':
          description: invalid_api_key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: insufficient_scope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: not_found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: service_unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: APIstable API key
      description: >-
        API key beginning as_. Keep on the server. Scope permissions are checked
        separately.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.