> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sigmora.org/llms.txt
> Use this file to discover all available pages before exploring further.

# What this deployment can serve, and what it costs.

> The catalogue with live prices, plus each engine’s own account of itself. Check
this before planning around an operation marked as needing the GPU backend: the
same build on a CPU-only host genuinely cannot serve it and says so here rather
than failing at submit.

An engine that is unreachable reports `capabilities: null` with a reason in
`error`, keyed per engine — one being down never blanks the other.

Free.



## OpenAPI

````yaml /openapi.json get /v1/capabilities
openapi: 3.1.0
info:
  title: Sigmora API
  version: v1
  description: >-
    Whole pipelines as single calls: describe an object and get an animated 3D
    render;

    send raw footage and get an edited cut; hand over a transcript and get it
    captioned and

    dubbed with the cue timing intact.


    **Auth.** `Authorization: Bearer sk_live_...`. A key is bound to one
    workspace, so

    requests carry no tenant id. A session caller may instead name the workspace
    with an `x-workspace-slug` header.


    **Errors.** Every failure carries a stable `code` alongside its message.
    Branch on the

    code; the message is for humans.


    **Jobs.** Long-running work returns a job id, polled at `GET
    /v1/jobs/{jobId}` whatever

    produced it.


    **Projects.** Every call files its output in a project — the container
    holding the

    script, the footage, the renders and the thread that produced them. Pass
    `projectId`

    to choose one, or omit it and get a fresh project back in the response. The
    same

    containers appear in the dashboard, because it is the same API underneath.
servers:
  - url: https://api.sigmora.org
    description: Sigmora API
security:
  - apiKey: []
paths:
  /v1/capabilities:
    get:
      tags:
        - meta
      summary: What this deployment can serve, and what it costs.
      description: >-
        The catalogue with live prices, plus each engine’s own account of
        itself. Check

        this before planning around an operation marked as needing the GPU
        backend: the

        same build on a CPU-only host genuinely cannot serve it and says so here
        rather

        than failing at submit.


        An engine that is unreachable reports `capabilities: null` with a reason
        in

        `error`, keyed per engine — one being down never blanks the other.


        Free.
      operationId: capabilities.list
      responses:
        '200':
          description: Operations, engine reports and the workspace credit balance.
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - operations
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  version:
                    type: string
                  operations:
                    type: array
                    items:
                      type: object
                  engines:
                    type: object
                  creditBalance:
                    type: number
                additionalProperties: true
        '401':
          description: '`unauthorized`.'
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - error
                  - code
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: string
                    description: >-
                      Human-readable. Wording may change between releases — do
                      not match on it.
                  code:
                    type: string
                    enum:
                      - invalid_request
                      - unauthorized
                      - forbidden
                      - origin_not_allowed
                      - not_found
                      - conflict
                      - payload_too_large
                      - insufficient_credits
                      - budget_capped
                      - rate_limited
                      - capability_unavailable
                      - upstream_unavailable
                      - upstream_error
                      - internal_error
                    description: Stable machine-readable cause. Branch on this.
                  details:
                    description: >-
                      Optional structured context, e.g. which field failed
                      validation.
        '403':
          description: '`forbidden` / `origin_not_allowed`.'
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - error
                  - code
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: string
                    description: >-
                      Human-readable. Wording may change between releases — do
                      not match on it.
                  code:
                    type: string
                    enum:
                      - invalid_request
                      - unauthorized
                      - forbidden
                      - origin_not_allowed
                      - not_found
                      - conflict
                      - payload_too_large
                      - insufficient_credits
                      - budget_capped
                      - rate_limited
                      - capability_unavailable
                      - upstream_unavailable
                      - upstream_error
                      - internal_error
                    description: Stable machine-readable cause. Branch on this.
                  details:
                    description: >-
                      Optional structured context, e.g. which field failed
                      validation.
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: A workspace API key (`sk_live_...`), minted from workspace settings.

````