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

# Berry 1.0 Pro Turbo Video Generation Task

> Retrieve the status and result of a generation task

## Overview

Retrieve the status and result of a `berry-1.0-pro-turbo` generation task.

## Task Status

| Status | Description |
| :- | :- |
| `pending` | Task is waiting to be processed |
| `processing` | Task is currently being processed |
| `completed` | Task completed successfully |
| `failed` | Task failed with an error |

## Response

When the task is completed the response includes:

* `videos` — the generated video URLs at the requested resolution

## Example Response

### Completed Task

```json theme={null}
{
  "task_info": {
    "id": "b2f3a1c4-8d5e-4f60-9a7b-3c1d2e4f5a6b",
    "status": "completed",
    "created_at": "2026-08-21T00:00:00Z",
    "updated_at": "2026-08-21T00:06:00Z"
  },
  "videos": [
    "https://mulerouter.muleusercontent.com/public/b2f3a1c4-8d5e-4f60-9a7b-3c1d2e4f5a6b/result_000.mp4"
  ]
}
```

### Failed Task

```json theme={null}
{
  "task_info": {
    "id": "b2f3a1c4-8d5e-4f60-9a7b-3c1d2e4f5a6b",
    "status": "failed",
    "created_at": "2026-08-21T00:00:00Z",
    "updated_at": "2026-08-21T00:00:15Z",
    "error": {
      "code": 400,
      "title": "Invalid Request",
      "detail": "resolution must be one of 1080p / 2k / 4k"
    }
  }
}
```


## OpenAPI

````yaml api-reference/endpoint/carrothub/berry-1.0-pro-turbo/berry-1.0-pro-turbo.yaml GET /vendors/carrothub/v1/berry-1.0-pro-turbo/generation/{task_id}
openapi: 3.1.0
info:
  title: Berry1.0 Pro Turbo Video Generation API
  description: >-
    Generate videos with the Berry1.0 Pro Turbo all-in-one model at 1080p, 2K,
    or 4K. This is the

    faster tier of `berry-1.0-pro`: the request contract is

    identical field for field, the only differences being faster turnaround and
    a higher per-second

    price.


    A single `generation` endpoint covers three capability sets — the media
    fields you send decide which one runs:


    - **Text-to-video**: `prompt` only, no media fields.

    - **Image-to-video (keyframe mode)**: `first_frame` and/or `last_frame`.

    - **Reference-to-video (reference mode)**: `reference_images` /
    `reference_videos` / `reference_audios` / `file` / `link`.


    Keyframe mode and reference mode are mutually exclusive — a single request
    cannot mix fields from both.


    In reference mode the `prompt` may refer to inputs by index ("Image 1" /
    "Video 1"),

    counted separately per field in array order.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.carrothub.ai/
security:
  - bearerAuth: []
paths:
  /vendors/carrothub/v1/berry-1.0-pro-turbo/generation/{task_id}:
    get:
      summary: Get Generation Task
      description: Retrieve the status and result of a generation task
      operationId: berry_1_0_pro_turbo_generation_get
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Task result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Berry10ProTurboResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Berry10ProTurboResponse:
      type: object
      additionalProperties: true
      properties:
        task_info:
          $ref: '#/components/schemas/TaskInfoResponse'
        videos:
          type: array
          description: Generated video URLs (only present when status is completed).
          items:
            type: string
            format: uri
    ErrorResponse:
      type: object
      additionalProperties: true
      properties:
        task_info:
          $ref: '#/components/schemas/TaskInfoErrorResponse'
    TaskInfoResponse:
      type: object
      additionalProperties: true
      properties:
        id:
          type: string
          description: UUID of the task
          format: uuid
        status:
          type: string
          description: Task status
          enum:
            - completed
            - pending
            - processing
            - failed
        created_at:
          type: string
          description: Task creation timestamp (ISO 8601)
          format: date-time
        updated_at:
          type: string
          description: Task last update timestamp (ISO 8601)
          format: date-time
      required:
        - id
        - status
        - created_at
        - updated_at
    TaskInfoErrorResponse:
      type: object
      additionalProperties: true
      properties:
        id:
          type: string
          description: UUID of the task
          format: uuid
        status:
          type: string
          description: Task status (always failed for error responses)
          enum:
            - failed
        created_at:
          type: string
          description: Task creation timestamp (ISO 8601)
          format: date-time
        updated_at:
          type: string
          description: Task last update timestamp (ISO 8601)
          format: date-time
        error:
          $ref: '#/components/schemas/TaskInfoErrorObject'
      required:
        - id
        - status
        - created_at
        - updated_at
        - error
    TaskInfoErrorObject:
      type: object
      additionalProperties: true
      properties:
        code:
          type: integer
          description: CarrotHub Error code
          example: 2001
        title:
          type: string
          description: CarrotHub Error title
          example: Invalid Request
        detail:
          type: string
          description: CarrotHub Error detail
          example: >-
            resolution must be one of 1080p / 2k / 4k (480p / 720p are only
            available on berry-1.0-turbo)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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