Upload trực tiếp

POSThttps://sangtao.ai/api/v2/images/upload

Gửi ảnh nhỏ trong một lượt gọi và nhận về URL. Trên khoảng 1 MB sẽ bị từ chối.

Một lượt gọi thay vì hai, dành cho ảnh chụp màn hình hay logo. Từ khoảng 1 MB trở lên sẽ bị từ chối với mã 413 — mà ảnh chụp từ điện thoại thường lớn hơn thế, nên với ảnh đó hãy dùng đường presign.

Headers

X-Api-Keystringbắt buộc

API key của bạn. Tạo ở trang API Key trong tài khoản.

Content-Typestringbắt buộc

multipart/form-data — không phải JSON. Phần lớn thư viện HTTP tự đặt header này khi bạn đính kèm file.

Request

Filebinarybắt buộc

Chính file ảnh, gửi qua form field tên đúng "File". JPEG, PNG hoặc WebP. Đo thực tế: file 1,4 MB trả về 413, nên từ khoảng 1 MB trở lên phải dùng đường presign.

Response

imageUrlstring

Địa chỉ ảnh vừa tải lên. Đây chính là giá trị truyền vào referenceImages.

imageIdstring

Đo thực tế: giống hệt imageUrl chứ không phải một id riêng. Hãy dùng imageUrl — tên trường này hứa một thứ mà nó không trả về.

imageTypestring

Luôn là "UPLOADED" với endpoint này. Trường này phân biệt ảnh bạn tự tải lên với ảnh do hệ thống sinh ra.

POST/images/upload
curl -X POST   https://sangtao.ai/api/v2/images/upload   -H "X-Api-Key: YOUR_KEY"   -F "[email protected]"
{
  "success": true,
  "data": {
    "imageId": "https://cdn.sangtao.ai/content/284c42a4-.../0a900d6.png",
    "imageUrl": "https://cdn.sangtao.ai/content/284c42a4-.../0a900d6.png",
    "imageType": "UPLOADED"
  },
  "error": null,
  "errorCode": null
}
Trang trướcUpload qua presignTrang sauTạo video AI