Nhật ký và tác vụ bất đồng bộ

Nền tảng lưu riêng chi tiết yêu cầu, bản ghi vẽ ảnh và các tác vụ bất đồng bộ như video, nhạc. Sau khi đăng nhập, bạn có thể vào «Nhật ký sử dụng» hoặc «Nhật ký tác vụ» từ thanh điều hướng bên trái. Trang này trình bày thống nhất ba phân vùng dữ liệu, trạng thái tác vụ và cách truy vấn qua API.

Ba phân vùng tương ứng các đường dẫn sau:

/usage-logs/common: nhật ký sử dụng API chung và chi tiết tính phí;
/usage-logs/drawing: tác vụ vẽ Midjourney;
/usage-logs/task: tác vụ bất đồng bộ chung như Suno, video.

Nhật ký sử dụng

Bấm «Nhật ký sử dụng» ở thanh bên trái hoặc truy cập /usage-logs/common để xem yêu cầu API và chi tiết tính phí.

Lọc bản ghi

Mục lọc	Mô tả
Khoảng thời gian	Lọc theo thời điểm tạo bản ghi; cả mốc đầu và mốc cuối đều nằm trong phạm vi truy vấn.
Tên mô hình	Lọc theo tên mô hình.
Nhóm	Lọc theo nhóm mà yêu cầu đã dùng.
Loại nhật ký	Tất cả, nạp tiền, tiêu thụ, quản lý, hệ thống, lỗi, hoàn tiền, đăng nhập.
Tên token	Lọc theo tên khóa API.
Mã yêu cầu	Định vị một yêu cầu theo mã yêu cầu của nền tảng.
Mã yêu cầu thượng nguồn	Định vị yêu cầu theo mã do dịch vụ thượng nguồn trả về. Kèm mã này khi phản hồi sự cố sẽ giúp tra soát nhanh hơn nhiều.

Thống kê trên trang

Giá trị thống kê trên thanh lọc thay đổi theo điều kiện lọc hiện tại:

Usage: tổng hạn mức của các bản ghi tiêu thụ trong phạm vi lọc hiện tại, xem được theo thời gian, mô hình, nhóm và khóa.
RPM: số yêu cầu tiêu thụ trong 60 giây gần nhất.
TPM: tổng token đầu vào và đầu ra trong 60 giây gần nhất.

Danh sách và chi tiết

Danh sách gồm các cột thời gian và loại, token, mô hình, luồng, Tokens, chi phí, thời lượng và chi tiết.

Tokens: hiển thị token đầu vào / token đầu ra; khi dùng bộ nhớ đệm còn có thể hiển thị số lần đọc và ghi cache.
Chi phí: hiển thị hạn mức tiêu thụ hoặc kết quả hoàn hạn mức của bản ghi.
Thời lượng: hiển thị thời gian phản hồi cho các bản ghi tiêu thụ hoặc lỗi có dữ liệu đo; yêu cầu dạng luồng còn có thể hiển thị thời gian phản hồi đầu tiên (FRT) và thông tin thông lượng.
Chi tiết: bấm vào bản ghi để mở hộp thoại chi tiết. Tùy loại nhật ký và các trường thực sự được lưu, hộp thoại có thể chứa mã yêu cầu, ánh xạ mô hình, lý do lỗi hoặc hoàn tiền, chi tiết token, chi tiết tính phí, mức dùng cache/âm thanh/hình ảnh, trạng thái luồng…; không phải bản ghi nào cũng hiển thị đủ mọi khối.

Vì sao không thấy một bản ghi

Nhật ký ghi trễ một chút: yêu cầu vừa gửi có thể mất vài giây mới xuất hiện, nên hãy tải lại trang trước khi kết luận là thiếu.

Không phải phản hồi thất bại nào cũng sinh bản ghi Error: các yêu cầu bị chặn trước khi tới mô hình (khóa không hợp lệ, không đủ hạn mức) thường không tạo bản ghi tiêu thụ nào.

Tùy chọn «Ghi lại địa chỉ IP» trong hồ sơ chỉ ảnh hưởng tới việc có lưu IP yêu cầu trong nhật ký tiêu thụ và nhật ký lỗi hay không, không ảnh hưởng tới việc bản ghi có được tạo hay không.

Nhật ký tác vụ

«Nhật ký tác vụ» gồm hai phân vùng con là «Nhật ký vẽ» và «Nhật ký tác vụ»:

Nhật ký vẽ: ghi lại tác vụ vẽ Midjourney.
Nhật ký tác vụ: ghi lại các tác vụ bất đồng bộ như tạo video từ văn bản, tạo video từ ảnh, tạo âm thanh.

Nhật ký vẽ

Bấm «Nhật ký tác vụ» → «Nhật ký vẽ» ở thanh bên trái hoặc truy cập /usage-logs/drawing để xem bản ghi tác vụ vẽ Midjourney.

Nhật ký vẽ hỗ trợ lọc theo:

khoảng ngày;
mã tác vụ Midjourney.

Danh sách gồm thời gian và trạng thái gửi, loại thao tác, mã tác vụ, thời lượng, kết quả gửi, tiến độ, hình ảnh, prompt và lý do thất bại. Bấm vào ảnh để xem trước; bấm vào prompt để xem đầy đủ; bấm vào lý do thất bại để xem toàn bộ thông tin lỗi.

Trạng thái vẽ gồm: chưa bắt đầu, trong hàng đợi, đang thực thi, thành công, thất bại, chờ cửa sổ.

Nhật ký tác vụ bất đồng bộ

Bấm «Nhật ký tác vụ» → «Nhật ký tác vụ» ở thanh bên trái hoặc truy cập /usage-logs/task để xem nhật ký tác vụ bất đồng bộ.

Các endpoint bất đồng bộ như video, nhạc không trả kết quả cuối ngay khi gửi yêu cầu. Sau khi gửi thành công, nền tảng trả về mã tác vụ công khai và lưu bản ghi tác vụ, sau đó tiến trình nền hỏi dịch vụ thượng nguồn để cập nhật trạng thái, tiến độ và kết quả.

Lọc tác vụ

Nhật ký tác vụ hỗ trợ lọc theo:

khoảng ngày;
mã tác vụ.

Danh sách và kết quả

Danh sách tác vụ hiển thị thời gian gửi và hoàn tất, mã tác vụ, nền tảng và thao tác, thời lượng, trạng thái, tiến độ và chi tiết:

khi tác vụ Suno thành công và trả về địa chỉ âm thanh, cột chi tiết cung cấp bản xem trước âm thanh;
một số tác vụ video sau khi thành công sẽ hiển thị lối vào xem trước; bạn cũng có thể dùng phiên đăng nhập hoặc khóa API của cùng tài khoản để gọi /v1/videos/{task_id}/content nhằm lấy nội dung video của tác vụ đã hoàn tất. Endpoint này kiểm tra quyền sở hữu tác vụ và sẽ không trả nội dung nếu tác vụ chưa hoàn tất hoặc không thuộc người dùng hiện tại;
các bản ghi thất bại khác sẽ hiển thị lý do trong cột chi tiết, bấm vào để xem đầy đủ.

Trạng thái tác vụ và xử lý nền

Nhật ký tác vụ bất đồng bộ dùng các giá trị trạng thái sau. Mỗi nền tảng có thể viết trạng thái hơi khác nhau, nên khi đọc qua API hãy xử lý linh hoạt.

Trạng thái	Ý nghĩa
Chưa bắt đầu	Bản ghi tác vụ đã tạo nhưng chưa bắt đầu xử lý.
Trong hàng đợi	Đã gửi lên thượng nguồn, chờ xử lý tiếp.
Đang xếp hàng	Đã vào hàng đợi xử lý.
Đang thực thi	Đang được xử lý.
Thành công	Đã hoàn tất, có thể xem hoặc lấy kết quả.
Thất bại	Xử lý thất bại; lý do sẽ được ghi vào bản ghi tác vụ (nếu thượng nguồn cung cấp).
Không rõ	Giá trị dự phòng cho trạng thái không xác định theo định nghĩa nội bộ.

Trạng thái tác vụ do tiến trình nền cập nhật khoảng 15 giây một lần nên tác vụ vừa gửi sẽ trễ một chút. Khi truy vấn kết quả qua API, hãy đặt nhịp hỏi tương đương thay vì lặp với tần suất cao. Tác vụ mãi không hoàn tất sẽ chuyển sang trạng thái thất bại sau khi hết hạn.

Thất bại, hết hạn và hoàn hạn mức

Sau khi tác vụ rơi vào trạng thái thất bại cuối cùng, nếu ở bước gửi có trừ trước hạn mức thì hệ thống thường sẽ thử hoàn lại và ghi một bản ghi nhật ký «hoàn tiền» khi thành công. Sau khi hoàn thành công, hệ thống xóa phần hạn mức chờ hoàn trong bản ghi tác vụ và trừ ngược mức dùng tích lũy; số lượt yêu cầu không được hoàn lại.

Các tình huống sau có thể khiến trạng thái trên trang và số dư tạm thời không khớp:

tác vụ vốn không có hạn mức trừ trước (chi phí hiển thị là 0);
việc hoàn hạn mức chưa thành công và hệ thống đang giữ lại để thử lại hoặc đối soát thủ công. Trường hợp này hãy giữ mã tác vụ và liên hệ bộ phận hỗ trợ.

Tham chiếu API

Endpoint truy vấn nhật ký

Nếu muốn đưa dữ liệu mức dùng vào hệ thống đối soát hoặc giám sát của riêng bạn, hãy dùng các endpoint chỉ đọc sau. Chúng xác thực bằng phiên đăng nhập và luôn trả về kết quả giới hạn trong tài khoản của bạn.

Dữ liệu	Endpoint	Đơn vị tham số thời gian
Nhật ký chung	`GET /api/log/self`	giây (`created_at`)
Thống kê nhật ký	`GET /api/log/self/stat`	giây
Vẽ Midjourney	`GET /api/mj/self`	mili giây (`submit_time`)
Tác vụ bất đồng bộ	`GET /api/task/self`	giây (`submit_time`)

Các endpoint này dùng tham số phân trang p và page_size; số trang bắt đầu từ 1, page_size vượt quá 100 sẽ bị cắt về 100.

Ngoài ra, GET /api/log/token đọc nhật ký gần đây của một khóa bằng chính khóa API đó, không cần phiên đăng nhập — tiện để tự kiểm tra mức dùng ở phía máy chủ. Tối đa trả về 1000 bản ghi gần nhất, và vẫn hoạt động kể cả khi khóa đã hết hạn hoặc hết hạn mức.

Tham số truy vấn thường dùng của GET /api/task/self: p, page_size, task_id, start_timestamp, end_timestamp; cũng chấp nhận platform, action, status.

Tham số start_timestamp, end_timestamp của endpoint tác vụ dùng dấu thời gian Unix theo giây; tham số thời gian của endpoint vẽ Midjourney dùng mili giây.

Endpoint sinh nội dung bất đồng bộ và tác vụ

Các endpoint dưới đây dùng để gửi và truy vấn tác vụ bất đồng bộ như video, nhạc và vẽ; tất cả đều xác thực bằng khóa API. Endpoint nội dung video còn chấp nhận phiên đăng nhập và luôn kiểm tra quyền sở hữu tác vụ, nên chỉ trả về nội dung tác vụ của chính bạn.

Những nền tảng nào khả dụng phụ thuộc vào các mô hình đang mở — có thể lọc theo loại mô hình trong Thư viện mô hình để kiểm tra.

Endpoint	Đường dẫn	Mô tả
Tạo video OpenAI	`POST /v1/videos`	Tạo tác vụ sinh video bất đồng bộ tương thích OpenAI, trả về mã tác vụ khi thành công.
Truy vấn tác vụ video OpenAI	`GET /v1/videos/{task_id}`	Truy vấn trạng thái, tiến độ và kết quả của tác vụ sinh video.
Lấy nội dung video	`GET /v1/videos/{task_id}/content`	Trả về nội dung video đã hoàn tất theo luồng; hệ thống lấy nội dung từ thượng nguồn theo kết quả tác vụ hoặc giải mã data URL đã lưu.
Remix video	`POST /v1/videos/{video_id}/remix`	Gửi tác vụ Remix bất đồng bộ mới dựa trên video đã có.
Tạo video (đường dẫn cũ)	`POST /v1/video/generations`	Tương thích đường dẫn tạo video cũ, tạo tác vụ video bất đồng bộ.
Truy vấn tác vụ video (đường dẫn cũ)	`GET /v1/video/generations/{task_id}`	Truy vấn trạng thái và kết quả của tác vụ tạo video theo đường dẫn cũ.
Kling: văn bản sang video	`POST /kling/v1/videos/text2video`	Gửi tác vụ tạo video từ văn bản theo định dạng Kling; hệ thống chuyển đổi định dạng yêu cầu trước.
Kling: ảnh sang video	`POST /kling/v1/videos/image2video`	Gửi tác vụ tạo video từ ảnh theo định dạng Kling.
Truy vấn tác vụ Kling	`GET /kling/v1/videos/text2video/{task_id}` `GET /kling/v1/videos/image2video/{task_id}`	Truy vấn kết quả tác vụ Kling tạo video từ văn bản hoặc từ ảnh.
Endpoint chính thức Jimeng	`POST /jimeng/`	Tương thích định dạng API chính thức của Jimeng, dùng các tham số như `Action`, `Version` để phân biệt gửi tác vụ và truy vấn.
Gửi tác vụ Suno	`POST /suno/submit/{action}`	Gửi tác vụ tạo nhạc Suno; loại tác vụ do tham số `action` quyết định.
Truy vấn tác vụ Suno	`POST /suno/fetch` `GET /suno/fetch/{id}`	Truy vấn danh sách tác vụ Suno hoặc trạng thái và kết quả của một tác vụ.
Gửi tác vụ Midjourney	`POST /mj/submit/{action}` `POST /{mode}/mj/submit/{action}`	Hỗ trợ các thao tác `imagine`, `describe`, `blend`, `change`, `simple-change`, `edits`, `video`, `action`, `modal` và `shorten`.
Truy vấn tác vụ Midjourney	`GET /mj/task/{id}/fetch` `GET /mj/task/{id}/image-seed` `POST /mj/task/list-by-condition`	Truy vấn trạng thái tác vụ, seed hình ảnh hoặc danh sách tác vụ theo điều kiện; cũng hỗ trợ đường dẫn có tiền tố `{mode}`.
Proxy hình ảnh Midjourney	`GET /mj/image/{id}` `GET /{mode}/mj/image/{id}`	Lấy hoặc chuyển tiếp hình ảnh được tạo theo mã tác vụ Midjourney.
Thao tác mở rộng Midjourney	`POST /mj/insight-face/swap` `POST /mj/submit/upload-discord-images`	Cung cấp các tính năng mở rộng như hoán đổi khuôn mặt và tải ảnh lên Discord.

Quan hệ với bảng điều khiển

Nhật ký là chi tiết từng bản ghi, còn bảng điều khiển là số liệu đã tổng hợp theo thời gian, mô hình và nhóm. Hai bên làm mới vào những thời điểm khác nhau: yêu cầu mới xuất hiện trong nhật ký trước, còn biểu đồ chỉ đổi sau khi tổng hợp, nên lệch nhau trong thời gian ngắn là bình thường.

Khi truy vết một lần gọi, nên định vị yêu cầu trong nhật ký sử dụng theo thời gian, mô hình, Request ID hoặc Upstream Request ID; với yêu cầu bất đồng bộ thì ghi lại task_id mà endpoint gửi trả về, sau đó truy vấn trạng thái cuối cùng và chi tiết thất bại của tác vụ. Khi cần liên hệ bộ phận hỗ trợ, kèm theo mã yêu cầu hoặc mã tác vụ là cách nhanh nhất.