rendobar-com Models API

openapi: 3.2.0
info:
  title: Rendobar Models API
  version: 1.0.0
  summary: Serverless media processing API
  description: Serverless media processing API. Watermark, transcode, caption, redact, and render videos with one API call. Credit-based billing. MCP-native for AI agents.
  termsOfService: https://rendobar.com/terms/
  contact:
    name: Rendobar Support
    url: https://rendobar.com/
    email: hello@rendobar.com
  license:
    name: Proprietary
    url: https://rendobar.com/terms/
servers:
- url: https://api.rendobar.com
  description: Current environment
security:
- bearerAuth: []
- oauth2: []
tags:
- name: Models
  description: Generation model catalog (image.generate / image.edit)
paths:
  /models:
    get:
      security:
      - bearerAuth:
        - jobs:read
      operationId: listModels
      tags:
      - Models
      summary: List generation models
      description: List available image.generate, image.edit and image.upscale models with pricing, tier, and capability metadata. Filter to a single job type with ?job=.
      parameters:
      - schema:
          type: string
          description: Filter to models supporting this job type
          example: image.generate
        required: false
        description: Filter to models supporting this job type
        name: job
        in: query
      responses:
        '200':
          description: List of generation models
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/GenModel'
                required:
                - data
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: Machine-readable error code
                      message:
                        type: string
                        description: Human-readable error message
                      details:
                        description: More about the error when there is more to say. A refusal lists its problems here as `{ path, message, upgradeTo? }`, where `upgradeTo` names the cheapest plan that runs it (null when only an enterprise plan does).
                    required:
                    - code
                    - message
                required:
                - error
components:
  schemas:
    GenModel:
      type: object
      properties:
        id:
          type: string
          description: Model identifier — pass as params.model
        jobs:
          type: array
          items:
            type: string
          description: Job types this model supports
        tier:
          type:
          - string
          - 'null'
          enum:
          - economy
          - standard
          - premium
          - null
          description: Pricing/quality tier alias, or null for a model with no tier alias
        underReview:
          type: boolean
          description: True while this model is pulled from tier resolution pending a cost/quality re-evaluation. Still listed for transparency, but submitting it (even by exact id) is rejected.
        priceTier:
          type: string
          enum:
          - $
          - $$
          - $$$
          - $$$$
          description: Relative price, cheapest ($) to priciest ($$$$). Not a dollar estimate.
        maxRefImages:
          type: integer
          description: Max reference images accepted (0 for generate-only models)
        steps:
          type:
          - object
          - 'null'
          properties:
            default:
              type: integer
            min:
              type: integer
            max:
              type: integer
          required:
          - default
          - min
          - max
          description: Denoising step range, or null when the model has a fixed step count
        supports:
          type: object
          properties:
            negativePrompt:
              type: boolean
            guidance:
              type: boolean
          required:
          - negativePrompt
          - guidance
        enhanceDefault:
          type: boolean
          description: Whether prompt enhancement defaults to on for this model
        status:
          type: string
          enum:
          - active
          description: Model availability status
      required:
      - id
      - jobs
      - tier
      - underReview
      - priceTier
      - maxRefImages
      - steps
      - supports
      - enhanceDefault
      - status
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key or OAuth access token
      description: 'Bearer authentication. Accepts an API key from https://app.rendobar.com/settings/api-keys (`Authorization: Bearer rb_xxx`) or an OAuth 2.1 access token. Both carry the same scopes and the same authority: what a caller may do is a property of the grant, not of how it authenticated.'
    oauth2:
      type: oauth2
      description: OAuth 2.1 with PKCE. Register a client at https://api.rendobar.com/oauth2/register or connect through an integration that does it for you. Scopes are granted at consent and carry the same authority as an API key holding them.
      flows:
        authorizationCode:
          authorizationUrl: https://api.rendobar.com/auth/oauth2/authorize
          tokenUrl: https://api.rendobar.com/auth/oauth2/token
          refreshUrl: https://api.rendobar.com/auth/oauth2/token
          scopes:
            jobs:read: See your jobs and their results
            jobs:write: Run and cancel jobs
            assets:read: See and download your files
            assets:write: Upload and delete files
            webhooks:read: See where your events are delivered
            webhooks:write: Manage where your events are delivered
            billing:read: See your plan, balance and usage
            billing:write: Change your plan and payment methods
            orgs:read: See your organization and its members
            orgs:write: Manage your organization and its members
            keys:read: See which API keys exist
            keys:write: Create and revoke API keys
            storage:read: See which storage connections exist
            storage:write: Connect, rotate and remove storage connections
externalDocs:
  description: Full developer documentation
  url: https://rendobar.com/docs/