{"openapi":"3.1.0","info":{"title":"Apizie","version":"2.0.0","description":"One API key, one envelope, many public data sources."},"servers":[{"url":"https://zieapi.vercel.app"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/cloud:aliyun-maasaisearchproxy/opening":{"post":{"operationId":"cloud_aliyun_maasaisearchproxy_opening","summary":"Retrieves the opening remarks and questions for web search Q&A, including statically configured opening…","description":"POST /api/qa/opening","tags":["cloud"],"parameters":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"endpoint":{"type":"string","enum":["https://maasaisearchproxy.aliyuncs.com"],"default":"https://maasaisearchproxy.aliyuncs.com","description":"Regional endpoint, for example https://maasaisearchproxy.aliyuncs.com"},"appId":{"type":"string","description":"The application ID"},"count":{"type":"integer","description":"The number of trending topics to return"},"hotQuestion":{"type":"string","description":"Specifies whether to enable trending topics"},"options":{"type":"object","description":"The extended options"},"userInfo":{"type":"object","description":"The user information"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/cloud:aliyun-maasaisearchproxy/qa-chat":{"post":{"operationId":"cloud_aliyun_maasaisearchproxy_qa_chat","summary":"Performs web-search Q&A (OpenAI-compatible, supports multi-turn context and follow-up recommendations, SSE…","description":"POST /qa/chat","tags":["cloud"],"parameters":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"endpoint":{"type":"string","enum":["https://maasaisearchproxy.aliyuncs.com"],"default":"https://maasaisearchproxy.aliyuncs.com","description":"Regional endpoint, for example https://maasaisearchproxy.aliyuncs.com"},"appId":{"type":"string","description":"The application ID"},"deviceId":{"type":"string","description":"The device ID"},"history":{"type":"array","description":"The session history"},"locationInfo":{"type":"object","description":"The location information"},"memory":{"type":"string","description":"The personalized memory (reserved)"},"message":{"type":"object","description":"The user message"},"options":{"type":"object","description":"The business parameters"},"sessionId":{"type":"string","description":"The session ID"},"stream":{"type":"string","description":"Specifies whether to enable streaming"},"userId":{"type":"string","description":"The user ID"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/cloud:aliyun-maasaisearchproxy/web-search":{"post":{"operationId":"cloud_aliyun_maasaisearchproxy_web_search","summary":"Initiates real-time searches on the Internet and retrieves a structured list of web page results. You can…","description":"POST /api/web-search","tags":["cloud"],"parameters":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"endpoint":{"type":"string","enum":["https://maasaisearchproxy.aliyuncs.com"],"default":"https://maasaisearchproxy.aliyuncs.com","description":"Regional endpoint, for example https://maasaisearchproxy.aliyuncs.com"},"endTime":{"type":"string","description":"Specifies the end date for the search results. The API returns results published on or before this date. The format is `YYYY-MM-DD`, such…"},"excludeDomain":{"type":"array","description":"The blacklisted websites. If you specify this parameter, results from the specified domains are excluded. A single request supports up to…"},"includeDomain":{"type":"array","description":"The whitelisted websites. If you specify this parameter, only results from the specified domains are returned. A single request supports…"},"limit":{"type":"integer","description":"The maximum number of results to return. Valid values: 1 to 10. Default value: 10"},"query":{"type":"string","description":"The search query. Natural language expressions are supported. The recommended maximum length is 100 characters"},"region":{"type":"string","description":"The scope of search sources. Valid values: mainland_china (the Chinese mainland) and global (global). Default value: mainland_china. Note:…"},"searchType":{"type":"string","description":"The search mode. Valid values: pro and lite. Default value: pro. Note: In lite mode, the region, excludeDomain, and includeDomain…"},"startTime":{"type":"string","description":"Specifies the start date for the search results. The API returns results published on or after this date. The format is `YYYY-MM-DD`, such…"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}},"/v1/cloud:aliyun-maasaisearchproxy/version":{"post":{"operationId":"cloud_aliyun_maasaisearchproxy_version","summary":"version","description":"POST /","tags":["cloud"],"parameters":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"endpoint":{"type":"string","enum":["https://maasaisearchproxy.aliyuncs.com"],"default":"https://maasaisearchproxy.aliyuncs.com","description":"Regional endpoint, for example https://maasaisearchproxy.aliyuncs.com"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"4XX":{"$ref":"#/components/responses/Error"},"5XX":{"$ref":"#/components/responses/Error"}},"x-apizie-cache-ttl":0,"x-apizie-min-plan":null,"x-apizie-bulk":false,"x-apizie-status":"byok"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"RunEnvelope":{"type":"object","required":["project","data","timestamp"],"properties":{"project":{"type":"string","example":"dev-tools:hash"},"data":{},"timestamp":{"type":"string","format":"date-time"}}},"ErrorEnvelope":{"type":"object","properties":{"content":{},"message":{"type":"string"},"errors":{"type":"array","items":{}},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}},"responses":{"Error":{"description":"Invalid key, plan gate, rate limit or upstream failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}