Clipia.ai Models API

Каталог моделей, их схемы входа и оценка стоимости.

GitHub OpenAPI

Operations 3

GET /v1/models/{model} Детали модели #
POST /v1/models/{model}/estimate Оценить стоимость генерации #
GET /v1/models Список моделей #

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-models-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-models-api-openapi.yml Raw ↑
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