{ "openapi": "3.1.0", "info": { "title": "VCG图片搜索 API (V1)", "version": "v0", "description": "按关键词搜索 VCG 图片，支持指定图片数量、分页控制、排除已收集的资源 ID，以及可选的 500px Select/Prime 过滤器（排除 AIGC）。在继续中断的搜索时请使用相同的内容过滤器。" }, "servers": [ { "url": "https://api.justoneapi.com", "description": "全球生产 API（默认）" } ], "tags": [ { "name": "VCG", "description": "VCG 关键词图片搜索，支持分页，用于图片发现和收集工作流。", "x-platform-id": "vcg", "x-platform-aliases": [ "VCG", "视觉中国" ], "x-platform-detection-aliases": [ "VCG", "视觉中国" ] } ], "paths": { "/api/vcg/search-image/v1": { "get": { "tags": [ "VCG" ], "summary": "图片搜索", "description": "按关键词搜索 VCG 图片，支持指定图片数量、分页控制、排除已收集的资源 ID，以及可选的 500px Select/Prime 过滤器（排除 AIGC）。在继续中断的搜索时请使用相同的内容过滤器。", "operationId": "getApiVcgSearchImageV1", "parameters": [ { "name": "token", "in": "query", "description": "此API服务的鉴权令牌。", "required": true, "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "description": "图片搜索关键词，最多 200 个字符，不能包含控制字符。", "required": true, "schema": { "type": "string", "maxLength": 200, "minLength": 1 } }, { "name": "limit", "in": "query", "description": "要返回的唯一图片的最大数量，不包括提供的资源 ID。", "required": false, "schema": { "type": "string", "maximum": 10000, "minimum": 1 } }, { "name": "startPage", "in": "query", "description": "要搜索的第一页，从 1 开始。要继续，请使用上一个请求返回的下一页。", "required": false, "schema": { "type": "string", "maximum": 10000, "minimum": 1 } }, { "name": "maxPages", "in": "query", "description": "本次请求要访问的最大页数。请求的最后一页不得超过 10000。", "required": false, "schema": { "type": "string", "maximum": 100, "minimum": 1 } }, { "name": "excludeResourceIds", "in": "query", "description": "继续搜索时排除的已收集VCG资源ID。提供逗号分隔的ID或重复此查询参数。", "required": false, "schema": { "type": "array", "items": { "type": "string", "pattern": "^VCG[A-Za-z0-9_-]{1,125}$" }, "maxItems": 100000 } }, { "name": "contentFilter", "in": "query", "description": "可选的品牌和 AIGC 搜索限制。在分页和续查过程中请保持此值不变。\n\n可用值：\n- `all`：保持默认搜索，不附加品牌或 AIGC 过滤条件。\n- `selected_500px_no_aigc`：仅选择 500px Select 和 500px Prime，使用站点过滤器排除 AIGC，并保持最佳排序。当结果不足时不要扩展到其他品牌。", "required": false, "schema": { "type": "string", "default": "all", "description": "VCG 搜索内容过滤器", "enum": [ "all", "selected_500px_no_aigc" ] } } ], "responses": { "200": { "description": "好的", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "请求参数或请求体无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "访问令牌无效或未激活", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "权限不足", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "请求速率或每日配额已超限", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "服务器内部错误", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "503": { "description": "服务暂时不可用", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": "37001000", "x-api-version": "v1", "x-search-aliases": [ "视觉中国图片搜索", "VCG keyword image search" ], "x-highlights": [ { "type": "warning", "kind": "GUIDANCE", "content": "中断的搜索可能返回部分进度。在将请求的图片数量视为已完成之前，请检查完成情况。" } ], "x-endpoint-family": "vcg_search_image" } } } }