Skip to content

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

HeaderGiá trị
X-API-KeyAPI key ImageCoreAPI được cấp quyền douyin
Content-Typeapplication/json

Body JSON chỉ cần một trường bắt buộc:

TrườngKiểuMô tả
image_base64stringNộ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
401Thiếu hoặc sai API key ImageCoreAPI
403Key chưa được cấp quyền douyin
422Thiếu image_base64 hoặc giá trị rỗng
429Vượt giới hạn tốc độ hoặc quota tháng
502Không kết nối được upstream hoặc upstream quá thời gian chờ
503Gateway 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.

ImageCoreAPI — Cổng API tìm kiếm hình ảnh Shopee & TikTok Shop