neurall-io Pricing API

openapi: 3.2.0
info:
  title: Neurall API (v3) Pricing API
  version: 1.0.0
  description: 'The public v3 surface: /v3/generations for async generations that produce a content asset, /v3/voices for the voice catalog and your own cloned voices, plus file uploads, per-feature pricing, read-only templates, and signed webhooks. Authenticate every call with an API key in the Authorization header. This document is machine-readable at https://api.neurall.io/v3/openapi.json (import it into Postman, or generate a client).'
servers:
- url: https://api.neurall.io
tags:
- name: Pricing
  description: Per-feature pricing of your plan (v3)
paths:
  /v3/pricing:
    get:
      summary: Get Pricing
      description: 'What every feature costs YOU, on your plan, so a call can be costed before it is made. Fetch it to show a price in your own UI, to budget a batch, or to decide whether an option is worth its surcharge, rather than hardcoding numbers that go stale when your plan changes.


        Prices are not one flat figure across the platform: `price` is per call for most features and per unit for the ones billed by output length (a reveal is charged per second of finished clip), and `variants` holds the multipliers that options like resolution apply on top.


        Nothing here is a quote or a hold; the balance is charged when a generation is accepted.'
      security:
      - ApiKeyAuth: []
      tags:
      - Pricing
      responses:
        '200':
          description: Map of feature name to price info
          content:
            application/json:
              schema:
                type: object
                properties:
                  prices:
                    type: object
                    description: One entry per feature your plan prices, keyed by the feature name you send as `feature` when generating (image/self-portrait, video/object-reveal, ...). A feature you cannot call does not appear.
                    x-additionalPropertiesName: feature
                    additionalProperties:
                      type: object
                      properties:
                        price:
                          type: number
                          description: The base price in USD. Per call for flat features; per unit for the ones billed by output length (a reveal per second of finished clip, an avatar video per started 15 seconds, a voiceover per started 1,000 characters of script).
                        variants:
                          type: object
                          description: 'Present only when one of the feature''s arguments changes the price. Keyed by that argument''s name; each entry maps the values you can send to the multiplier applied on top of `price`. You never send a variant key: the server reads the argument off your call and applies the multiplier itself, so the cost of a call is `price` times the multiplier of each option it uses. A boolean argument maps as `off`/`on`. `"fineDetails": {"off": 1, "on": 4}` reads as: a fine-details second costs 4x the base rate, and `"resolution": {"720p": 1, "1080p": 1.5}` prices a 1080p avatar block at 1.5x the 720p one. Absent entirely, the feature has one flat price.'
              example:
                prices:
                  image/self-portrait:
                    price: 0.05
                  image/product-shot:
                    price: 0.15
                    variants:
                      fineDetails:
                        'off': 1
                        'on': 3.5
                  video/object-reveal:
                    price: 0.25
                    variants:
                      fineDetails:
                        'off': 1
                        'on': 4
                  video/avatar:
                    price: 0.75
                    variants:
                      resolution:
                        720p: 1
                        1080p: 1.5
                  audio/voice-clone:
                    price: 3
        '401':
          description: Unauthorized
      operationId: getV3Pricing
      x-operation-id-source: derived
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization