Tài liệu tham khảo · Xác thực

Xác thực Photta API Một key, một header

Tóm tắt trong một câu

Gửi key của bạn dưới dạng `Authorization: Bearer photta_live_xxx` trên mỗi lệnh gọi Photta API. Key được tạo trong dashboard, không phân scope theo endpoint và dùng chung một số dư credits.

Lấy API key Đọc tài liệu

Xác thực: Bearer key
Giới hạn: 600 requests/min
Xử lý: async, polling

Mọi số liệu trên trang này đều lấy từ tài liệu Photta API · đã kiểm tra 2026-09-10

Yêu cầu từ API

Tổng quan về xác thực

Header: Authorization: Bearer photta_live_xxx
Tiền tố key: photta_live_
Base URL: https://api.photta.app/api/v1
Nơi tạo key: https://ai.photta.app
Scope: Một key truy cập mọi endpoint và dùng chung một số dư credits

Kiểm tra key bằng một lệnh gọi

Endpoint account hoàn toàn miễn phí, là cách an toàn nhất để xác nhận key có hoạt động hay không.

curl https://api.photta.app/api/v1/account \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Quản lý key

Xoay vòng key khi có nghi vấn
Tài liệu nêu rõ: hãy xoay vòng key ngay lập tức nếu nghi ngờ key bị lộ. Hãy tạo key thay thế trước, triển khai lên hệ thống, sau đó mới hủy key cũ.
Chỉ lưu trữ ở phía server
Key lộ ra phía trình duyệt đồng nghĩa với việc bất kỳ ai mở trang web đều có thể lấy được. Hãy gọi API từ backend của bạn và trả kết quả về cho client.
401 là do key, không phải do request
Key bị thiếu, không hợp lệ hoặc hết hạn sẽ trả về `authentication_error`. Hãy kiểm tra header xem có lỗi chính tả hoặc khoảng trắng thừa hay không trước khi tìm lỗi ở nơi khác.
Dùng chung một số dư cho mọi key
Key không phân quyền theo từng tính năng. Nhiều key cho nhiều môi trường khác nhau vẫn trừ chung vào một số dư credits, được hiển thị qua GET `/api/v1/account`.

Các câu hỏi về xác thực

Làm thế nào để xác thực một request?

Gửi key trong header Authorization dưới dạng bearer token ở mỗi lệnh gọi. Không có bước đăng nhập hay trao đổi token riêng biệt.

Tôi có thể tạo key ở đâu?

Trong dashboard Photta của bạn. Nơi này cũng cấp key thay thế, đó là nơi tài liệu hướng dẫn bạn truy cập sau lỗi 401.

Tôi có thể gọi API từ trình duyệt không?

Không thể dùng key của bạn. Bất kỳ thứ gì gửi đến trình duyệt đều có thể bị khách truy cập đọc được, vì vậy hãy đặt lệnh gọi phía sau server của bạn và chuyển tiếp kết quả.

Nếu key bị lộ thì sao?

Hãy rotate ngay lập tức — tạo một key mới, deploy nó, sau đó xóa key cũ. Credits đã tiêu hao không thể hoàn lại, vì vậy hãy rotate trước rồi điều tra sau.

Endpoint và tài liệu tham khảo

Mọi số liệu trên trang này đều lấy từ tài liệu Photta API · đã kiểm tra 2026-09-10

Thử nghiệm API trong năm phút

Tạo một Photta API key, dán đoạn mã cURL ở trên, và bạn sẽ nhận được bức ảnh mẫu mặc đồ đầu tiên trước khi pha xong ly cà phê.

Tạo tài khoản và lấy API key API

Bearer key
600 requests/min
async, polling