Quy trình tác vụ video

Tạo video trên PopGo là bất đồng bộ: gửi tác vụ, lưu ID, thăm dò trạng thái rồi tải kết quả khi hoàn tất.

Endpoint và trường

POST https://api.popgo.site/v1/videos
GET  https://api.popgo.site/v1/videos/{task_id}
GET  https://api.popgo.site/v1/videos/{task_id}/content
Authorization: Bearer YOUR_API_KEY

model và prompt là bắt buộc. duration / seconds, resolution, aspect_ratio và trường tham chiếu phải phù hợp với mô hình.

curl -X POST https://api.popgo.site/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL","prompt":"A bamboo forest in morning mist, slow camera movement","seconds":5,"resolution":"480p","aspect_ratio":"16:9"}'

Thăm dò và tiến độ

Trạng thái thường là queued, in_progress, completed, failed. Chỉ hiển thị phần trăm khi có trường progress; nếu không có, hiển thị đang xử lý. Khi hoàn tất, dùng URL kết quả hoặc /content. Lỗi 400 thường liên quan đến mô hình, kiểu dữ liệu, thời lượng, độ phân giải, tỷ lệ hoặc tài nguyên tham chiếu. Chi phí không tính theo số lần thăm dò.

Thăm dò,timeout và thử lại

Chỉ tạo một lần,lưu id,mô hình,thời lượng,độ phân giải,chế độ. Timeout có thể xảy ra sau khi nhận;kiểm tra tác vụ trước khi tạo lại. Thử lại truy vấn/tải cùng id không tạo video mới.

Thông thường3–5s,C10–15s,Kling khoảng10s và chờ ít nhất15 phút.429/502/503 hoặc lỗi mạng tạm dùng backoff giới hạn,tuân Retry-After. Sửa400;kiểm tra xác thực/quyền cho401/403. Hết hạn phía máy khách thì hiện chờ quá hạn và giữ ID,không kết luận dịch vụ lỗi.

progress có thể giữ0 rồi100 hoặc thiếu. model,usage,độ phân giải,thời lượng thực,fps cũng có thể thiếu. Giữ thông số đã gửi và kiểm tra tệp;thiếu usage không nghĩa miễn phí.queued/in_progress không phải thất bại.

URL có thể hết hạn hoặc cần xác thực;ưu tiên PopGo /content. Sau completed,thử tải lại giới hạn,không tạo lại. Tệp lớn cần thời gian,kiểm tra video thay vì trang lỗi JSON. Không gửi API Key PopGo tới máy chủ ngoài.

Năm giai đoạn chẩn đoán

Giai đoạn	Chứng minh được	Không chứng minh được
Kiểm tra giao diện	Chế độ,số lượng,nguồn được nhận cục bộ	Chưa có yêu cầu không phải dịch vụ từ chối
Phân tích và khả năng PopGo	400/500 có trước tạo hay không	Không có log không tự chứng minh nhà cung cấp lỗi
Yêu cầu gửi đi	Trường và vai trò ảnh/video/âm thanh	Trường đúng không bảo đảm đọc tệp được
Nhận và thăm dò	ID,trạng thái,giai đoạn lỗi	200 hoặc ID không chứng minh dùng tham chiếu hay miễn phí
Media cuối	Ảnh hưởng lên khung hình,chủ thể,chuyển động,âm thanh	URL tải không chứng minh chất lượng

Ghi mô hình,thời gian,ID giả,chế độ,số/nguồn và lỗi ngắn;không Key,Cookie,URL ký hoặc tệp riêng tư. Phân biệt thiếu năng lực với kiểm duyệt;thất bại vẫn cần kiểm tra hóa đơn. Sửa nguyên nhân trước khi phát sinh phí mới.