Clipia.ai Models API
Каталог моделей, их схемы входа и оценка стоимости.
Каталог моделей, их схемы входа и оценка стоимости.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/clipia-ai:clipia-ai-models-api"
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.
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: 3.2.0
info:
title: Clipia Ai Models 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 Models 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: Models
description: Каталог моделей, их схемы входа и оценка стоимости.
paths:
/v1/models/{model}:
get:
tags:
- Models
operationId: getModel
summary: Детали модели
description: 'Для generation-модели возвращает схему входа (`input_schema`) и
reference quote (для TTS на 1000 символов). Для text LLM возвращает OpenAI-совместимые metadata,
лимиты контекста и токенные тарифы.
Доступно любому валидному ключу (scope не требуется).'
security:
- apiKey: []
parameters:
- $ref: '#/components/parameters/ModelSlug'
responses:
'200':
description: Детали модели.
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ModelDetail'
- $ref: '#/components/schemas/LlmModelSummary'
examples:
imageModel:
summary: Image-модель
value:
slug: nano-banana-2
type: image
name: Nano Banana 2
capabilities:
- text-to-image
- image-to-image
input_schema:
parameters:
- name: prompt
type: textarea
required: true
- name: image_url
type: string
required: false
- name: aspect_ratio
type: select
options:
- value: '1:1'
label: '1:1'
- value: '16:9'
label: '16:9'
- value: '9:16'
label: '9:16'
pricing:
credits: 12
videoModel:
summary: Video-модель
value:
slug: seedance-2-fast-i2v
type: video
name: Seedance 2 Fast
capabilities:
- image-to-video
input_schema:
parameters:
- name: image_url
type: string
required: true
- name: prompt
type: textarea
required: false
- name: duration
type: select
options:
- value: 4
label: '4'
- value: 8
label: '8'
default: 4
- name: resolution
type: select
options:
- value: 480p
label: 480p
- value: 720p
label: 720p
- value: 1080p
label: 1080p
default: 720p
pricing:
credits: 40
audioModel:
summary: Модель озвучки (text-to-speech)
value:
slug: gemini-3-1-flash-tts
type: audio
name: Gemini 3.1 Flash TTS
capabilities:
- text-to-speech
text_limits:
min_chars: 10
max_chars: 500
input_schema:
parameters:
- name: prompt
type: textarea
required: true
validation:
minLength: 10
maxLength: 500
- name: voice
type: select
default: Zephyr
options:
- value: Zephyr
label: Zephyr
- value: Puck
label: Puck
pricing:
credits: 3
billing_unit: characters
unit_size: 1000
character_count: trimmed_text
rounding: ceil
minimum_credits: 1
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
servers:
- url: https://api.clipia.ai
description: Production
/v1/models/{model}/estimate:
post:
tags:
- Models
operationId: estimateGeneration
summary: Оценить стоимость генерации
description: 'Возвращает детерминированную стоимость генерации в кредитах для
переданного `input` без постановки в очередь и без списания. Удобно,
чтобы показать цену пользователю до `submit`. Доступно любому валидному
ключу (scope не требуется).
Ключ `input`, который модель не применит, перечисляется в `warnings` —
так же, как в ответе `submit`. Оценка — удобный способ проверить набор
параметров до запуска.'
security:
- apiKey: []
parameters:
- $ref: '#/components/parameters/ModelSlug'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EstimateRequest'
examples:
image:
summary: Оценка для image-модели (Nano Banana 2, `nano-banana-2`)
value:
input:
prompt: a sunset over mountains, cinematic
aspect_ratio: '16:9'
video:
summary: Оценка для video-модели (Seedance 2.0 Fast, `seedance-2-fast-t2v`)
value:
input:
prompt: aerial shot over a neon city
duration: 8
resolution: 1080p
responses:
'200':
description: Оценка стоимости в кредитах.
content:
application/json:
schema:
$ref: '#/components/schemas/EstimateResponse'
examples:
estimate:
summary: Оценка
value:
credits: 40
ignoredParameter:
summary: Оценка с параметром, который модель не применит
value:
credits: 12
warnings:
- code: unknown_parameter
parameter: aspect_ration
message: 'Parameter "aspect_ration" is not recognized and was ignored. Parameters declared by model "nano-banana-2": aspect_ratio, prompt, resolution. Full schema: GET /v1/models/nano-banana-2.'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'422':
$ref: '#/components/responses/UnprocessableEntity'
'429':
$ref: '#/components/responses/RateLimited'
servers:
- url: https://api.clipia.ai
description: Production
/v1/models:
get:
tags:
- Models
operationId: listModels
summary: Список моделей
description: 'Возвращает каталог активных моделей Clipia — изображения и видео.
Доступно любому валидному ключу (scope не требуется).'
security:
- apiKey: []
responses:
'200':
description: Каталог моделей.
content:
application/json:
schema:
$ref: '#/components/schemas/ModelList'
examples:
catalog:
summary: Каталог
value:
data:
- slug: nano-banana-2
type: image
name: Nano Banana 2
capabilities:
- text-to-image
- image-to-image
pricing:
credits: 12
- slug: seedance-2-fast-i2v
type: video
name: Seedance 2 Fast
capabilities:
- image-to-video
pricing:
credits: 40
note: зависит от длительности/разрешения
'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: То же в миллисекундах (для коротких окон опроса).
InputWarning:
type: object
description: Параметр `input`, который модель не применит.
required:
- code
- parameter
- message
properties:
code:
type: string
description: "Машинная причина:\n- `unknown_parameter` — ключ серверу неизвестен (например, опечатка) и\n отбрасывается у любой модели;\n- `unsupported_parameter` — ключ существует, но эта модель его не\n объявляет и не использует;\n- `audio_dropped` — звук был включён, но звуковая дорожка не прошла\n проверку безопасности модели: ролик создаётся без звука, стоимость\n запроса не меняется. Приходит только в ответах о состоянии запроса\n (`RequestWarnings`), `parameter` равен `generate_audio`.\n\nСписок причин может пополняться: незнакомое значение обрабатывайте как\n«параметр не применён».\n"
examples:
- unsupported_parameter
parameter:
type: string
description: Имя ключа из `input` (длинное имя обрезается до 64 символов).
examples:
- duration
message:
type: string
description: 'Пояснение на английском: называет параметр и перечисляет параметры,
которые модель объявляет в `input_schema`. Для `audio_dropped` —
сообщает, что ролик создаётся без звука.
'
examples:
- 'Parameter "duration" is not supported by model "nano-banana-2" and was ignored. Parameters declared by this model: aspect_ratio, prompt, resolution. Full schema: GET /v1/models/nano-banana-2.'
ModelInputParameter:
type: object
required:
- name
- type
properties:
name:
type: string
type:
type: string
required:
type: boolean
default: {}
label:
type: string
hint:
type: string
options:
type: array
items:
type: object
properties:
value:
type:
- string
- number
label:
type: string
validation:
type: object
properties:
minLength:
type: integer
maxLength:
type: integer
additionalProperties: true
min:
type: number
max:
type: number
step:
type: number
minLength:
type: integer
maxLength:
type: integer
additionalProperties: true
EstimateResponse:
type: object
description: Детерминированная оценка стоимости генерации в кредитах.
required:
- credits
properties:
credits:
type: number
description: Стоимость переданного `input` на этой модели, в кредитах.
examples:
- 40
warnings:
$ref: '#/components/schemas/InputWarnings'
EstimateRequest:
type: object
required:
- input
additionalProperties: false
properties:
input:
type: object
description: 'Параметры генерации, для которых считается стоимость. Тот же формат,
что и `input` в `POST /v1/models/{model}` — см. `input_schema` модели.
'
additionalProperties: true
examples:
- prompt: a sunset over mountains, cinematic
aspect_ratio: '16:9'
LlmModelSummary:
type: object
description: OpenAI-совместимая запись текстовой LLM.
required:
- id
- canonical_slug
- object
- name
- created
- owned_by
- context_length
- architecture
- pricing
- top_provider
- supported_parameters
properties:
id:
type: string
examples:
- gpt-5.6-sol
canonical_slug:
type: string
examples:
- openai/gpt-5.6-sol
object:
type: string
const: model
name:
type: string
examples:
- GPT-5.6 Sol
created:
type: integer
format: int64
owned_by:
type: string
examples:
- openai
description:
type: string
context_length:
type: integer
examples:
- 400000
architecture:
type: object
required:
- modality
- input_modalities
- output_modalities
- tokenizer
properties:
modality:
type: string
input_modalities:
type: array
items:
type: string
output_modalities:
type: array
items:
type: string
tokenizer:
type: string
pricing:
type: object
description: USD per token, encoded as decimal strings.
properties:
prompt:
type: string
completion:
type: string
top_provider:
type: object
required:
- context_length
- max_completion_tokens
- is_moderated
properties:
context_length:
type: integer
max_completion_tokens:
type: integer
is_moderated:
type: boolean
supported_parameters:
type: array
items:
type: string
per_request_limits:
type:
- object
- 'null'
additionalProperties: true
ModelSummary:
type: object
required:
- slug
- type
- name
properties:
slug:
type: string
description: Slug модели для использования в `POST /v1/models/{model}`.
examples:
- nano-banana-2
type:
type: string
description: Тип выходного контента.
enum:
- image
- video
name:
type: string
description: Отображаемое имя модели.
examples:
- Nano Banana 2
capabilities:
type: array
description: Поддерживаемые возможности модели.
items:
type: string
examples:
- text-to-image
- image-to-image
- image-to-video
pricing:
$ref: '#/components/schemas/ModelPricing'
InputWarnings:
type: array
description: 'Параметры `input`, которые модель не применит: по элементу на ключ, не
больше 20 элементов. Поле присутствует, только когда такие параметры есть.
'
maxItems: 20
items:
$ref: '#/components/schemas/InputWarning'
ModelList:
type: object
required:
- data
properties:
object:
type: string
const: list
description: Присутствует при включённом LLM gateway.
data:
type: array
items:
oneOf:
- $ref: '#/components/schemas/ModelSummary'
- $ref: '#/components/schemas/LlmModelSummary'
ModelDetail:
type: object
required:
- slug
- type
- name
- input_schema
- pricing
properties:
slug:
type: string
examples:
- seedance-2-fast-i2v
type:
type: string
enum:
- image
- video
- audio
name:
type: string
examples:
- Seedance 2 Fast
capabilities:
type: array
items:
type: string
input_schema:
type:
- object
- 'null'
description: Parameters are a list of descriptors; send their names as keys inside input.
properties:
parameters:
type: array
items:
$ref: '#/components/schemas/ModelInputParameter'
parameterGroups:
type: array
items:
type: object
additionalProperties: true
text_limits:
type: object
description: 'Границы длины текста в символах для моделей озвучки (text-to-speech).
Текст передаётся в `input.prompt` и описан в `input_schema.parameters`;
это поле дополнительно объявляет те же границы. Запрос вне границ отвергается
кодом 400 ДО создания генерации, кредиты не резервируются.
У не-TTS моделей поле отсутствует.
'
required:
- min_chars
- max_chars
properties:
min_chars:
type: integer
description: Минимальная длина текста озвучки в символах.
examples:
- 10
max_chars:
type: integer
description: Максимальная длина текста озвучки в символах.
examples:
- 10000
additionalProperties: false
pricing:
$ref: '#/components/schemas/ModelPricing'
ModelPricing:
type: object
description: Reference quote through active billing, with character basis for TTS.
properties:
credits:
type: number
description: Quote for one unit; absent when pricing is unavailable.
billing_unit:
type: string
const: characters
unit_size:
type: integer
const: 1000
character_count:
type: string
enum:
- spoken_text
- trimmed_text
rounding:
type: string
const: ceil
minimum_credits:
type: integer
const: 1
available:
type: boolean
const: false
description: Present only when authoritative pricing is unavailable.
estimate_required:
type: boolean
const: true
description: Present when the model is available but its price depends on the submitted input (for example, the length of the source video or speech), so there is no reference quote and `credits` is absent. Call `POST /v1/models/{model}/estimate` with the actual input.
note:
type: string
additionalProperties: true
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
UnprocessableEntity:
description: Параметры `input` не подходят выбранной модели.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
modelInputInvalid:
value:
error:
type: invalid_request_error
code: model_input_invalid
message: Параметр `resolution` не поддерживается этой моделью.
Unauthorized:
description: Ключ отсутствует, неверный или отозван.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
invalidApiKey:
value:
error:
type: invalid_request_error
code: invalid_api_key
message: API-ключ отсутствует, неверный или отозван.
NotFound:
description: Неизвестный `request_id` или `model`.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
notFound:
value:
error:
type: invalid_request_error
code: not_found
message: Запрос с таким идентификатором не найден.
parameters:
ModelSlug:
name: model
in: path
required: true
description: 'Slug модели, напр. `nano-banana-2`, `seedance-2-fast-i2v`. Список — `GET /v1/models`.
Слаги с пространством имён (`google/imagen4`, `grok-imagine/text-to-video`)
передаются как есть (`/v1/models/google/imagen4`) либо с `%2F`.
'
schema:
type: string
pattern: ^[a-z0-9][a-z0-9-]{0,200}(?:/[a-z0-9][a-z0-9-]{0,200})?$
examples:
- nano-banana-2
- seedance-2-fast-i2v
- google/imagen4
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