Artiva

Tài liệu API

Tích hợp tạo ảnh AI vào sản phẩm của bạn

API REST của Artiva cho phép tạo, sửa và phóng to ảnh ngay trong website, app hay hệ thống nội bộ. Có trong gói Studio, kèm SDK JavaScript, Python và webhook báo kết quả.

01

Một khoá, ba lệnh chính

Tạo ảnh từ văn bản, sửa vùng chọn và phóng to dùng chung một khoá API. Kết quả trả về đường dẫn ảnh có hiệu lực 24 giờ.

02

Không phải chờ máy chủ

Gửi yêu cầu kèm địa chỉ webhook; Artiva báo về khi ảnh sẵn sàng, phù hợp cho xử lý hàng loạt hàng nghìn ảnh sản phẩm.

03

Dữ liệu ở lại với bạn

Ảnh và prompt gửi qua API không dùng để huấn luyện mô hình. Máy chủ đặt tại Singapore, mã hoá khi truyền và khi lưu.

Bắt đầu trong 5 phút

Lấy khoá API trong mục Cài đặt → API của tài khoản Studio, rồi gọi lệnh tạo ảnh đầu tiên.

curl https://api.artiva.vn/v1/images/generations \
  -H "Authorization: Bearer $ARTIVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Chai serum hổ phách trên nền đá, nắng chiều",
    "style": "product",
    "size": "2048x1536",
    "n": 4
  }'

Các lệnh chính

Phương thứcĐường dẫnChức năng
POST/v1/images/generationsTạo ảnh từ văn bản, tối đa 4 ảnh mỗi yêu cầu
POST/v1/images/editsSửa vùng chọn bằng ảnh gốc + mặt nạ + prompt
POST/v1/images/upscalePhóng to 2x hoặc 4x, tối đa 4096×4096
POST/v1/images/remove-backgroundXoá nền, trả PNG trong suốt
GET/v1/images/{id}Xem trạng thái và đường dẫn ảnh của một yêu cầu

Giới hạn theo gói

Studio

60 yêu cầu/phút

1.000 ảnh/tháng trong gói, ảnh vượt mức tính 690đ/ảnh.

Studio + gói ảnh

60 yêu cầu/phút

Mua thêm 5.000 ảnh giá 2.900.000đ, dùng trong 90 ngày.

Doanh nghiệp

Tuỳ chỉnh

Máy chủ riêng, cam kết thời gian hoạt động 99,9%, hợp đồng và hoá đơn theo quý.

Cập nhật hệ thống

  1. 28/10/2026

    Thêm kiểu ảnh “nội thất” và tham số room_type cho phối cảnh.

  2. 14/10/2026

    Webhook gửi kèm chữ ký HMAC; thêm lệnh xoá nền hàng loạt.

  3. 30/09/2026

    Prompt tiếng Việt có dấu được hiểu chính xác hơn với từ chuyên ngành.

  4. 09/09/2026

    Ra mắt SDK Python 1.0 và giới hạn 60 yêu cầu/phút cho gói Studio.

Về NAVI Website