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

# Create Async Job

> Create an async job for long-running AI operations.

Model format: feature/subfeature/provider[/model]

Supported async features:
- audio/speech_to_text_async

Request body:
- model: Model string in format feature/subfeature/provider[/model]
- input: Feature-specific input parameters
- fallbacks: Optional list of fallback provider strings (max 3)
- webhook_receiver: Optional URL to receive job completion notification
- user_webhook_parameters: Optional custom parameters for webhook payload

Returns 202 Accepted with job info for polling.



## OpenAPI

````yaml https://api.edenai.run/v3/docs/openapi.json post /v3/universal-ai/async
openapi: 3.1.0
info:
  title: Eden AI API V3
  version: 3.0.0
servers:
  - url: https://api.edenai.run
    description: Production server
security: []
paths:
  /v3/universal-ai/async:
    post:
      tags:
        - universal-ai
        - universal-ai
      summary: Create Async Job
      description: >-
        Create an async job for long-running AI operations.


        Model format: feature/subfeature/provider[/model]


        Supported async features:

        - audio/speech_to_text_async


        Request body:

        - model: Model string in format feature/subfeature/provider[/model]

        - input: Feature-specific input parameters

        - fallbacks: Optional list of fallback provider strings (max 3)

        - webhook_receiver: Optional URL to receive job completion notification

        - user_webhook_parameters: Optional custom parameters for webhook
        payload


        Returns 202 Accepted with job info for polling.
      operationId: create_async_job_v3_universal_ai_async_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UniversalAIAsyncBody'
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UniversalAIAsyncResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - AuthBearer: []
components:
  schemas:
    UniversalAIAsyncBody:
      properties:
        model:
          type: string
          title: Model
          description: 'Model in format: feature/subfeature/provider[/model]'
          examples:
            - text/ai_detection/openai/gpt-4
            - ocr/ocr/amazon
            - image/generation/google/imagen-3
        provider_params:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Provider Params
          description: Provider-specific parameters
        input:
          additionalProperties: true
          type: object
          title: Input
          description: >-
            Feature-specific input parameters. Required fields depend on the
            feature/subfeature specified in provider. Examples:

            - text/ai_detection: {'text': 'content to analyze'}

            - text/embeddings: {'texts': ['text1', 'text2']}

            - ocr/ocr: {'file_id': 'abc123', 'language': 'en'}

            - image/generation: {'text': 'prompt', 'resolution': '1024x1024'}

            - translation/document_translation: {'file_id': 'abc123',
            'target_language': 'fr'}
          examples:
            - text: Analyze this text for AI detection
            - dimensions: 512
              texts:
                - text1
                - text2
            - file_id: abc123
              language: en
        fallbacks:
          items:
            type: string
          type: array
          maxItems: 3
          title: Fallbacks
          description: >-
            Fallback providers to try if the primary provider fails, in order.
            Accepted formats:
              - 'provider' or 'provider/model' (e.g. 'amazon', 'openai/gpt-4')
              - full model id (e.g 'text/moderation/google', 'image/generation/minimax/image-01')
        show_original_response:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Show Original Response
          description: Include raw provider response in the output
          default: false
        webhook_receiver:
          anyOf:
            - type: string
              maxLength: 2083
              minLength: 1
              format: uri
            - type: 'null'
          title: Webhook Receiver
          description: Webhook URL to receive job completion notification
        user_webhook_parameters:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: User Webhook Parameters
          description: Custom parameters to include in webhook payload
      type: object
      required:
        - model
        - input
      title: UniversalAIAsyncBody
      description: |-
        Universal AI async request body.

        Extends UniversalAIBody with webhook parameters for async notifications.
    UniversalAIAsyncResponse:
      properties:
        status:
          type: string
          enum:
            - success
            - fail
            - processing
          title: Status
          description: 'Request status: success, fail, or processing (async only)'
        cost:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Cost
          description: Cost in credits for this request
        provider:
          type: string
          title: Provider
          description: Provider name that processed the request
        feature:
          type: string
          title: Feature
          description: Feature category (e.g., text, ocr, image)
        subfeature:
          type: string
          title: Subfeature
          description: Specific subfeature (e.g., ai_detection, sentiment)
        output:
          anyOf:
            - {}
            - type: 'null'
          title: Output
          description: Normalized output from the provider
        error:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Error
          description: Error details from the provider (only present when status is 'fail')
        original_response:
          anyOf:
            - {}
            - type: 'null'
          title: Original Response
          description: Raw response from the provider (if show_original_response=true)
        public_id:
          type: string
          title: Public Id
          description: Job ID for polling status
        model:
          anyOf:
            - type: string
            - type: 'null'
          title: Model
          description: Model name if specified in the request
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Job creation timestamp
      type: object
      required:
        - status
        - cost
        - provider
        - feature
        - subfeature
        - public_id
        - created_at
      title: UniversalAIAsyncResponse
      description: >-
        Async response from universal-ai/async endpoint.


        Inherits base fields and adds job-specific fields for tracking async
        operations.

        Used for both job creation (202 Accepted) and job detail (GET)
        responses.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    AuthBearer:
      type: http
      scheme: bearer

````