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

# 检查任务产物

> 检查产物响应头与条件请求行为。

`HEAD /v1/tasks/{key}/artifacts/{artifact_key}/content`

`key` 是任务 ID，`artifact_key` 取自列表。请求需具备该任务访问权限；服务生成的临时访问 URL 是另一种受限访问方式，客户端不要自行构造签名。

GET 返回二进制；HEAD 返回头部且无正文。未完成为 409、任务或 key 不存在 / 结果不可检索为 404、插件不可用为 503。支持转交 `Range`、`If-Range`、`If-None-Match`、`If-Modified-Since`；最终 200 / 206 / 304 / 416 与缓存头依存储和上游而定，不承诺所有产物支持 Range。完整下载不能把 206 当作整文件。见[下载示例](/zh/guides/tasks)。

[Read in English](/en/api-reference/task-artifact-head)


## OpenAPI

````yaml /openapi/relay.json HEAD /v1/tasks/{key}/artifacts/{artifact_key}/content
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/{artifact_key}/content:
    head:
      summary: 检查任务产物 / Inspect task artifact
      description: >-
        `key` 是任务 ID，`artifact_key` 取自列表。请求需具备该任务访问权限；服务生成的临时访问 URL
        是另一种受限访问方式，客户端不要自行构造签名。 / `key` is the task ID; select `artifact_key`
        from the listing. Task access is required. Server-generated temporary
        URLs provide a separate scoped access mechanism; clients must not invent
        signatures.
      operationId: task_artifact_head
      parameters:
        - name: key
          in: path
          required: true
          schema:
            type: string
        - name: artifact_key
          in: path
          required: true
          schema:
            type: string
        - name: Range
          in: header
          schema:
            type: string
        - name: If-Range
          in: header
          schema:
            type: string
        - name: If-None-Match
          in: header
          schema:
            type: string
        - name: If-Modified-Since
          in: header
          schema:
            type: string
      responses:
        '200':
          description: 完整内容或 HEAD 头 / Complete content or HEAD headers
        '206':
          description: 部分内容 / Partial content
        '304':
          description: 未修改 / Not modified
        '404':
          description: 未找到 / Not found
        '409':
          description: 未就绪 / Not ready
        '416':
          description: 范围无效 / Invalid range
        '503':
          description: 插件不可用 / Plugin unavailable
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.