Quick Start

Updated at:

This guide shows you how to activate the service and make your first API call in under five minutes.

Step 1: Set up your account

Register an Alibaba Cloud account and complete real-name verification. For instructions on setting up an enterprise account, see Enterprise Account Quick Start.

Step 2: Activate the service

  1. Log in to the CleverSee official website or the CleverSee console and click Free Trial or Activate Now to navigate to the Alibaba Cloud product page.

  2. On the activation page, review the Product Service Agreement and Service Level Agreement, and then click Activate Now.

  3. Complete the service activation.

Note
  1. We recommend using a main account to activate the service. If you plan to use a RAM user, you must grant the necessary permissions through RAM authorization. For instructions, see Create a RAM user and grant permissions.

  2. Each account is limited to one active instance. To request changes or additional instances, please contact us.

Step 3: Get your API credentials

CleverSee supports two authentication methods. Choose one based on your integration method.

Method

Integration method

Source

Usage

API key

  • HTTP

  • MCP

  • Skill

In the CleverSee console, go to the API Key page and click Create API Key.

HTTP Header: Authorization: Bearer <YOUR_API_KEY> or X-API-Key: <YOUR_API_KEY>

AccessKey

  • SDK

Create a RAM user and grant permissions → Create an AccessKey for a RAM user

Configure access_key_id and access_key_secret in your SDK code.

Step 4: Your first call or application

1. Internet Search API

curl  -X POST https://cloud-iqs.aliyuncs.com/search/unified \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
  "query": "best restaurants in Seattle",
  "engineType": "CNAuto",
  "contents": {
    "mainText": true,
    "markdownText":false,
    "summary": false,
    "rerankScore": true
  },
  "advancedParams":{
  	"numResults": 5
  }
}'

2. Internet QA Agent

Follow the Internet QA Agent - Instructions to create your first agent.

3. Page Parsing

curl --location 'https://cloud-iqs.aliyuncs.com/readpage/basic' \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://www.example.com/news/article-123",
    "maxAge": 0
}'

4. Enterprise Search

Follow the Enterprise Search - Instructions to set up this feature.

Next steps

If you encounter any issues, click Contact Us.