# ApiLux API
This document is **generated** from ApiLux's live contract. Every endpoint below is implemented.
- **Base URL**: `https://apilux.net/api/v1`
- **Authentication**: `Authorization: Bearer apl_YOUR_API_KEY`
- **Environment variables**: `APILUX_BASE_URL`, `APILUX_API_KEY`
- **Currency**: 1 credit = 1 VND
## API key security
- A key is shown **exactly once** at creation — ApiLux stores only a hash, never the original.
- Use keys **server-side only**. Putting one in frontend code publishes it.
- If a key leaks, revoke it in `/api-keys`; revocation is immediate.
- Set per-key limits so one abused key cannot drain the wallet.
## Quick start
Replace `MODEL_ID` with an ID from `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"])
```
> **Client timeouts**: seconds are enough for chat; **use 180–360s for image generation**; video returns a job immediately, then poll.
## Endpoints
### GET /models
**List models** — Returns the models you can call right now. Models without a configured price, or that are disabled, are not listed.
Billing: Free — no credit is charged.
| Response field | Type | Description |
|---|---|---|
| `data[].id` | `string` | Public model ID to send in the `model` field of other requests. |
| `data[].kind` | `"TEXT" | "IMAGE" | "VIDEO"` | Model kind. |
| `data[].capabilities` | `string[]` | Endpoints this model can be used with. |
| `data[].price_credit_per_unit` | `integer` | Sale price in credits (1 credit = 1 VND) per unit. |
| `data[].billing_unit` | `"million_tokens" | "image" | "second"` | The unit the price applies to. |
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
```