ApiLux

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 khaiKhả dụng hay không còn phụ thuộc model bạn chọn đã được bật và có giá trong ApiLux.

Request

POST/images/edits

Cần header Authorization: Bearer apl_...

FieldKiểuMô tả
modelbắt buộcstringPublic model ID có kindIMAGE.
promptbắt buộcstringHướng dẫn sửa. Càng cụ thể càng giữ đúng ảnh gốc.
image.b64_jsonstringẢnh nguồn dạng base64 thuần. Cần kèm mime_type.
image.data_urlstringHoặ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

FieldKiểuMô tả
data[].b64_jsonbắt buộcstringẢnh đã sửa, dạng base64.
usage.imagesbắt buộcintegerSố ảnh đã tính phí.

Tính tiền

Theo số ảnh trả về, giống endpoint tạo ảnh.

Ví dụ

cURL
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
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Ý nghĩa
400invalid_requestBody không hợp lệ (thiếu field, sai kiểu, giá trị ngoài phạm vi).
401auth_missing_or_malformedThiếu header Authorization hoặc sai định dạng. Phải là Bearer apl_....
401auth_invalidAPI key không tồn tại.
401auth_revokedAPI key đã bị thu hồi.
401auth_expiredAPI key đã hết hạn.
400unknown_modelModel không tồn tại trong ApiLux.
400capability_not_supportedModel có tồn tại nhưng không dùng được ở endpoint này (ví dụ dùng model text cho endpoint ảnh).
503pricing_not_configuredModel đã 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.
503model_disabledModel đang bị tắt.
503model_temporarily_unavailableModel đ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.
402insufficient_balanceSố dư ví không đủ để thực hiện request.
429api_key_limit_exceededAPI 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.
503api_key_quota_reconciliation_requiredMộ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.
502upstream_errorNhà cung cấp mô hình lỗi. Không bị trừ tiền.
504upstream_timeoutNhà cung cấp không phản hồi kịp. Không bị trừ tiền.
429upstream_rate_limitedBị 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.