WOK API

CS2 Screenshot API

发送检视链接，或武器、涂装、磨损值和模板参数，获取用于物品页、交易挂单或库存工具的 PNG。

获取 API 密钥查看请求示例

正面、背面或双面

选择 mode=front、back 或 both。view=transparent 可生成透明背景，包括将双面合并在一个 PNG 中。也可自定义背景颜色。

一把 WOK 密钥

有效 Free 和付费通用密钥可用，专项套餐不包含此接口。创建截图消耗一个 API 单位，查询已有任务免费，截图不消耗 3D 查看次数。

curl 'https://woksteamapi.com/v1/cs2/screenshots' \
  -H "Authorization: Bearer $WOK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"def_index":7,"paint_index":282,"float_value":0.21,"paint_seed":582,"mode":"both"}'

检视物品请传 inspect_link 而非手动参数。无法解析的链接会返回明确错误。

等待渲染完成

向 POST /v1/cs2/screenshots 发送请求，在 Authorization 请求头中提供密钥。
HTTP 202 返回 job_id 和 result_url，请等待 Retry-After 指定的时间。
使用同一密钥请求 result_url，仅在收到 HTTP 200 image/png 后保存响应内容。

相同请求共用一次渲染。图片在有容量上限的缓存中最多保留三小时，请将完成的文件保存到自己的存储。

渲染覆盖范围

武器和刀具使用我们的游戏材质渲染器，支持磨损值和模板。光照可能与游戏不同。附件支持情况请查看响应中的能力标记，暂不支持手套。

响应标记 exact_item_rendered=false。strict=true 可拒绝不支持的附件细节。这是材质渲染，并非运行中的 CS2 客户端截图。

集成指南

宽度 256–2048 像素，可选磨损信息面板、自定义文字、PNG 下载和 base64 JSON。独立且有资源上限的工作进程处理渲染，不占用库存请求流程。

如何接入 · 文档 · CS2 3D