资源管理中心

资源中心是 provider-neutral 的。Gemini 与 GPT-Image 任务使用同一套任务列表、资源列表、资源 API Key 和 Webhook 配置，不创建 Gemini 专属资源端点。

统一对象

对象	作用	Gemini 差异
图片任务	查看排队、执行、成功或失败状态	model 为 Gemini 模型，usage 为归一化 Gemini 用量
图片资源	预览、复制 URL、下载和导出	无差异，结果均为 URL
资源 API Key	查询任务、预上传和读取资源	无差异，仍使用 ak_...
Webhook	接收成功或失败终态	无差异，仍使用 image.task.*

查询 Gemini 任务

curl -sS \
  "$SUPERTOKEN_BASE_URL/v1/image/tasks?status=succeeded&operation=generation&limit=20" \
  -H "Authorization: Bearer $RESOURCE_API_KEY" | jq \
  '.data[] | select(.model == "gemini-3.1-flash-image")'

查询 Gemini 生成资源

保存创建任务时返回的任务 ID：

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 .

result.images[].asset_id 与资源列表的 id 对应。上游返回 URL 或 Base64 不影响资源对象结构；Base64 会先上传对象存储，再以 URL 和资源 ID 对外返回。

控制台

登录控制台后进入“资源管理中心”：

• 在“资源列表”按任务 ID、模型、状态或时间筛选 Gemini 结果。
• 在“API Key”生成或轮换 ak_... 资源 Key。
• 在“Webhook”配置账号级回调 URL 和 wk-... 验证 Key。
• 在“使用文档”查看 GPT 与 Gemini 共用的请求、响应和 OpenAPI schema。

任务、资产、筛选和 Webhook 协议完全统一，差异只存在于模型能力与 provider_options。

Key 边界

Key	用途
模型 API Token，sk-...	同步调用和创建异步任务
资源 API Key，ak_...	查询任务、预上传和查询资源
Webhook Key，wk-...	接收端验证回调

三类 Key 不能混用，也不要写入前端或公开仓库。

下一步

• 异步任务
• Webhook 完成通知
• 参数、尺寸与错误