Clipia.ai Account API

Аккаунт, баланс и использование.

GitHub OpenAPI

Operations 1

GET /v1/account Аккаунт и баланс #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/clipia-ai:clipia-ai-account-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clipia-ai-account-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Clipia Ai Account API
  version: v1
  contact:
    name: Clipia API Support
    url: https://clipia.ai
  license:
    name: Proprietary
    url: https://clipia.ai/terms
  termsOfService: https://clipia.ai/terms
  description: 'Operations tagged Account across 2 of this provider''s published API definitions: clipia-v1.json, clipia-ai-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.clipia.ai
  description: Production
security:
- apiKey: []
tags:
- name: Account
  description: Аккаунт, баланс и использование.
paths:
  /v1/account:
    get:
      tags:
      - Account
      operationId: getAccount
      summary: Аккаунт и баланс
      description: 'Возвращает баланс в кредитах и использование за 30 дней.

        Стоимость 1 кредита в деньгах через API не раскрывается.

        Доступно любому валидному ключу (scope не требуется).'
      security:
      - apiKey: []
      responses:
        '200':
          description: Сведения об аккаунте.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Account'
              examples:
                account:
                  summary: Аккаунт
                  value:
                    account_id: 8f3a1c7e-2b4d-4e6f-9a01-23456789abcd
                    balance:
                      credits: 1840
                    usage_30d:
                      requests: 512
                      credits_spent: 6120
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
    servers:
    - url: https://api.clipia.ai
      description: Production
components:
  schemas:
    Error:
      type: object
      description: Единый JSON-формат ошибки. Сообщения санитизированы.
      required:
      - error
      properties:
        error:
          type: object
          required:
          - type
          - code
          - message
          properties:
            type:
              type: string
              description: Категория ошибки (закрытый список).
              enum:
              - invalid_request_error
              - authentication_error
              - permission_error
              - billing_error
              - idempotency_error
              - rate_limit_error
              - api_error
            code:
              type: string
              description: 'Машиночитаемый код ошибки. Соответствие `code → type`:

                `invalid_request`, `not_found`, `model_input_invalid`, `invalid_model` → `invalid_request_error`;

                `invalid_api_key` → `authentication_error`; `insufficient_scope` → `permission_error`;

                `insufficient_credits`, `subscription_required` → `billing_error`;

                `idempotency_key_reuse`, `request_in_progress` → `idempotency_error`;

                `rate_limit_exceeded`, `concurrency_limit_exceeded` → `rate_limit_error`;

                `internal_error`, `service_unavailable` → `api_error`.

                '
              examples:
              - invalid_api_key
              - insufficient_credits
              - subscription_required
              - insufficient_scope
              - not_found
              - idempotency_key_reuse
              - request_in_progress
              - model_input_invalid
              - rate_limit_exceeded
              - concurrency_limit_exceeded
              - internal_error
              - service_unavailable
            message:
              type: string
              description: Человекочитаемое описание ошибки.
            retry_after_seconds:
              type: integer
              description: Подсказка для 429/503 — через сколько секунд повторить (дублирует `Retry-After`).
            retry_after_ms:
              type: integer
              description: То же в миллисекундах (для коротких окон опроса).
    Account:
      type: object
      required:
      - balance
      - usage_30d
      properties:
        account_id:
          type: string
          description: Идентификатор аккаунта.
          examples:
          - 8f3a1c7e-2b4d-4e6f-9a01-23456789abcd
        balance:
          type: object
          required:
          - credits
          properties:
            credits:
              type: number
              description: Текущий баланс в кредитах.
              examples:
              - 1840
        usage_30d:
          type: object
          description: Использование за последние 30 дней.
          required:
          - requests
          - credits_spent
          properties:
            requests:
              type: integer
              description: Count of API/MCP calls, including polling; not generation count.
              examples:
              - 512
            credits_spent:
              type: number
              description: Net settled ledger debits minus refunds for API operations started in the last 30 days; excludes reservations and duplicate calls.
              examples:
              - 6120
  responses:
    RateLimited:
      description: "Превышен лимит. `error.type` всегда `rate_limit_error`; различайте по `error.code`:\n\n- `rate_limit_exceeded` — запросов в минуту (RPM) или токенов в минуту (TPM) по ключу;\n- `concurrency_limit_exceeded` — слишком много генераций одновременно\n  (по ключу или по аккаунту). Дождитесь завершения одной и повторите.\n\nВ обоих случаях сервер отдаёт заголовок `Retry-After` и дублирует подсказку в\n`error.retry_after_seconds`.\n"
      headers:
        Retry-After:
          description: Через сколько секунд можно повторить запрос.
          schema:
            type: integer
        RateLimit-Limit:
          description: Лимит запросов в минуту.
          schema:
            type: integer
        RateLimit-Remaining:
          description: Остаток запросов в текущем окне.
          schema:
            type: integer
        RateLimit-Reset:
          description: Через сколько секунд сбросится окно лимита.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            rateLimited:
              summary: RPM/TPM по ключу
              value:
                error:
                  type: rate_limit_error
                  code: rate_limit_exceeded
                  message: Rate limit exceeded. Retry after the reset window.
                  retry_after_seconds: 12
            concurrencyLimited:
              summary: Слишком много одновременных генераций
              value:
                error:
                  type: rate_limit_error
                  code: concurrency_limit_exceeded
                  message: Too many concurrent generations in flight for this API key (limit 5). Wait for one to finish, then retry.
                  retry_after_seconds: 5
    Unauthorized:
      description: Ключ отсутствует, неверный или отозван.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            invalidApiKey:
              value:
                error:
                  type: invalid_request_error
                  code: invalid_api_key
                  message: API-ключ отсутствует, неверный или отозван.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
      description: 'API-ключ в заголовке `Authorization` со схемой `Bearer`:


        ```

        Authorization: Bearer <CLIPIA_API_KEY>

        ```


        Передавайте полную строку, включая префикс схемы `Bearer ` и пробел.

        Также принимаются `Authorization: Key <ключ>` и заголовок

        `X-Api-Key: <ключ>` — выбирайте удобную схему.

        Ключ создаётся в консоли разработчика (clipia.ai/developer, вкладка

        «API-ключи») и показывается один раз. Формат: `clipia_live_…` (боевой), `clipia_test_…` (песочница).


        **Sandbox / тестовый режим.** Ключ с префиксом `clipia_test_…` работает в

        песочнице: `submit` не списывает кредиты и не запускает реальную

        генерацию — он мгновенно возвращает `status: COMPLETED` с детерминированным

        mock-результатом (фиксированный sample-ассет на `media.clipia.ai`). Поле

        `cost` показывает расчётную стоимость, но она не списывается. Вебхуки

        приходят тем же подписанным механизмом (HMAC-SHA256). Режим предназначен

        для отладки интеграции до подключения боевого ключа.

        '
      x-sandbox:
        keyPrefix: clipia_test_
        chargesCredits: false
        callsGeneration: false
        immediateStatus: COMPLETED
        sampleImageUrl: https://media.clipia.ai/sandbox/v1/sample-image.png
        sampleVideoUrl: https://media.clipia.ai/sandbox/v1/sample-video.mp4
        sampleAudioUrl: https://media.clipia.ai/sandbox/v1/sample-audio.mp3
x-refined-from:
- clipia-v1.json
- clipia-ai-openapi.yml