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

> ## Agent Instructions
> For autonomous tasks, use live SaladCloud API responses for current state, availability, quotas, models, and other dynamic values. Use current OpenAPI specifications where provided for paths, schemas, required fields, and enums. Never invent endpoints, fields, prices, availability, quotas, models, or state. Prefer API workflows over Portal steps. Read before changing and never expose credentials, signed media URLs, prompts, or sensitive outputs. Retry only safe or idempotent operations with bounded backoff, honoring Retry-After. Verify every write with a read. Stop rather than repeat an uncertain non-idempotent or billable request. AI Gateway uses an organization-specific Bearer key and live /v1/models discovery. Do not delete, cancel, stop, or reduce capacity without explicit user intent. Bind shared operation IDs to the selected product path. Treat Container Engine instances as interruptible and local state as ephemeral. Install the SaladCloud skills (npx skills add https://docs.salad.com), start from the salad skill and /agents/overview; docs MCP: https://docs.salad.com/mcp.

# Create a job for Salad Transcription Lite API

> Creates a job for Salad Transcription Lite API



## OpenAPI

````yaml transcription-lite post /organizations/{organization_name}/inference-endpoints/transcription-lite/jobs
openapi: 3.0.3
info:
  title: Salad Transcription Lite API
  description: Salad Transcription Lite API
  termsOfService: https://salad.com/terms
  contact:
    name: SaladCloud Support
    url: https://salad.com
    email: cloud@salad.com
  license:
    name: MIT
  version: 0.9.0-alpha.5
servers:
  - url: https://api.salad.com/api/public
security:
  - ApiKeyAuth: []
tags:
  - name: container_groups
    description: Container Groups
  - name: inference_endpoints
    description: Inference Endpoints
  - name: organization_data
    description: Auxiliary organization data and info
  - name: queues
    description: Job Queues
  - name: quotas
    description: quotas
  - name: workload_errors
    description: Workload Errors
  - name: webhook_secret_key
    description: Webhook Secret Key
paths:
  /organizations/{organization_name}/inference-endpoints/transcription-lite/jobs:
    summary: Jobs for Salad Transcription Lite API
    description: Operations for Salad Transcription Lite API jobs
    parameters:
      - $ref: '#/components/parameters/organization_name'
    post:
      tags:
        - inference_endpoints
      summary: Create a job for Salad Transcription Lite API
      description: Creates a job for Salad Transcription Lite API
      operationId: create_inference_endpoint_job
      requestBody:
        $ref: '#/components/requestBodies/CreateSaladCloudTranscriptionLiteAPIJob'
      responses:
        '201':
          $ref: '#/components/responses/CreateSaladCloudTranscriptionLiteAPIJob'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
        '429':
          $ref: '#/components/responses/429'
        default:
          $ref: '#/components/responses/UnknownError'
components:
  parameters:
    organization_name:
      in: path
      name: organization_name
      required: true
      schema:
        type: string
        maxLength: 63
        minLength: 2
        pattern: ^[a-z][a-z0-9-]{0,61}[a-z0-9]$
      description: >-
        Your organization name. This identifies the billing context for the API
        operation and represents a security boundary for SaladCloud resources.
        The organization must be created before using the API, and you must be a
        member of the organization.
      example: acme-corp
  requestBodies:
    CreateSaladCloudTranscriptionLiteAPIJob:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CreateSaladCloudTranscriptionLiteAPIJob'
          examples:
            jsonExample:
              value:
                input:
                  property1: value1
                  property2: value2
                metadata:
                  property1: value1
                  property2: value2
                webhook: https://webhooks.example.com:8080
  responses:
    '400':
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
          examples:
            jsonExample:
              value:
                type: about:blank
                title: Bad Request
                status: 400
                detail: Bad Request
                instance: 60907fdc
    '404':
      description: Not Found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
          examples:
            jsonExample:
              value:
                type: about:blank
                title: Not Found
                status: 404
                detail: Not Found
                instance: 72ea5f29
    '429':
      description: Too Many Requests
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
          examples:
            jsonExample:
              value:
                type: about:blank
                title: Too Many Requests
                status: 409
                detail: Too Many Requests
                instance: cd6306ee
    CreateSaladCloudTranscriptionLiteAPIJob:
      description: Created
      headers:
        Location:
          schema:
            type: string
            example: >-
              /organizations/acme-corp/inference-endpoints/transcription-lite/jobs/123e4567-e89b-12d3-a456-426614174000
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SaladCloudTranscriptionLiteAPIJob'
          examples:
            jsonExample:
              value:
                id: 123e4567-e89b-12d3-a456-426614174000
                inference_endpoint_name: transcription-lite
                input:
                  property1: value1
                  property2: value2
                metadata: null
                organization_name: acme-corp
                status: pending
                events: []
                create_time: '2024-05-01T19:00:00Z'
                update_time: '2024-05-01T19:00:00Z'
    UnknownError:
      description: Unknown Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
          examples:
            jsonExample:
              value:
                type: about:blank
                title: Unknown Error
                status: 500
                detail: Unknown Error
                instance: 188f9bbb
  schemas:
    CreateSaladCloudTranscriptionLiteAPIJob:
      description: Create a job for Salad Transcription Lite API
      type: object
      properties:
        input:
          $ref: '#/components/schemas/SaladCloudTranscriptionLiteAPIInput'
        metadata:
          type: object
          maxProperties: 20
          nullable: true
        webhook:
          type: string
          format: url
          nullable: true
      additionalProperties: false
      required:
        - input
    SaladCloudTranscriptionLiteAPIJob:
      description: Job input schema for Salad Transcription Lite API
      type: object
      properties:
        id:
          type: string
          format: uuid
        input:
          $ref: '#/components/schemas/SaladCloudTranscriptionLiteAPIInput'
        inference_endpoint_name:
          description: The inference endpoint name
          type: string
        metadata:
          type: object
          maxProperties: 20
          nullable: true
        webhook:
          type: string
          format: url
          nullable: true
        status:
          type: string
          enum:
            - pending
            - running
            - succeeded
            - cancelled
            - failed
        events:
          type: array
          items:
            $ref: '#/components/schemas/InferenceEndpointJobEvent'
          maxItems: 1000
          minItems: 0
        organization_name:
          description: The organization name
          type: string
        output:
          $ref: '#/components/schemas/SaladCloudTranscriptionLiteAPIOutput'
        create_time:
          type: string
          format: date-time
        update_time:
          type: string
          format: date-time
      additionalProperties: false
      required:
        - id
        - input
        - status
        - events
        - create_time
        - update_time
        - inference_endpoint_name
        - organization_name
    ProblemDetails:
      description: Represents a problem
      type: object
      properties:
        type:
          description: The URI reference that identifies the problem type
          type: string
          default: about:blank
          nullable: true
        title:
          description: A short, human-readable summary of the problem type
          type: string
          nullable: true
        status:
          description: The HTTP status code generated by the origin server
          type: integer
          nullable: true
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem
          type: string
          nullable: true
        instance:
          description: >-
            The URI reference that identifies the specific occurrence of the
            problem
          type: string
          nullable: true
      additionalProperties: false
    SaladCloudTranscriptionLiteAPIInput:
      type: object
      properties:
        url:
          type: string
          format: uri
          description: URL of the audio file to process. Must be a downloadable link.
          example: https://example.com/audiofile.mp3
        language_code:
          type: string
          description: Language code for the transcription. Defaults to 'en' (English).
          example: en
        return_as_file:
          type: boolean
          default: false
          description: Whether to return the result as a file.
        sentence_level_timestamps:
          type: boolean
          default: false
          description: Return sentence-level timestamps in the transcription.
        word_level_timestamps:
          type: boolean
          default: false
          description: Return word-level timestamps in the transcription.
        diarization:
          type: boolean
          default: false
          description: >-
            Perform speaker diarization (separate speakers in multi-speaker
            audio).
        sentence_diarization:
          type: boolean
          default: false
          description: Perform sentence-level speaker diarization.
        srt:
          type: boolean
          default: false
          description: Generate an SRT file (SubRip Subtitle format).
        translate:
          type: string
          description: >-
            Translate the transcription to English (set to 'to eng' to enable
            translation).
          example: to_eng
      required:
        - url
      additionalProperties: false
    InferenceEndpointJobEvent:
      description: Represents an event for inference endpoint job
      type: object
      properties:
        action:
          type: string
          enum:
            - created
            - started
            - succeeded
            - cancelled
            - failed
        time:
          type: string
          format: date-time
      additionalProperties: false
      required:
        - action
        - time
    SaladCloudTranscriptionLiteAPIOutput:
      type: object
      properties:
        sentence_level_timestamps:
          type: array
          description: List of sentences with timestamps, speaker identification.
          items:
            type: object
            properties:
              text:
                type: string
                description: Transcribed sentence.
                example: You know that little voice in your head?
              timestamp:
                type: array
                items:
                  type: number
                  format: float
                description: Start and end times of the sentence in seconds.
                example:
                  - 0
                  - 5.9
              start:
                type: number
                format: float
                description: Start time of the sentence in seconds.
                example: 0
              end:
                type: number
                format: float
                description: End time of the sentence in seconds.
                example: 5.9
              speaker:
                type: string
                description: Identified speaker label.
                example: SPEAKER_02
            required:
              - text
              - start
              - end
              - speaker
        word_segments:
          type: array
          description: >-
            List of words with timestamps, confidence scores, and speaker
            identification.
          items:
            type: object
            properties:
              word:
                type: string
                description: Transcribed word.
                example: You
              start:
                type: number
                format: float
                description: Start time of the word in seconds.
                example: 4.274
              end:
                type: number
                format: float
                description: End time of the word in seconds.
                example: 4.395
              score:
                type: number
                format: float
                description: Confidence score for the transcribed word.
                example: 0.89
              speaker:
                type: string
                description: Identified speaker label.
                example: SPEAKER_02
            required:
              - word
              - start
              - end
              - score
              - speaker
        srt_content:
          type: string
          description: Generated SRT (SubRip Subtitle) content.
          example: |-
            1
            00:00:04,274 --> 00:00:05,880
            You know that little voice in your head?

            2
            00:00:10,506 --> 00:00:13,240
            The one that tells you to ignore a tasteless joke?
            ...
        text:
          type: string
          description: Full transcribed text from the audio.
          example: >-
            You know that little voice in your head? The one that tells you to
            ignore a tasteless joke? ...
        duration:
          type: number
          format: float
          description: Duration of the audio file in hours.
          example: 0.04
        processing_time:
          type: number
          format: float
          description: Time taken to process the transcription in seconds.
          example: 69.79421997070312
      required:
        - text
        - duration
        - processing_time
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Salad-Api-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.