Lấy khóa API
Đăng nhập vào Bảng điều khiển → Khóa API để tạo khóa. pk_live dành cho frontend, sk_live dành cho phía máy chủ.
Gửi một yêu cầu
Gửi prompt và một slug kênh đến điểm truy cập của trung tâm; trung tâm tự động phân phối theo phương thức và tình trạng.
Nhận kết quả / đo lường
Trả về kết quả và số Prisms đã tiêu thụ. Nếu một kênh gặp lỗi, hệ thống tự động định tuyến lại — đo lường minh bạch.
Một yêu cầu tạo hình ảnh tối thiểu có thể chạy được. Chỉ cần thay YOUR_API_KEY bằng khóa của bạn.
curl -X POST https://api.refractnest.dev/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "forge-pro",
"prompt": "a cozy pixel-art control tower at sunrise",
"n": 1
}'
{
"task_id": "t_9af31c",
"model": "forge-pro",
"status": "done",
"cost_prisms": 8,
"data": [{ "url": "https://cdn.refractnest.dev/o/9af31c.png" }]
}
Điểm cuối (Endpoints)
| Phương thức | Điểm cuối | Mục đích |
|---|---|---|
| POST | /v1/images/generations | Tạo hình ảnh (kèm slug mô hình) |
| GET | /v1/tasks/{task_id} | Truy vấn trạng thái và kết quả tác vụ |
| GET | /v1/models | Liệt kê các kênh khả dụng và Prisms |
| GET | /v1/account/balance | Truy vấn số dư Prisms (gồm phần miễn phí + phần đã mua) |
Các slug kênh khả dụng
Thay model bằng bất kỳ slug nào bên dưới để chuyển kênh AI phía sau. Danh sách đầy đủ và tình trạng có tại trang Mô hình。
| slug | Phương thức | Mỗi lần | Trạng thái |
|---|---|---|---|
| forge-v8 | IMAGE | 10 Prisms | Khỏe mạnh |
| forge-v7 | IMAGE | 8 Prisms | Khỏe mạnh |
| forge-v6 | IMAGE | 6 Prisms | Khỏe mạnh |
| prism-type | IMAGE | 6 Prisms | Suy giảm |
| lumen-pro | TEXT | 2 Prisms | Suy giảm |
| lumen-lite | TEXT | 1 Prisms | Suy giảm |
| prism-art | IMAGE | 5 Prisms | Suy giảm |
| lumen-flash | TEXT | 1 Prisms | Suy giảm |
| lumen-max | TEXT | 3 Prisms | Suy giảm |
| prism-hd | IMAGE | 5 Prisms | Suy giảm |
Sẵn sàng gửi yêu cầu đầu tiên?
Đăng nhập Bảng điều khiển để lấy khóa · 50 Prisms miễn phí mỗi ngày · một điểm truy cập đến mọi AI lớn.
▶ Lấy khóa API