> ## 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.

# Hent en Runway-oppgave

> Hent status og utdata-URL-er for bilde-, video- eller lydoppgaver for Runway-forespørsler via CometAPI.

Bruk dette endepunktet med `id` som returneres av enhver `/runwayml/v1`-opprettelses
forespørsel. Autentiser med en CometAPI API-nøkkel fra samme konto som
opprettet oppgaven.

## Følg oppgavestatusen

Responsen er et oppgaveobjekt. Les `id`, `status` og `output` direkte
fra responsen, uten en `data`-innpakning.

| `status`                             | Neste trinn                                                            |
| ------------------------------------ | ---------------------------------------------------------------------- |
| Mangler, `PENDING` eller `THROTTLED` | Vent noen sekunder, og hent oppgaven på nytt.                          |
| `RUNNING`                            | Fortsett å polle. `progress`, når den finnes, er en brøk fra 0 til 1.  |
| `SUCCEEDED`                          | Les resultat-URL-er fra `output`.                                      |
| `FAILED`                             | Stopp pollingen og undersøk `failure` og `failureCode`, når de finnes. |
| `CANCELLED`                          | Stopp pollingen; oppgaven ble kansellert.                              |

En nylig sendt oppgave kan kortvarig returnere HTTP `400` med
`code: "task_not_exist"`. Vent noen sekunder, og prøv på nytt med samme `id`.
Hvis dette fortsetter, kontrollerer du oppgave-ID-en og kontoen som ble brukt til autentisering.
Ikke send opprettelsesforespørselen på nytt for å kontrollere statusen.

## Lagre utdataene

Arrayet `output` inneholder URL-er til bilder, videoer eller lyd, avhengig av
opprettelsesendepunktet og det valgte formatet. Last ned fullførte ressurser straks
og lagre dem i din egen lagring. Resultat-URL-ene er midlertidige.

For en ny integrasjon velger du en modell og et opprettelsesendepunkt i
[Runway-oversikten](/no/api/video/runway/overview).


## OpenAPI

````yaml api/openapi/video/runway/official-format/get-runway-to-get-task-details.openapi.json GET /runwayml/v1/tasks/{id}
openapi: 3.1.0
info:
  title: Get a Runway task
  version: 1.0.0
  description: Get a Runway task through CometAPI.
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /runwayml/v1/tasks/{id}:
    get:
      summary: Get a Runway task
      description: >-
        Retrieve a task created through /runwayml/v1 using an API key from the
        same CometAPI account. A newly created task may not yet include status.
      operationId: runway_to_get_task_details
      parameters:
        - name: id
          in: path
          required: true
          description: Task ID returned by a /runwayml/v1 creation request.
          schema:
            type: string
      responses:
        '200':
          description: Task details. Fields vary with the task state.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Task ID returned by a Runway task-creation request.
                  status:
                    type: string
                    description: >-
                      Task state, when available. Poll until SUCCEEDED, FAILED,
                      or CANCELLED.
                    enum:
                      - PENDING
                      - THROTTLED
                      - RUNNING
                      - SUCCEEDED
                      - FAILED
                      - CANCELLED
                  createdAt:
                    type: string
                    description: Task submission timestamp, when available.
                    format: date-time
                  progress:
                    type: number
                    description: Fraction completed, when reported for a running task.
                    minimum: 0
                    maximum: 1
                  output:
                    type: array
                    description: >-
                      Result URLs for a succeeded task. Download the assets
                      promptly for storage.
                    items:
                      type: string
                      format: uri
                  failure:
                    type: string
                    description: Failure explanation, when present on a failed task.
                  failureCode:
                    type: string
                    description: Machine-readable failure code, when present.
                  estimatedCost:
                    type: object
                    description: Task estimate metadata, when returned.
                    properties:
                      credits:
                        type: number
                        description: Credit value reported with the task.
                    required:
                      - credits
                    additionalProperties: false
                  cost:
                    type: object
                    description: Task cost metadata, when returned.
                    properties:
                      credits:
                        type: integer
                        description: Credit value reported with the task.
                    required:
                      - credits
                    additionalProperties: false
                required:
                  - id
                additionalProperties: true
              examples:
                Submitted:
                  summary: Task ID before status becomes available
                  value:
                    id: 00000000-0000-4000-8000-000000000001
                Running:
                  summary: Task in progress
                  value:
                    id: 00000000-0000-4000-8000-000000000001
                    status: RUNNING
                    progress: 0.2
                Succeeded:
                  summary: Completed task with an output URL
                  value:
                    id: 00000000-0000-4000-8000-000000000001
                    status: SUCCEEDED
                    output:
                      - https://example.com/generated-video.mp4
                Failed:
                  summary: Failed task
                  value:
                    id: 00000000-0000-4000-8000-000000000001
                    status: FAILED
                    failure: The input image did not pass content moderation.
                    failureCode: SAFETY.INPUT.IMAGE
        '400':
          description: Invalid request or unavailable task ID.
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    description: Task request error.
                    properties:
                      code:
                        type:
                          - string
                          - integer
                        description: Machine-readable task error code.
                      message:
                        type: string
                        description: Error explanation.
                      data:
                        description: Additional error details, when returned.
                    required:
                      - code
                      - message
                    additionalProperties: true
                  - type: object
                    description: Request authentication or validation error.
                    properties:
                      error:
                        type: object
                        description: Error details.
                        properties:
                          message:
                            type: string
                            description: Error explanation.
                          type:
                            type: string
                            description: Error category.
                          code:
                            type:
                              - string
                              - integer
                              - 'null'
                            description: Error code, when returned.
                        required:
                          - message
                        additionalProperties: true
                    required:
                      - error
                    additionalProperties: true
              example:
                code: task_not_exist
                message: task_not_exist
        '401':
          description: Authentication failed.
          content:
            application/json:
              schema:
                type: object
                description: Request authentication or validation error.
                properties:
                  error:
                    type: object
                    description: Error details.
                    properties:
                      message:
                        type: string
                        description: Error explanation.
                      type:
                        type: string
                        description: Error category.
                      code:
                        type:
                          - string
                          - integer
                          - 'null'
                        description: Error code, when returned.
                    required:
                      - message
                    additionalProperties: true
                required:
                  - error
                additionalProperties: true
      x-codeSamples:
        - lang: Shell
          label: Default
          source: |
            TASK_ID="<task_id>"

            curl "https://api.cometapi.com/runwayml/v1/tasks/$TASK_ID" \
              --header "Authorization: Bearer $COMETAPI_KEY"
        - lang: Python
          label: Default
          source: |
            import os
            import requests

            task_id = "<task_id>"
            response = requests.get(
                f"https://api.cometapi.com/runwayml/v1/tasks/{task_id}",
                headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
                timeout=60,
            )
            response.raise_for_status()
            print(response.json())
        - lang: JavaScript
          label: Default
          source: |
            const taskId = "<task_id>";

            const response = await fetch(
              `https://api.cometapi.com/runwayml/v1/tasks/${taskId}`,
              { headers: { Authorization: `Bearer ${process.env.COMETAPI_KEY}` } },
            );
            if (!response.ok) throw new Error(await response.text());
            console.log(await response.json());
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use your CometAPI API key.

````