Appearance
Douyin: Tìm video bằng hình ảnh
Gửi ảnh dưới dạng Base64 để tìm video trên Douyin. Endpoint này dùng API key ImageCoreAPI có quyền douyin; bạn không cần gửi khóa của dịch vụ Douyin trực tiếp.
Endpoint
POST https://control.ecomtools.vn/v1/douyin/vision
| Header | Giá trị |
|---|---|
X-API-Key | API key ImageCoreAPI được cấp quyền douyin |
Content-Type | application/json |
Body JSON chỉ cần một trường bắt buộc:
| Trường | Kiểu | Mô tả |
|---|---|---|
image_base64 | string | Nội dung ảnh mã hóa Base64, không có tiền tố data:image/...;base64, |
Ví dụ sử dụng
bash
curl -X POST "https://control.ecomtools.vn/v1/douyin/vision" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"image_base64":"<ANH_BASE64>"}'python
import base64
import httpx
with open("anh.jpg", "rb") as image:
image_base64 = base64.b64encode(image.read()).decode("ascii")
response = httpx.post(
"https://control.ecomtools.vn/v1/douyin/vision",
headers={"X-API-Key": "YOUR_API_KEY"},
json={"image_base64": image_base64},
timeout=60.0,
)
print(response.status_code, response.text)javascript
import { readFileSync } from 'node:fs';
const imageBase64 = readFileSync('anh.jpg').toString('base64');
const response = await fetch('https://control.ecomtools.vn/v1/douyin/vision', {
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ image_base64: imageBase64 }),
});
console.log(response.status, await response.text());php
<?php
$imageBase64 = base64_encode(file_get_contents('anh.jpg'));
$ch = curl_init('https://control.ecomtools.vn/v1/douyin/vision');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'X-API-Key: YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['image_base64' => $imageBase64]),
]);
echo curl_exec($ch);
curl_close($ch);Nếu ảnh lấy từ Data URL của trình duyệt, hãy bỏ phần data:image/...;base64, trước khi gửi. Chẳng hạn: dataUrl.split(',')[1].
Phản hồi và giới hạn
Gateway chuyển nguyên trạng mã HTTP và nội dung phản hồi từ dịch vụ Douyin. Cấu trúc kết quả video phụ thuộc vào phản hồi thực tế của upstream; hãy xử lý theo JSON nhận được thay vì giả định trước tên các trường. Mỗi yêu cầu được chuyển tới upstream sẽ tính vào quota chung của key cùng các nền tảng khác.
| HTTP | Ý nghĩa |
|---|---|
401 | Thiếu hoặc sai API key ImageCoreAPI |
403 | Key chưa được cấp quyền douyin |
422 | Thiếu image_base64 hoặc giá trị rỗng |
429 | Vượt giới hạn tốc độ hoặc quota tháng |
502 | Không kết nối được upstream hoặc upstream quá thời gian chờ |
503 | Gateway chưa được cấu hình khóa upstream Douyin |
Các lỗi do gateway tạo trả về {"error":{"code":"...","message":"..."},"data":null}. Lỗi HTTP do upstream trả về được giữ nguyên để bạn đọc thông tin gốc.