资源管理中心

异步图片任务完成后，除了通过任务查询接口或 Webhook 获取结果，还可以在控制台的“资源管理中心”查看和管理自己账号下的生成资源。这里同时提供资源 API Key、Webhook 和公开 API 使用文档。

页面入口

登录控制台后，从左侧导航进入“资源管理中心”。页面包含四个页签：

页签	用途
资源列表	查看、筛选、预览、下载和导出异步任务生成的图片与视频
API Key	生成和管理 `ak_...` 资源 API Key
Webhook	配置异步任务完成通知和 `wk-...` 验证 Key
使用文档	在控制台查看任务、资源与 Webhook 的接口说明

查看正在生成的任务

提交异步图片请求后，控制台的“任务日志”会出现对应记录。任务仍在排队或生成时，可以在这里查看任务状态和进度；任务完成后，结果列会提供图片预览和浏览器打开入口。

任务日志支持按时间、任务 ID 和资源类型筛选。查看图片任务时，可以在资源类型中选择“图片”，或直接输入创建接口返回的任务 ID。

阶段	推荐入口	可以查看的内容
排队或生成中	任务日志	提交时间、任务 ID、类型、任务状态和进度
生成成功	任务日志	完成状态、耗时，以及结果预览或打开入口
管理已生成结果	资源管理中心 → 资源列表	资源详情、复制链接、下载选中和导出 CSV
程序化查询	`/v1/image/tasks` 与 `/v1/assets`	任务状态、进度、结果对象和资源地址

任务日志、任务查询 API 和资源列表使用同一个任务 ID。出现长时间无进度、任务失败或结果缺失时，可以用该 ID 对照三处信息。

查看任务结果

在“资源列表”页签中，可以按资源类型、任务 ID、模型、关键词、状态和创建时间筛选结果。

创建异步图片任务并保存响应中的 id，例如 task_example123。
等待任务进入 succeeded 状态。
打开“资源管理中心 → 资源列表”，在“任务 ID”中输入任务 ID。
在结果中预览图片，或执行复制链接、打开、下载选中和导出 CSV。

资源详情会显示资源 ID、任务 ID、模型、文件信息和结果地址。任务查询接口返回的 result.images[].asset_id 可以与资源列表中的资源 ID 对照。

任务与资源的区别

任务日志和 /v1/image/tasks 用于查看任务是否排队、正在执行、成功或失败；/v1/assets 用于管理成功任务生成的图片资源。排查执行过程时看任务日志或任务接口，任务成功后需要批量获取链接或导出结果时查资源接口。

资源 API Key

打开“资源管理中心 → API Key”，点击“生成资源 API Key”。资源 Key 以 ak_ 开头，可用于：

查询、列出和批量查询异步图片任务；
预上传异步编辑所需的图片；
查询单个或多个生成资源；
批量获取资源 URL；
导出资源 CSV。

资源 API Key 可以显示、复制、停用、重新生成或删除。重新生成或删除后，旧 Key 会立即失效。

妥善保存资源 Key

不要把 ak_... 写入前端代码、公开仓库或浏览器页面。服务端应通过环境变量读取，并仅向受信任的后台服务开放。

bash

export SUPERTOKEN_BASE_URL="https://api.supertoken.cc"
export RESOURCE_API_KEY="YOUR_RESOURCE_API_KEY"

资源查询 API

资源接口严格按资源 API Key 所属用户隔离，只返回当前账号可见的数据。

能力	方法与路径
查询资源列表	`GET /v1/assets`
查询单个资源	`GET /v1/assets/{asset_id}`
批量查询资源	`POST /v1/assets/query`
批量获取资源 URL	`POST /v1/assets/batch/urls`
导出资源 CSV	`GET /v1/assets/export`

按任务 ID 查询结果

bash

export TASK_ID="task_example123"

curl -sS \
  "$SUPERTOKEN_BASE_URL/v1/assets?asset_type=image&task_id=$TASK_ID&page=1&page_size=20" \
  -H "Authorization: Bearer $RESOURCE_API_KEY" | jq .

响应示例：

json

{
  "object": "list",
  "data": [
    {
      "object": "asset",
      "id": "asset_example123",
      "task_id": "task_example123",
      "index": 0,
      "type": "image",
      "url": "https://example.com/generated/image.png",
      "mime_type": "image/png",
      "filename": "image.png",
      "width": 1024,
      "height": 1024,
      "model": "gpt-image-2",
      "status": "available",
      "created_at": 1784682038,
      "updated_at": 1784682038
    }
  ],
  "page": 1,
  "page_size": 20,
  "total": 1,
  "has_more": false
}

查询单个资源

bash

export ASSET_ID="asset_example123"

curl -sS "$SUPERTOKEN_BASE_URL/v1/assets/$ASSET_ID" \
  -H "Authorization: Bearer $RESOURCE_API_KEY" | jq .

批量获取资源 URL

bash

curl -sS "$SUPERTOKEN_BASE_URL/v1/assets/batch/urls" \
  -H "Authorization: Bearer $RESOURCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_ids": [
      "asset_example123",
      "asset_example456"
    ]
  }' | jq .

导出 CSV

bash

curl -sS \
  "$SUPERTOKEN_BASE_URL/v1/assets/export?asset_type=image&start_timestamp=1784160000" \
  -H "Authorization: Bearer $RESOURCE_API_KEY" \
  --output assets.csv

一次最多导出 10,000 条符合筛选条件的资源。

常用筛选参数

参数	说明
`asset_type`	资源类型：`image`、`video`、`audio` 或 `file`
`task_id`	按任务 ID 精确筛选
`model`	按模型名称精确筛选
`keyword`	搜索资源 ID、任务 ID、文件名或 URL
`start_timestamp`	创建时间下限，Unix 秒
`end_timestamp`	创建时间上限，Unix 秒
`page`	页码，默认为 1
`page_size`	每页数量，默认为 20，最大 100

Webhook 配置

打开“资源管理中心 → Webhook”，填写公开回调 URL，生成 wk-... 验证 Key，启用并保存配置。点击“发送测试”可以验证地址和 Key 是否配置正确。

Webhook 会在图片任务成功或失败时主动发送事件。接收端应校验 Authorization: Bearer wk-...、按事件 ID 去重并快速返回 HTTP 2xx。完整事件结构和接收 Demo 见 Webhook 完成通知。

三类 Key 的区别

Key	用途	不可用于
模型 API Token，`sk-...`	同步生成、同步编辑、创建异步任务	查询资源和验证 Webhook
资源 API Key，`ak_...`	查询任务、预上传、查询和导出资源	创建图片任务和验证 Webhook
Webhook Key，`wk-...`	接收端验证回调来源	调用任何 API

不要在不同接口间混用三类 Key。收到 401 或 403 时，先检查请求路径对应的 Key 类型。

GPT-Image-2

Gemini Images

Seedance

Kling 3.0

Veo 3.1

MiniMax H3

资源管理中心

页面入口

查看正在生成的任务

查看任务结果

资源 API Key

资源查询 API

按任务 ID 查询结果

查询单个资源

批量获取资源 URL

导出 CSV

常用筛选参数

Webhook 配置

三类 Key 的区别

下一步

资源管理中心 ​

页面入口 ​

查看正在生成的任务 ​

查看任务结果 ​

资源 API Key ​

资源查询 API ​

按任务 ID 查询结果 ​

查询单个资源 ​

批量获取资源 URL ​

导出 CSV ​

常用筛选参数 ​

Webhook 配置 ​

三类 Key 的区别 ​

下一步 ​

资源管理中心

页面入口

查看正在生成的任务

查看任务结果

资源 API Key

资源查询 API

按任务 ID 查询结果

查询单个资源

批量获取资源 URL

导出 CSV

常用筛选参数

Webhook 配置

三类 Key 的区别

下一步