Skip to content
Last updated

Bắt đầu hành trình của bạn bằng cách tìm hiểu cách thiết lập và sử dụng nhanh Tisane API.

Bước 1 – Tạo tài khoản

Sign up to Tisane API

Gói Cộng đồng miễn phí hỗ trợ tối đa 50.000 yêu cầu, với giới hạn 10 yêu cầu mỗi phút. (Hoặc nếu muốn thì bạn có thể mua gói trả phí.)

Bước 2 - Lấy khóa API

Tisane API sử dụng khóa API để xác thực các yêu cầu. Truy cập vào Hồ sơ nhà phát triển của bạn để xem và quản lý khóa API.

Bước 3 - Sử dụng API

Thực thi phương thức POST/parse. Phần nội dung yêu cầu của phương thức này cần có ba thuộc tính sau:

  • content (chuỗi)
  • language (chuỗi)
  • settings (đối tượng)

Ví dụ:

Yêu cầu:

   {
     "language": "en", 
     "content": "Hello Tisane API", 
     "settings": {}
   }

Phản hồi:

{
   "text": "Hello Tisane API",
   "topics": [
   	"natural language processing",
   	"artificial intelligence"
   ],
   "entities_summary": [
   	{
   		"type": "software",
   		"name": "Tisane API",
   		"mentions": [
   			{
   				"sentence_index": 0,
   				"offset": 6,
   				"length": 10
   			}
   		]
   	}
   ]
}
Trên nền tảng đám mây công cộng, độ dài tối đa của phần nội dung JSON là 2048 byte. Yêu cầu dài hơn được hỗ trợ trong phiên bản triển khai tại chỗ.

Bạn có thể thử gửi yêu cầu ngay trên cổng này hoặc sử dụng tùy chọn Dùng thử trong Cổng thông tin dành cho nhà phát triển. Bạn cũng có thể thử nghiệm bằng cách dùng curl, Postman, Insomnia hoặc bất kỳ công cụ RESTful nào khác.

Cú pháp curl

curl -V -X POST \
  https://api.tisane.ai/parse \
  -H "Ocp-Apim-Subscription-Key: your_primary_or_secondary_API_key;_not_needed_on-prem" \
  -H "Content-Type: application/json" \
  -d '{
    "language": "en",
    "content": "Hello Tisane API!",
    "settings": {}
  }'

Khắc phục sự cố

API hoạt động thông qua yêu cầu POST tiêu chuẩn.

Nếu bạn gặp lỗi hết thời gian:

  • Hãy kiểm tra kết nối mạng của bạn.

Nếu bạn gặp mã lỗi 401 (Không được phép):

{
	"statusCode": 401,
	"message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}
  • Đảm bảo đã cung cấp đúng khóa API làm giá trị cho tiêu đề Ocp-Apim-Subscription-Key.

Để sử dụng khóa API của bạn trên Cổng thông tin tài liệu này, hãy nhấp vào nút Bảo mật trong trang Dùng thử.

(The Developer Portal automatically fills the API key when you sign in.)

Nếu bạn gặp mã lỗi 400 (Yêu cầu không hợp lệ) cho biết ngôn ngữ không có trong cơ sở dữ liệu:

  • Hãy đảm bảo rằng bạn đang chỉ định đúng mã ngôn ngữ theo chuẩn ISO-639-1 và ngôn ngữ đó được Tisane hỗ trợ.

Nếu bạn cần thêm sự trợ giúp:

Tiếp theo:

 

Guides