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.
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
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