# ApiLux API
Tài liệu này **sinh tự động** từ contract đang chạy của ApiLux. Mọi endpoint dưới đây đều đã triển khai.
- **Base URL**: `https://apilux.net/api/v1`
- **Xác thực**: `Authorization: Bearer apl_YOUR_API_KEY`
- **Biến môi trường**: `APILUX_BASE_URL`, `APILUX_API_KEY`
- **Đơn vị tiền**: 1 credit = 1 VND
## Bảo mật API key
- Khoá hiện ra **đúng một lần** lúc tạo — ApiLux chỉ lưu bản băm, không lưu bản gốc.
- Chỉ dùng khoá ở **phía máy chủ**. Đặt vào mã frontend là công khai nó.
- Khoá bị lộ thì thu hồi ngay ở `/api-keys`; thu hồi có hiệu lực tức thì.
- Đặt hạn mức cho từng khoá để một khoá bị lạm dụng không tiêu hết ví.
## Bắt đầu nhanh
Thay `MODEL_ID` bằng một ID lấy từ `GET /models`.
### cURL
```bash
curl https://apilux.net/api/v1/chat/completions \
-H "Authorization: Bearer apl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [{ "role": "user", "content": "Xin chào" }]
}'
```
### Node.js
```javascript
const res = await fetch("https://apilux.net/api/v1/chat/completions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.APILUX_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "MODEL_ID",
messages: [{ role: "user", content: "Xin chào" }],
}),
});
const data = await res.json();
console.log(data.choices[0].message.content);
```
### Python
```python
import os, requests
res = requests.post(
"https://apilux.net/api/v1/chat/completions",
headers={
"Authorization": f"Bearer {os.environ['APILUX_API_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "Xin chào"}],
},
)
print(res.json()["choices"][0]["message"]["content"])
```
> **Timeout phía client**: chat vài giây là đủ; **tạo ảnh nên đặt 180–360 giây**; video trả về job ngay rồi poll.
## Danh sách endpoint
### GET /models
**Danh sách model** — Trả về các model bạn gọi được ngay lúc này. Model chưa cấu hình giá hoặc đang tắt sẽ không xuất hiện.
Tính tiền: Miễn phí, không trừ credit.
| Trường response | Kiểu | Mô tả |
|---|---|---|
| `data[].id` | `string` | Public model ID dùng trong field `model` của các request khác. |
| `data[].kind` | `"TEXT" | "IMAGE" | "VIDEO"` | Loại model. |
| `data[].capabilities` | `string[]` | Các endpoint model này dùng được. |
| `data[].price_credit_per_unit` | `integer` | Giá bán, tính bằng credit (1 credit = 1 VND) trên một đơn vị. |
| `data[].billing_unit` | `"million_tokens" | "image" | "second"` | Đơn vị tính tiền tương ứng. |
cURL
```bash
curl https://apilux.net/api/v1/models \
-H "Authorization: Bearer apl_YOUR_API_KEY"
```
Node.js
```javascript
const res = await fetch("https://apilux.net/api/v1/models", {
headers: { Authorization: `Bearer ${process.env.APILUX_API_KEY}` },
});
const { data } = await res.json();
console.log(data.map((m) => m.id));
```
Python
```python
import os, requests
res = requests.get(
"https://apilux.net/api/v1/models",
headers={"Authorization": f"Bearer {os.environ['APILUX_API_KEY']}"},
)
print([m["id"] for m in res.json()["data"]])
```
cURL
```bash
curl https://apilux.net/api/v1/chat/completions \
-H "Authorization: Bearer apl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [{ "role": "user", "content": "Xin chào" }]
}'
```
Node.js
```javascript
const res = await fetch("https://apilux.net/api/v1/chat/completions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.APILUX_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "MODEL_ID",
messages: [{ role: "user", content: "Xin chào" }],
}),
});
const data = await res.json();
console.log(data.choices[0].message.content);
```
Python
```python
import os, requests
res = requests.post(
"https://apilux.net/api/v1/chat/completions",
headers={
"Authorization": f"Bearer {os.environ['APILUX_API_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "Xin chào"}],
},
)
print(res.json()["choices"][0]["message"]["content"])
```
cURL
```bash
curl https://apilux.net/api/v1/chat \
-H "Authorization: Bearer apl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [{ "role": "user", "content": "Xin chào" }]
}'
```
cURL
```bash
curl https://apilux.net/api/v1/messages \
-H "Authorization: Bearer apl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"max_tokens": 1024,
"messages": [{ "role": "user", "content": "Xin chào" }]
}'
```
Node.js
```javascript
const res = await fetch("https://apilux.net/api/v1/messages", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.APILUX_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "MODEL_ID",
max_tokens: 1024,
messages: [{ role: "user", content: "Xin chào" }],
}),
});
const data = await res.json();
console.log(data.content[0].text);
```
Python
```python
import os, requests
res = requests.post(
"https://apilux.net/api/v1/messages",
headers={
"Authorization": f"Bearer {os.environ['APILUX_API_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "MODEL_ID",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Xin chào"}],
},
)
print(res.json()["content"][0]["text"])
```
cURL
```bash
curl https://apilux.net/api/v1/messages/count_tokens \
-H "Authorization: Bearer apl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [{ "role": "user", "content": "Xin chào" }]
}'
```
cURL
```bash
curl https://apilux.net/api/v1/responses \
-H "Authorization: Bearer apl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"input": "Xin chào"
}'
```
cURL
```bash
curl https://apilux.net/api/v1/images/generations \
-H "Authorization: Bearer apl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
--max-time 360 \
-d '{
"model": "IMAGE_MODEL_ID",
"prompt": "Giao diện SaaS sáng, tối giản",
"size": "1024x1024"
}' \
| jq -r '.data[0].b64_json' | base64 -d > image.png
```
Node.js
```javascript
import { writeFileSync } from "node:fs";
const res = await fetch("https://apilux.net/api/v1/images/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.APILUX_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "IMAGE_MODEL_ID",
prompt: "Giao diện SaaS sáng, tối giản",
}),
});
const data = await res.json();
writeFileSync("image.png", Buffer.from(data.data[0].b64_json, "base64"));
```
Python
```python
import base64, os, requests
res = requests.post(
"https://apilux.net/api/v1/images/generations",
headers={"Authorization": f"Bearer {os.environ['APILUX_API_KEY']}"},
json={"model": "IMAGE_MODEL_ID", "prompt": "Giao diện SaaS sáng, tối giản"},
timeout=360,
)
with open("image.png", "wb") as f:
f.write(base64.b64decode(res.json()["data"][0]["b64_json"]))
```
cURL
```bash
IMG=$(base64 -w 0 source.png)
curl https://apilux.net/api/v1/images/edits \
-H "Authorization: Bearer apl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
--max-time 360 \
-d "{
\"model\": \"IMAGE_MODEL_ID\",
\"prompt\": \"Giữ nguyên nhân vật, chỉ làm sáng nền\",
\"image\": { \"b64_json\": \"$IMG\", \"mime_type\": \"image/png\" }
}"
```
Node.js
```javascript
import { readFileSync, writeFileSync } from "node:fs";
const res = await fetch("https://apilux.net/api/v1/images/edits", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.APILUX_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "IMAGE_MODEL_ID",
prompt: "Giữ nguyên nhân vật, chỉ làm sáng nền",
image: {
b64_json: readFileSync("source.png").toString("base64"),
mime_type: "image/png",
},
}),
});
const data = await res.json();
writeFileSync("edited.png", Buffer.from(data.data[0].b64_json, "base64"));
```
cURL
```bash
curl https://apilux.net/api/v1/videos/generations \
-H "Authorization: Bearer apl_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "VIDEO_MODEL_ID",
"prompt": "Sáng sớm trên biển, chuyển động điện ảnh",
"duration_seconds": 4,
"aspect_ratio": "16:9"
}'
```
Python
```python
import os, time, requests
BASE = "https://apilux.net/api/v1"
HEAD = {"Authorization": f"Bearer {os.environ['APILUX_API_KEY']}"}
job = requests.post(
f"{BASE}/videos/generations",
headers=HEAD,
json={
"model": "VIDEO_MODEL_ID",
"prompt": "Sáng sớm trên biển, chuyển động điện ảnh",
"duration_seconds": 4,
},
).json()
while True:
time.sleep(5)
state = requests.get(f"{BASE}/videos/generations/{job['id']}", headers=HEAD).json()
if state["status"] in ("completed", "failed"):
break
if state["status"] == "completed":
mp4 = requests.get(BASE.rsplit("/v1", 1)[0] + state["content_url"], headers=HEAD)
open("video.mp4", "wb").write(mp4.content)
```
cURL
```bash
curl https://apilux.net/api/v1/videos/generations/vidjob_YOUR_JOB_ID \
-H "Authorization: Bearer apl_YOUR_API_KEY"
```
cURL
```bash
curl https://apilux.net/api/v1/videos/generations/vidjob_YOUR_JOB_ID/content \
-H "Authorization: Bearer apl_YOUR_API_KEY" \
-o video.mp4
```