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

# 列出任务产物

> 读取产物 key、类型、MIME 与内容地址。

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

`key` 是公开任务 ID。返回 `task_id` 与 `artifacts` 数组，元素含 `key`、`type`、可选 `mime_type` 与 `content_url`。

未成功或没有产物提供器时可能是空数组；旧视频任务可能另外返回 `legacy_content_url`。临时签名 URL 可能过期，不应公开日志或附加 API Key。插件不可用可能返回 503，产物投影失败可能返回 500。见[列表与下载示例](/zh/guides/tasks)。

[Read in English](/en/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.