Sửa ảnh
Sửa một ảnh có sẵn theo hướng dẫn bằng chữ: giữ nhân vật/bố cục gốc, đổi màu, làm mịn, thay chi tiết.
Đã triển khai
Request
POST
/images/editsCần header Authorization: Bearer apl_...
| Field | Kiểu | Mô tả |
|---|---|---|
modelbắt buộc | string | Public model ID có kind là IMAGE. |
promptbắt buộc | string | Hướng dẫn sửa. Càng cụ thể càng giữ đúng ảnh gốc. |
image.b64_json | string | Ảnh nguồn dạng base64 thuần. Cần kèm mime_type. |
image.data_url | string | Hoặc data URL data:image/png;base64,... — khi đó không cần mime_type. |
image.mime_type | "image/png" | "image/jpeg" | "image/webp" | Bắt buộc khi dùng b64_json. Tối đa 8 MB sau khi decode. |
Response
| Field | Kiểu | Mô tả |
|---|---|---|
data[].b64_jsonbắt buộc | string | Ảnh đã sửa, dạng base64. |
usage.imagesbắt buộc | integer | Số ảnh đã tính phí. |
Tính tiền
Theo số ảnh trả về, giống endpoint tạo ảnh.
Ví dụ
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\" }
}"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"));Lỗi
| HTTP | Mã | Ý nghĩa |
|---|---|---|
| 400 | invalid_request | Body không hợp lệ (thiếu field, sai kiểu, giá trị ngoài phạm vi). |
| 401 | auth_missing_or_malformed | Thiếu header Authorization hoặc sai định dạng. Phải là Bearer apl_.... |
| 401 | auth_invalid | API key không tồn tại. |
| 401 | auth_revoked | API key đã bị thu hồi. |
| 401 | auth_expired | API key đã hết hạn. |
| 400 | unknown_model | Model không tồn tại trong ApiLux. |
| 400 | capability_not_supported | Model có tồn tại nhưng không dùng được ở endpoint này (ví dụ dùng model text cho endpoint ảnh). |
| 503 | pricing_not_configured | Model đã có route nhưng chưa được cấu hình giá trong ApiLux. Đây là trạng thái phía chúng tôi, không phải lỗi của bạn. |
| 503 | model_disabled | Model đang bị tắt. |
| 503 | model_temporarily_unavailable | Model đang bật và có giá, nhưng nhà cung cấp phía sau hiện không phục vụ nó. Đây là trạng thái tạm thời và có thể tự hết — model sẽ xuất hiện lại trong GET /v1/models khi nhà cung cấp có nó trở lại. Bạn không bị trừ tiền và không có lời gọi nào tới nhà cung cấp. |
| 402 | insufficient_balance | Số dư ví không đủ để thực hiện request. |
| 429 | api_key_limit_exceeded | API key này đã chạm hạn mức bạn tự cấu hình. Ví vẫn còn tiền — chỉ key này không được tiêu thêm cho tới khi chu kỳ reset. Response kèm limit_type (spending | requests | tokens) và period (daily | monthly | lifetime). Hạn mức token của endpoint text được tính theo usage thực tế nên tổng có thể vượt tối đa một request. |
| 503 | api_key_quota_reconciliation_required | Một request text trước đó của chính key này chưa được đối soát xong. Thường gặp nhất: nhà cung cấp trả kết quả thành công nhưng không kèm usage token, nên hạn mức token của kỳ đó không còn đáng tin và ApiLux dừng lại thay vì để hạn mức bị vượt trong im lặng. Thử lại sẽ không qua được cho tới khi việc đó xong — hãy liên hệ hỗ trợ. Bạn không bị trừ tiền cho request bị chặn, không có lời gọi nào tới nhà cung cấp, và endpoint ảnh/video không bị ảnh hưởng. |
| 502 | upstream_error | Nhà cung cấp mô hình lỗi. Không bị trừ tiền. |
| 504 | upstream_timeout | Nhà cung cấp không phản hồi kịp. Không bị trừ tiền. |
| 429 | upstream_rate_limited | Bị giới hạn tốc độ. Thử lại sau vài giây. |
Ghi chú
Gửi ảnh dưới dạng JSON + base64, không dùng multipart. Giới hạn 8 MB mỗi ảnh, chỉ nhận PNG, JPEG, WEBP.