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

# Inspect task artifact

> Inspect artifact headers and conditional request behavior.

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

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

GET returns binary content; HEAD has headers only. Pending tasks return 409, missing/inaccessible results or keys 404, and unavailable plugins 503. `Range`, `If-Range`, `If-None-Match`, and `If-Modified-Since` are forwarded. Status 200 / 206 / 304 / 416 and cache headers depend on storage and upstream; Range support is not universal. Do not save 206 as a complete file. See [download example](/en/guides/tasks).

[阅读中文版](/zh/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.