Lấy nhiều tác vụ theo lô
API origin:
https://api.openaihub.net. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn.
OpenAPI Specification
Phần tiêu đề “OpenAPI Specification”openapi: 3.0.1info: title: '' description: '' version: 1.0.0paths: /luma/tasks: post: summary: Lấy nhiều tác vụ theo lô deprecated: false description: >- Truy vấn trạng thái của nhiều tác vụ theo lô dựa trên danh sách ID.
"state": "completed" các giá trị liệt kê: "pending", "processing", "completed", "failed" operationId: luma_luma_tasks tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Luma/Các tác vụ truy vấn - Luma parameters: [] requestBody: content: application/json: schema: type: object required: - ids properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của ảnh được tạo, không bắt buộc, các giá trị có thể dùng: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3 callback_url: type: string description: >- Địa chỉ nhận thông báo gọi lại, không bắt buộc. Khi trạng thái tác vụ thay đổi, hệ thống sẽ gửi thông báo đến địa chỉ này. ids: type: array items: type: string description: Danh sách ID tác vụ image: type: string description: >- Hình ảnh tham chiếu, không bắt buộc, hỗ trợ mã hóa Base64 hoặc URL hình ảnh, hỗ trợ định dạng .jpg/.jpeg/.png, dung lượng không được vượt quá 10MB image_fidelity: type: number description: >- Cường độ ảnh hưởng của ảnh tham chiếu, tùy chọn, phạm vi giá trị: 0-1; giá trị càng lớn thì ảnh được tạo càng giống với ảnh tham chiếu. model: type: string description: Mô hình sử dụng, không bắt buộc, mặc định là kling-image 'n': type: integer description: >- Số lượng hình ảnh được tạo, không bắt buộc, phạm vi giá trị: 1-9 negative_prompt: type: string description: >- Câu lệnh phủ định, không bắt buộc, mô tả các yếu tố bạn không muốn xuất hiện trong hình ảnh, không được vượt quá 200 ký tự prompt: type: string description: >- Từ khóa mô tả tích cực, bắt buộc, mô tả nội dung hình ảnh bạn muốn tạo, không được vượt quá 500 ký tự refName: PostLumaTasksRequest x-apifox-orders: - aspect_ratio - callback_url - ids - image - image_fidelity - model - 'n' - negative_prompt - prompt x-apidog-orders: - aspect_ratio - callback_url - ids - image - image_fidelity - model - 'n' - negative_prompt - prompt examples: example_single: value: ids: - a1b2c3d4-e5f6-7890-abcd-ef1234567890 - b2c3d4e5-f6a7-8901-bcde-f12345678901 summary: example_single description: Tác vụ truy vấn theo lô example_single_2: value: ids: - 4665a07c-7641-4809-a133-10786201bb56 summary: example_single_2 description: Nhận tác vụ theo lô responses: '200': description: thành công content: application/json: schema: type: array items: type: object properties: batch_id: type: string description: Mã lô created_at: type: string format: date-time description: Thời gian tạo estimate_wait_seconds: type: integer description: >- Thời gian chờ ước tính (giây) Thời gian chờ ước tính (giây) nullable: true id: type: string description: Mã tác vụ Mã tác vụ last_frame: type: object properties: url: type: string description: URL tài nguyên description: URL hình ảnh của khung hình cuối x-apifox-orders: - url x-apidog-orders: - url nullable: true prompt: type: string description: Các từ dùng trong lời nhắc Các từ dùng trong lời nhắc queue_state: type: string description: Trạng thái hàng đợi nullable: true state: type: string enum: - queued - pending - processing - completed - failed description: trạng thái tác vụ trạng thái tác vụ thumbnail: type: object properties: url: type: string description: URL tài nguyên description: URL hình thu nhỏ x-apifox-orders: - url x-apidog-orders: - url nullable: true video: type: object properties: height: type: integer description: Chiều cao (pixel) url: type: string description: Tạo URL video (khả dụng khi state=completed) width: type: integer description: Chiều rộng (pixel) description: URL hoặc mã định danh video x-apifox-orders: - height - url - width x-apidog-orders: - height - url - width nullable: true refName: LumaGenerationResponse x-apifox-orders: - batch_id - created_at - estimate_wait_seconds - id - last_frame - prompt - queue_state - state - thumbnail - video x-apidog-orders: - batch_id - created_at - estimate_wait_seconds - id - last_frame - prompt - queue_state - state - thumbnail - video examples: example: summary: example value: - batch_id: chuỗi created_at: chuỗi estimate_wait_seconds: 0 id: string last_frame: url: string prompt: chuỗi queue_state: chuỗi state: đã xếp hàng thumbnail: url: string video: height: 0 url: string width: 0 headers: {} x-apidog-name: thành công '400': description: Yêu cầu không hợp lệ hoặc xác thực thất bại content: application/json: schema: type: object required: - error properties: error: type: object required: - message - type properties: message: type: string description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu) type: type: string description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error examples: - new_api_error x-apifox-orders: - message - type x-apidog-orders: - message - type refName: NewApiError x-apifox-orders: - error x-apidog-orders: - error examples: example: summary: example value: error: message: >- Yêu cầu không hợp lệ (mã yêu cầu: 20260805120000123456789AbCdEfGh) type: new_api_error headers: {} x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại '401': description: Khóa API bị thiếu hoặc không hợp lệ content: application/json: schema: type: object required: - error properties: error: type: object required: - message - type properties: message: type: string description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu) type: type: string description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error examples: - new_api_error x-apifox-orders: - message - type x-apidog-orders: - message - type refName: NewApiError x-apifox-orders: - error x-apidog-orders: - error examples: example: summary: example value: error: message: >- Mã thông báo không hợp lệ (request id: 20260805120000123456789AbCdEfGh) type: new_api_error headers: {} x-apidog-name: Khóa API bị thiếu hoặc không hợp lệ security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Luma/Các tác vụ truy vấn x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208981-runcomponents: schemas: {} securitySchemes: {}servers: - url: https://api.openaihub.net description: Prod Envsecurity: []