Ausca Transcribe Media API

openapi: 3.2.0
info:
  contact:
    name: Ausca
    url: https://ausca.com
  description: Transport-neutral paid invocations, keyless artifact ingress, and focused browser-session and receive-only inbox lease control.
  title: Ausca Transcribe Media API
  version: 1.3.1
  x-guidance: Start with https://ausca.com/SKILL.md, resolve an immutable offer before acting, and reuse the same invocation bytes and idempotency key after an uncertain response.
servers:
- url: https://ausca.com
security: []
tags:
- name: Transcribe Media
paths:
  /v1/transcribe-media:
    get:
      description: Returns the same inert floor-priced x402 v2 challenge as an unsigned POST probe. This diagnostic read is not payable and creates no invocation, payment, artifact, or receipt; submit a complete POST body to receive offer-specific terms.
      responses:
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResult'
          description: Current floor-priced external payment requirement
          headers:
            PAYMENT-REQUIRED:
              description: Standard-base64 encoded external x402 v2 PaymentRequired value
              required: true
              schema:
                maxLength: 65536
                minLength: 1
                type: string
        default:
          $ref: '#/components/responses/ErrorResponse'
      security: []
      summary: Read invocation payment requirements
      tags:
      - Transcribe Media
      operationId: getV1TranscribeMedia
      x-operation-id-source: derived
    post:
      description: Admit or replay one idempotent paid Media Transcription invocation when settlement authority is supplied by the host boundary. Only envelopes for the media.transcription offer are admitted on this resource. The public MCP transport keeps this tool disabled; paid callers use the canonical HTTP resource.
      operationId: TranscribeMedia
      parameters:
      - description: Standard-base64 encoded external x402 v2 PaymentPayload value
        in: header
        name: PAYMENT-SIGNATURE
        required: false
        schema:
          maxLength: 65536
          minLength: 1
          type: string
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                idempotency_key:
                  maxLength: 128
                  minLength: 16
                  type: string
                input: {}
                input_schema_digest:
                  pattern: ^sha256:[a-f0-9]{64}$
                  type: string
                offer_id:
                  maxLength: 128
                  minLength: 1
                  pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
                  type: string
                offer_revision:
                  maxLength: 128
                  minLength: 1
                  pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
                  type: string
                offer_revision_digest:
                  pattern: ^sha256:[a-f0-9]{64}$
                  type: string
                output_schema_digest:
                  pattern: ^sha256:[a-f0-9]{64}$
                  type: string
              required:
              - offer_id
              - offer_revision
              - offer_revision_digest
              - input_schema_digest
              - output_schema_digest
              - input
              - idempotency_key
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvokeOfferResult'
          description: Admission, replay, or semantic refusal
          headers:
            PAYMENT-RESPONSE:
              description: Standard-base64 encoded external x402 v2 SettleResponse value on admission or replay
              required: false
              schema:
                maxLength: 65536
                minLength: 1
                type: string
        '202':
          $ref: '#/components/responses/AsyncInvocationResponse'
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResult'
          description: External payment authority is required before invocation admission
          headers:
            PAYMENT-REQUIRED:
              description: Standard-base64 encoded external x402 v2 PaymentRequired value
              required: true
              schema:
                maxLength: 65536
                minLength: 1
                type: string
        default:
          $ref: '#/components/responses/ErrorResponse'
      security: []
      summary: Admit or replay one Media Transcription invocation
      x-ausca-mcp:
        destructive: true
        enabledByDefault: false
        idempotent: true
        inputSchema: '#/components/schemas/InvokeOfferRequest'
        name: ausca_transcribe_media
        openWorld: true
        readOnly: false
        resultSchema: '#/components/schemas/InvokeOfferResult'
      x-ausca-payable: true
      x-payment-info:
        price:
          amount: '0.40'
          currency: USD
          max: '1.30'
          min: '0.40'
          mode: dynamic
        protocols:
        - x402: {}
      tags:
      - Transcribe Media
components:
  schemas:
    BrowserResourceAccess:
      additionalProperties: false
      properties:
        capability:
          $ref: '#/components/schemas/LeaseCapability'
        expires_at:
          format: date-time
          type: string
        kind:
          const: browser_session
        session_id:
          $ref: '#/components/schemas/BrowserSessionID'
      required:
      - kind
      - session_id
      - capability
      - expires_at
      type: object
    Identifier:
      maxLength: 128
      minLength: 1
      pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
      type: string
    BrowserSessionID:
      pattern: ^brs_[A-Za-z0-9_-]{22,64}$
      type: string
    ErrorResult:
      additionalProperties: false
      properties:
        code:
          enum:
          - invalid_request
          - not_found
          - conflict
          - payment_required
          - unavailable
          - upstream_error
          - gone
          - rate_limited
          - attachment_blocked
          type: string
        inspect_url:
          description: Recovery status URL when payment settled but delivery failed.
          type: string
        invocation_id:
          $ref: '#/components/schemas/Identifier'
        message:
          maxLength: 512
          minLength: 1
          type: string
        status:
          const: error
      required:
      - status
      - code
      - message
      type: object
    InvocationFailure:
      additionalProperties: false
      properties:
        code:
          maxLength: 96
          minLength: 1
          type: string
        message:
          maxLength: 500
          minLength: 1
          type: string
      required:
      - code
      - message
      type: object
    ReceiptReference:
      additionalProperties: false
      properties:
        public_url:
          description: Unguessable public verification page for the privacy-bounded hash-only proof. It reveals the receipt digest, service, public price, and completion time, but not input bytes, output bytes, or their content digests.
          format: uri
          maxLength: 2048
          pattern: ^https://[^?#]+/r/[a-f0-9]{64}$
          type: string
        type:
          const: receipt
        uri:
          description: Opaque receipt identity minted by the notary. Relay it unchanged; its form is not part of the contract.
          maxLength: 512
          minLength: 1
          type: string
      required:
      - type
      - uri
      type: object
    RefusedResult:
      additionalProperties: false
      properties:
        code:
          enum:
          - offer_unavailable
          - schema_mismatch
          - quote_expired
          - terms_changed
          - replay_conflict
          - payment_authority_required
          - payment_not_authorized
          - capacity_unavailable
          - not_found
          - cancellation_not_available
          - artifact_gone
          type: string
        reason:
          maxLength: 512
          minLength: 1
          type: string
        status:
          const: refused
      required:
      - status
      - code
      - reason
      type: object
    InboxExtensionAuthorization:
      description: Opaque authority limited to paid extension of one inbox. It cannot read messages, fetch attachments, or delete the inbox; keep it in host-controlled state and supply it only to the agent-inbox extension runner.
      maxLength: 47
      minLength: 47
      pattern: ^aue_[A-Za-z0-9_-]{43}$
      type: string
      writeOnly: true
    InvokeOfferResult:
      oneOf:
      - $ref: '#/components/schemas/AcceptedInvocation'
      - $ref: '#/components/schemas/ReplayedInvocation'
      - $ref: '#/components/schemas/RefusedResult'
    AcceptedInvocation:
      additionalProperties: false
      properties:
        inspect_url:
          description: Same-origin canonical readback path for this invocation.
          pattern: ^/v1/invocations/[A-Za-z0-9][A-Za-z0-9._:-]*$
          type: string
        invocation:
          $ref: '#/components/schemas/InvocationState'
        resource_access:
          $ref: '#/components/schemas/ResourceAccess'
        status:
          const: accepted
      required:
      - status
      - invocation
      - inspect_url
      type: object
    InvocationState:
      additionalProperties: false
      properties:
        failure:
          $ref: '#/components/schemas/InvocationFailure'
        invocation_id:
          $ref: '#/components/schemas/Identifier'
        offer_revision_digest:
          $ref: '#/components/schemas/Digest'
        output: {}
        output_artifact:
          $ref: '#/components/schemas/ArtifactEvidence'
        output_digest:
          $ref: '#/components/schemas/Digest'
        receipt_ref:
          $ref: '#/components/schemas/ReceiptReference'
        state:
          enum:
          - admitted
          - running
          - succeeded
          - failed
          - cancellation_requested
          - cancelled
          type: string
        updated_at:
          format: date-time
          type: string
      required:
      - invocation_id
      - offer_revision_digest
      - state
      - updated_at
      type: object
    ArtifactEvidence:
      additionalProperties: false
      properties:
        artifact_uri:
          $ref: '#/components/schemas/ArtifactUri'
        content_digest:
          $ref: '#/components/schemas/Digest'
        created_at:
          format: date-time
          type: string
        media_type:
          maxLength: 200
          minLength: 1
          type: string
        size_bytes:
          maximum: 26214400
          minimum: 1
          type: integer
      required:
      - artifact_uri
      - content_digest
      - media_type
      - size_bytes
      - created_at
      type: object
    ResourceAccess:
      oneOf:
      - $ref: '#/components/schemas/BrowserResourceAccess'
      - $ref: '#/components/schemas/AgentInboxResourceAccess'
    LeaseCapability:
      description: Opaque bearer returned only by paid create or its exact authenticated replay. Never log, persist in plaintext, place in a receipt, or send as a model-authored argument.
      maxLength: 128
      minLength: 43
      pattern: ^auc_[A-Za-z0-9_-]{39,124}$
      type: string
      writeOnly: true
    AgentInboxID:
      pattern: ^inb_[A-Za-z0-9_-]{22,64}$
      type: string
    ArtifactUri:
      description: Opaque artifact reference minted by artifact commitment. Relay it unchanged; its form is not part of the contract.
      maxLength: 512
      minLength: 1
      type: string
    AgentInboxResourceAccess:
      additionalProperties: false
      properties:
        capability:
          $ref: '#/components/schemas/LeaseCapability'
        expires_at:
          format: date-time
          type: string
        extension_authorization:
          $ref: '#/components/schemas/InboxExtensionAuthorization'
        inbox_id:
          $ref: '#/components/schemas/AgentInboxID'
        kind:
          const: agent_inbox
      required:
      - kind
      - inbox_id
      - capability
      - extension_authorization
      - expires_at
      type: object
    Digest:
      pattern: ^sha256:[a-f0-9]{64}$
      type: string
    ReplayedInvocation:
      additionalProperties: false
      properties:
        inspect_url:
          description: Same-origin canonical readback path for this invocation.
          pattern: ^/v1/invocations/[A-Za-z0-9][A-Za-z0-9._:-]*$
          type: string
        invocation:
          $ref: '#/components/schemas/InvocationState'
        resource_access:
          $ref: '#/components/schemas/ResourceAccess'
        status:
          const: replayed
      required:
      - status
      - invocation
      - inspect_url
      type: object
  responses:
    ErrorResponse:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResult'
      description: Transport or infrastructure failure
    AsyncInvocationResponse:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/InvokeOfferResult'
      description: Invocation admitted and still running; poll the invocation handle. Resource offers expose authority only on the exact authenticated replay after completion.
      headers:
        PAYMENT-RESPONSE:
          description: Standard-base64 encoded external x402 v2 SettleResponse value for the admitted invocation
          required: false
          schema:
            maxLength: 65536
            minLength: 1
            type: string
  securitySchemes:
    LeaseCapability:
      bearerFormat: opaque
      description: Opaque expiry-bound authority for one Ausca resource lease. Never place it in JSON, query parameters, MCP tool arguments, logs, or receipts.
      scheme: bearer
      type: http
x-ausca-mcp-server:
  description: 'Agent infrastructure on demand: discover and control metered, keyless services with explicit pricing, bounded payment authority, and receipt-backed results.'
  icon:
    mimeType: image/svg+xml
    size: any
    src: https://ausca.com/favicon.svg
  instructions: 'Use search and get to resolve an immutable offer before acting. Paid tools take x402 v2 payment only in params._meta["x402/payment"], never in tool arguments: a call without it moves no money and returns the PaymentRequired as an isError result''s structuredContent; retry the same arguments with the signed PaymentPayload and read settlement evidence from result._meta["x402/payment-response"]. For an offer without a listed paid tool, follow the selected service SKILL.md and use its canonical HTTP invocation resource. Browser and inbox lifecycle tools take their lease bearer from the MCP HTTP request Authorization header, never from tool arguments.'
  name: ausca
  registry:
    description: Pay-per-call APIs and MCP services for agents, no accounts or keys, with verifiable receipts.
    name: com.ausca/agent-services
    package:
      argument: mcp
      identifier: ausca
      registryType: npm
      runtimeHint: npx
      version: 0.1.0
    version: 1.2.6
  title: Ausca