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

# List task artifacts

> Read artifact keys, types, MIME types, and content URLs.

`GET /v1/tasks/{key}/artifacts`

`key` is the public task ID. Read `task_id` and `artifacts`, whose entries contain `key`, `type`, optional `mime_type`, and `content_url`.

Tasks not yet successful or without an artifact provider may return an empty array. Legacy video tasks may additionally return `legacy_content_url`. Signed URLs can expire; do not log them or append API keys. Plugin unavailability can return 503; projection errors can return 500. See [listing and downloads](/en/guides/tasks).

[阅读中文版](/zh/api-reference/task-artifacts)


## OpenAPI

````yaml openapi/relay.json GET /v1/tasks/{key}/artifacts
openapi: 3.0.3
info:
  title: API — Core inference API
  version: 0.5.0
  description: >-
    面向接入的精选规范，不是全部管理或供应商接口。 / Curated integration specification, not the entire
    management or provider API.
  license:
    name: AGPL-3.0-or-later
servers:
  - url: https://gateway.example.com
    description: >-
      Example only; replace with your gateway origin and optional path prefix,
      without /v1.
security:
  - BearerAuth: []
paths:
  /v1/tasks/{key}/artifacts:
    get:
      summary: 列出任务产物 / List task artifacts
      description: >-
        `key` 是公开任务 ID。返回 `task_id` 与 `artifacts` 数组，元素含 `key`、`type`、可选
        `mime_type` 与 `content_url`。 / `key` is the public task ID. Read
        `task_id` and `artifacts`, whose entries contain `key`, `type`, optional
        `mime_type`, and `content_url`.
      operationId: task_artifacts
      parameters:
        - name: key
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >-
            读取业务字段，不只检查 HTTP 状态 / Validate business fields, not only HTTP
            status.
          content:
            application/json:
              schema:
                type: object
                properties:
                  task_id:
                    type: string
                  artifacts:
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                        type:
                          type: string
                          enum:
                            - image
                            - audio
                            - video
                            - file
                        mime_type:
                          type: string
                        content_url:
                          type: string
                      additionalProperties: true
                      required:
                        - key
                        - type
                        - content_url
                  legacy_content_url:
                    type: string
                additionalProperties: true
                required:
                  - task_id
                  - artifacts
              example:
                task_id: task_example
                artifacts:
                  - key: video
                    type: video
                    mime_type: video/mp4
                    content_url: >-
                      https://gateway.example.com/v1/tasks/task_example/artifacts/video/content
        default:
          description: 错误格式与状态取决于入口 / Error status and shape depend on the entry.
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 模型调用 API Key，不是控制台登录凭据 / Model API key, not console login credentials

````

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