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

# Create transcription

> استخدم CometAPI POST /v1/audio/transcriptions لتفريغ الصوت إلى نص باستخدام model تفريغ محدد وتنسيق response مختار.

استخدم نقطة النهاية هذه لتفريغ الصوت إلى نص باللغة المصدر. وهي مناسبة لملاحظات الاجتماعات، والرسائل الصوتية، وفهرسة الوسائط، والتسميات التوضيحية، وسير عمل الدعم التي تحتاج إلى نص قابل للبحث.

## أول request

أرسل ملفًا صوتيًا مدعومًا مع `model` و`file`. اجعل الملف الأول قصيرًا أثناء التحقق من معالجة الرفع، والمصادقة، وتحليل response.

## قراءة response

يتضمن response الافتراضي `text` الذي تم تفريغه. إذا طلبت تنسيق response آخر، فتأكد من أن العميل لديك يحلل ذلك التنسيق بدلًا من افتراض بنية JSON الافتراضية.

## الخطوات التالية

* استخدم [Create Speech](/api/audio/create-speech) عندما تحتاج إلى مخرجات تحويل النص إلى كلام.
* استخدم [Create Translation](/api/audio/create-translation) عندما يجب أن تكون المخرجات المستهدفة باللغة الإنجليزية.


## OpenAPI

````yaml api/openapi/audio/post-create-transcription.openapi.json POST /v1/audio/transcriptions
openapi: 3.1.0
info:
  title: Create transcription API
  version: 1.0.0
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /v1/audio/transcriptions:
    post:
      summary: Create transcription
      operationId: create_transcription
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  format: binary
                  type: string
                  description: >-
                    The audio file to transcribe. Supported formats: flac, mp3,
                    mp4, mpeg, mpga, m4a, ogg, wav, webm.
                model:
                  type: string
                  description: >-
                    The speech-to-text model to use. Choose a current speech
                    model from the [Models page](/overview/models).
                  default: whisper-1
                language:
                  type: string
                  description: >-
                    The language of the input audio in ISO-639-1 format (e.g.,
                    `en`, `zh`, `ja`). Supplying the language improves accuracy
                    and latency.
                prompt:
                  type: string
                  description: >-
                    Optional text to guide the model's style or continue a
                    previous audio segment. The prompt should match the audio
                    language.
                response_format:
                  type: string
                  description: The output format for the transcription.
                  enum:
                    - json
                    - text
                    - srt
                    - verbose_json
                    - vtt
                  default: json
                temperature:
                  type: number
                  description: >-
                    Sampling temperature between 0 and 1. Higher values produce
                    more random output; lower values are more focused. When set
                    to 0, the model auto-adjusts temperature using log
                    probability.
                  minimum: 0
                  maximum: 1
                  default: 0
              required:
                - file
                - model
      responses:
        '200':
          description: The transcription result.
          content:
            application/json:
              schema:
                type: object
                required:
                  - text
                properties:
                  text:
                    type: string
                    description: The transcribed text.
              examples:
                Default:
                  summary: Transcription result
                  value:
                    text: Hello, welcome to CometAPI.
      x-codeSamples:
        - lang: python
          label: Create transcription
          source: |-
            import os
            from openai import OpenAI

            client = OpenAI(
                api_key=os.environ["COMETAPI_KEY"],
                base_url="https://api.cometapi.com/v1"
            )

            audio_file = open("audio.mp3", "rb")
            transcription = client.audio.transcriptions.create(
                model="whisper-1",
                file=audio_file
            )
            print(transcription.text)
        - lang: javascript
          label: Create transcription
          source: |-
            import OpenAI from "openai";
            import fs from "fs";

            const client = new OpenAI({
              apiKey: process.env.COMETAPI_KEY,
              baseURL: "https://api.cometapi.com/v1"
            });

            const transcription = await client.audio.transcriptions.create({
              model: "whisper-1",
              file: fs.createReadStream("audio.mp3")
            });
            console.log(transcription.text);
        - lang: shell
          label: Create transcription
          source: |-
            curl -X POST https://api.cometapi.com/v1/audio/transcriptions \
              -H "Authorization: Bearer $COMETAPI_KEY" \
              -F model="whisper-1" \
              -F file="@audio.mp3"
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication. Use your CometAPI key.

````