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

# Create Input Audio API Endpoint

> This API endpoint allows a user to create a new input audio record.



## OpenAPI

````yaml post /api/input-audio/create/
openapi: 3.0.1
info:
  title: ClipVision API
  description: ClipVision AI API
  termsOfService: https://www.clipvision.ai/terms/
  contact:
    email: help@clipvision.ai
  license:
    name: ClipVision License
  version: v1
servers:
  - url: https://backend.clipvision.ai/
security:
  - Basic: []
  - api_key: []
paths:
  /api/input-audio/create/:
    post:
      tags:
        - api
      summary: Create Input Audio API Endpoint
      description: This API endpoint allows a user to create a new input audio record.
      operationId: create_input_audio
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateInputAudio'
        required: true
      responses:
        '201':
          description: Successfully created the input audio
          content:
            application/json:
              schema:
                title: Audio
                type: object
                properties:
                  audio_id:
                    type: integer
                  disabled:
                    type: boolean
                  download_link:
                    type: string
                  transcription:
                    type: string
                  creation_date:
                    type: string
                description: Audio OpenAPI Schema
              example:
                audio_id: 1
                disabled: false
                download_link: https://clipvision.ai/download/audio/32abbmssfn.mp3
                transcription: >-
                  {"text":" Bonjour! Est-ce que vous allez
                  bien?","segments":[{"id":0,"seek":0,"start":0.5,"end":1.2,"text":"
                  Bonjour!","tokens":[25431,2298],"temperature":0.0,"avg_logprob":-0.6674491882324218,"compression_ratio":0.8181818181818182,"no_speech_prob":0.10241222381591797,"confidence":0.51,"words":[{"text":"Bonjour!","start":0.5,"end":1.2,"confidence":0.51}]},{"id":1,"seek":200,"start":2.02,"end":4.48,"text":"
                  Est-ce que vous allez
                  bien?","tokens":[50364,4410,12,384,631,2630,18146,3610,2506,50464],"temperature":0.0,"avg_logprob":-0.43492694334550336,"compression_ratio":0.7714285714285715,"no_speech_prob":0.06502953916788101,"confidence":0.595,"words":[{"text":"Est-ce","start":2.02,"end":3.78,"confidence":0.441},{"text":"que","start":3.78,"end":3.84,"confidence":0.948},{"text":"vous","start":3.84,"end":4.0,"confidence":0.935},{"text":"allez","start":4.0,"end":4.14,"confidence":0.347},{"text":"bien?","start":4.14,"end":4.48,"confidence":0.998}]}],"language":"fr"}
                creation_date: '2024-03-17T00:00:00.000Z'
        '400':
          description: Failed to create the input audio or validation errors
          content: {}
        '500':
          description: Failed to create the input audio
          content:
            application/json:
              schema:
                title: Internal Server Error
                type: object
                properties:
                  success:
                    type: boolean
                    default: false
                  error:
                    type: string
                    default: Internal Server Error
                description: Internal Server Error OpenAPI Schema
              example:
                success: false
                error: Internal Server Error
components:
  schemas:
    CreateInputAudio:
      required:
        - file_path
      type: object
      properties:
        file_path:
          title: File path
          type: string
          enum:
            - ''
            - local_files/audios/02789d243479f71ae3bb2122219fdb04.aac
            - local_files/audios/0957bdd3eae6055a19e89646164377a5.aac
            - local_files/audios/0cd791f534eb0254f8e0382b3a221650.aac
            - local_files/audios/0eda8e4d068ed2a1a4990bd64b0b4f71.aac
            - local_files/audios/10c0d96d099526490d3b890e820b0d93.aac
            - local_files/audios/156fa3e4dcc6cbbb1d50c1f544d9ee2e.opus
            - local_files/audios/1aa5b172ae173d0389da13c3125fd8cb.aac
            - local_files/audios/1d5297533a0997ee566410f2170c58d5.aac
            - local_files/audios/1fd63e44179ba2026543755a24599b75.aac
            - local_files/audios/20c8e3687de31540ecf8858e8bf606bc.aac
            - local_files/audios/21af1d488a0e26d7b240a03626d36a48.aac
            - local_files/audios/224ed618afaf5bc20517125e5b0c8a70.aac
            - local_files/audios/24c58de2bab8da461518ffc26b2dad25.aac
            - local_files/audios/27c6656056e860825725fbad58140c48.aac
            - local_files/audios/286501f5720c5264e9f05a9cf96d762d.aac
            - local_files/audios/290105a58bf25c5e4dae0d425fef06c3.aac
            - local_files/audios/2db13f21e4065ce2d5c857a3d898aa00.aac
            - local_files/audios/2de476c222789ce48a470d0f7b0697e0.aac
            - local_files/audios/31ad8d630d26fca7473916e3002ccb1a.aac
            - local_files/audios/35b327b46b46ed1ea97912a38a166576.aac
            - local_files/audios/3775de161cebce8ceffe4ca69dcd42cb.aac
            - local_files/audios/37b40f6367593a0fcda4f0a2455ce43c.aac
            - local_files/audios/3ee3683ab214f4d36dd527185a7e7e1b.aac
            - local_files/audios/430d38416fc47380624b8f56d0305bbc.aac
            - local_files/audios/4351d04ff86d009a0fe7fbfc525e4c7c.aac
            - local_files/audios/477786973336df062be4a5eca4f71d18.aac
            - local_files/audios/4dd5ba38bfc5e830e225b6e29c38752a.aac
            - local_files/audios/51feb9695d7e7b9d90d8484fc5fba83a.aac
            - local_files/audios/55730bd1e962b8bf5e9c9b81fb16aca4.aac
            - local_files/audios/56dd34ca9269a7d19d3a6531ad3ffa67.aac
            - local_files/audios/6080fe3a5d3706ff18d8b48a9ab2494b.aac
            - local_files/audios/6971cc04d4ea38563b23e85c8b8dffc6.aac
            - local_files/audios/6c64cc77c6fc9d34df3f5dd233e34cbb.aac
            - local_files/audios/703dd70a0310022d158fb88f0238b118.aac
            - local_files/audios/722e722f3619800d501e7e2c0129a5ff.aac
            - local_files/audios/72d2cf45ea243c6bc756a6e4f583a0ee.aac
            - local_files/audios/7ae3e6e33e274e474c91c79edaf74af8.aac
            - local_files/audios/7de8dd7addfeea3d64428320f849b2ed.aac
            - local_files/audios/7e9e7d1bb9e7e7601ab0d8bdfedd299f.aac
            - local_files/audios/80b414a540aec7fcfe5b4bc4474d9ea7.opus
            - local_files/audios/81aa537032bb52c8941ed0352612abf5.opus
            - local_files/audios/86fa2be36b3944ff2ad20377fd997b06.aac
            - local_files/audios/8a4a0dad926b13baafdcc973ef35330b.aac
            - local_files/audios/8aea836b69d7ff41064b6f78e0dad519.opus
            - local_files/audios/8b71ab137a2689fc46c6441cb748f76e.aac
            - local_files/audios/8ea6f9151795ca0a07ae128a0b9792dc.aac
            - local_files/audios/90b7d0911143e146370353761ef656fd.aac
            - local_files/audios/93cbe6e6fb6c2dbe954d575e8877b474.aac
            - local_files/audios/97169ace53796baa7749e40ffcf66281.aac
            - local_files/audios/9b4fae2861b9158540eae3f0a4edeae6.aac
            - local_files/audios/9d121ea4d898efd2b2e0287c2ff019da.opus
            - local_files/audios/9d6174119e36abe27a78e4f07df6eaf3.aac
            - local_files/audios/a6f3c5ecd1046efc380cc1fd4252dc56.aac
            - local_files/audios/ab63fdf85cfce0b3b6203d470802e6e9.aac
            - local_files/audios/ab7493b556c99a4d9c9fa3459782ae58.aac
            - local_files/audios/aca89e7bdad57233eaf3ed3ae2303ed1.aac
            - local_files/audios/b293c80a4f7d83d17ffc695b47ad93b2.aac
            - local_files/audios/bad68b5108b9fd3568d7017812df9b28.aac
            - local_files/audios/bf454e25d80cad4794c1a0845e02007a.aac
            - local_files/audios/bf88f11795c7ab6ea63b3734d5916a19.aac
            - local_files/audios/bf8b0217d1f882a46cf331da73c54e17.opus
            - local_files/audios/c300a517adc38e97fdd8dd6b410ef0a2.aac
            - local_files/audios/c5825125329c9de8e12a6d311eaf2dda.aac
            - local_files/audios/c8bf21615de412b70be1b20a4b98ef90.aac
            - local_files/audios/c8cd23f21607690335bc262cefc43b22.opus
            - local_files/audios/c96432caad3844ae5f736b27d5223bc0.aac
            - local_files/audios/ce7492bd4e1b70614ddd29572b4d6d50.aac
            - local_files/audios/d0adb5c1fda2a5cd49b7b7da22fcc37f.aac
            - local_files/audios/d630235add62b377fcc0732d7f0f2523.aac
            - local_files/audios/d6597ba24a4f7c424b533269e736be7f.aac
            - local_files/audios/d83404212c4e820b690bf9c1d901ee2c.aac
            - local_files/audios/dee425a35384147519836440b7402dc4.opus
            - local_files/audios/e78ea038db161a0f11529b5ead8f9fc2.aac
            - local_files/audios/e949a05c974df04a0cd3a403ac8753b7.aac
            - local_files/audios/ea0dfbda62197aa8ec40b70338952f94.opus
            - local_files/audios/ec68bca0e46d941b86d5c046ef5e06ab.aac
            - local_files/audios/f09da05c0abfe64d4e091c5da477e3a9.aac
            - local_files/audios/f23f065e7bc3f95241e67ec16c905eec.aac
            - local_files/audios/f7c7df6139cf4ba55671e7f01ded4f1e.aac
            - local_files/audios/fa36a98c2ddc6b72dd5fa0eddc23372e.aac
            - local_files/audios/fe8abcc1814dfdff5ce9aca0b7969ba2.aac
            - local_files/audios/ffcbe3d55875147140ecc0951b70a7d0.aac
            - local_files/audios/placeholder.mp3
        transcription:
          title: Transcription
          minLength: 1
          type: string
  securitySchemes:
    Basic:
      type: http
      scheme: basic
    api_key:
      type: apiKey
      name: User-JWT
      in: header

````