# "OpenAI tạo video (có hình ảnh)" Nguồn: https://docs.openaihub.net/api-45208970/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos: post: summary: OpenAI tạo video (có hình ảnh) deprecated: false description: '' operationId: post-v1-videos tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/Định dạng video OpenAI - hiểu thấu đáo parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: input_reference: type: string description: URL hình ảnh examples: - '' example: '' model: type: string description: Tên mô hình examples: - grok-videos example: grok-videos prompt: type: string description: Lời nhắc examples: - Để chú bò vui vẻ nhảy điệu Khoa Mục Ba example: Để chú bò vui vẻ nhảy điệu Khoa Mục Ba seconds: type: number description: Thời lượng 6s / 10s examples: - 6 example: 6 size: type: string description: 16:9 , 9:16 examples: - '16:9' example: '16:9' required: - model - prompt examples: example: value: input_reference: '' model: grok-videos prompt: Để chú bò vui vẻ nhảy điệu Khoa Mục Ba seconds: 6 size: '16:9' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Veo/Định dạng video OpenAI x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208970-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn OpenAI" Nguồn: https://docs.openaihub.net/api-45208971/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos/{id}: get: summary: Tác vụ truy vấn OpenAI deprecated: false description: >- Truy vấn trạng thái tác vụ Grok Imagine (`GET /v1/videos/{id}`). Dùng chung tuyến vật lý với Sora; phân biệt bằng ID tác vụ / mô hình. Thăm dò các tác vụ được gửi qua `POST /v1/videos/generations` hoặc `POST /v1/videos/edits`. operationId: grok_v1_videos tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/Định dạng video OpenAI - Grok parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: sora-2:task_01k81e7r1mf0qtvp3ett3mr4jm schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: true example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string - name: X-Forwarded-Host in: header description: Host gốc được chuyển tiếp (trường hợp proxy) required: false example: localhost:5173 schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: {} examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: enhanced_prompt: type: string description: Lời nhắc nâng cao id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái video_url: type: string description: URL video refName: GetV1VideosIdResponse x-apifox-orders: - enhanced_prompt - id - status - status_update_time - video_url x-apidog-orders: - enhanced_prompt - id - status - status_update_time - video_url examples: '1': summary: '1' value: '[long payload omitted: 1,869 units]' '2': summary: '2' value: completed_at: 1761622385 created_at: 1761622232 enhanced_prompt: '' id: video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980 model: sora-2 object: video progress: 100 seconds: '10' size: 1280x720 status: completed status_update_time: 1761622385 video_url: >- https://midjourney-plus.oss-us-west-1.aliyuncs.com/sora/cc4fb429-22a5-4747-a6f9-a6badccf8f42.mp4 headers: {} x-apidog-name: '' '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/Veo/Định dạng video OpenAI x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208971-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tải xuống video OpenAI" Nguồn: https://docs.openaihub.net/api-45208972/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos/{id}/content: get: summary: Tải xuống video OpenAI deprecated: false description: >- Chỉ dành cho Sora2 · tải xuống nội dung video đã hoàn tất (`GET /v1/videos/{id}/content`). operationId: sora_v1_videos_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/Định dạng video OpenAI - Sora2 parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: video_099c5197-abfd-4e16-88ff-1e162f2a5c77 schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: true example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string - name: X-Forwarded-Host in: header description: Host gốc được chuyển tiếp (trường hợp proxy) required: false example: localhost:5173 schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: {} examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - status - video_url - enhanced_prompt - status_update_time properties: enhanced_prompt: type: string description: Lời nhắc nâng cao id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái video_url: type: string description: URL video nullable: true refName: GetV1VideosIdContentResponse x-apifox-orders: - enhanced_prompt - id - status - status_update_time - video_url x-apidog-orders: - enhanced_prompt - id - status - status_update_time - video_url examples: example: summary: example value: enhanced_prompt: chuỗi id: string status: string status_update_time: 0 video_url: chuỗi headers: {} x-apidog-name: '' '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/Veo/Định dạng video OpenAI x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208972-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video veo-3.1-generate-preview" Nguồn: https://docs.openaihub.net/api-45208973/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/generations: post: summary: Tạo video veo-3.1-generate-preview deprecated: false description: >- Video hợp nhất VEO · Tạo video bằng Veo 3.1 (`POST /v1/video/generations`); sau khi gửi yêu cầu, hãy thăm dò bằng `GET /v1/video/query`. operationId: veo_video_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/3.1 Định dạng gốc - Video hợp nhất · VEO parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer sk-1dnXVfVZKfyMCxwo9SPuT364kWSVlRO2EUna0Zfa3AmstOrE schema: type: string requestBody: content: application/json: schema: type: object required: - model - prompt properties: image: oneOf: - type: string - type: array items: type: string description: >- Hình ảnh tham chiếu cho chuyển đổi từ hình ảnh sang video (tùy chọn; URL hoặc base64) metadata: type: object properties: aspectRatio: type: string enum: - '16:9' - '9:16' description: |- Tỷ lệ khung hình. Kiểu liệt kê: 16:9 9:16 examples: - '16:9' durationSeconds: type: integer description: Thời lượng video tính bằng giây examples: - 6 generateAudio: type: boolean description: >- Có tạo âm thanh hay không (được một số mô hình Veo hỗ trợ) negativePrompt: type: string description: Lời nhắc phủ định resolution: type: string enum: - 720p - 1080p description: |- Độ phân giải. Kiểu liệt kê: 720p 1080p examples: - 720p description: >- Tham số tạo Veo (được chuyển tiếp tới các tham số thượng nguồn) x-apifox-orders: - aspectRatio - durationSeconds - generateAudio - negativePrompt - resolution x-apidog-orders: - aspectRatio - durationSeconds - generateAudio - negativePrompt - resolution model: type: string enum: - veo-3.1-generate-preview - veo-3.1-fast-generate-preview - veo-3.0-generate-001 - veo-3.0-fast-generate-001 description: |- Tên mô hình. Kiểu liệt kê: veo-3.1-generate-preview veo-3.1-fast-generate-preview veo-3.0-generate-001 veo-3.0-fast-generate-001 examples: - veo-3.1-generate-preview prompt: type: string description: Mô tả nội dung video (bắt buộc) examples: - >- Cảnh cận cảnh hai người đang nhìn chằm chằm vào một hình vẽ bí ẩn trên tường x-apifox-orders: - image - metadata - model - prompt x-apidog-orders: - image - metadata - model - prompt examples: veo_3_1_fast_generate_preview: value: metadata: aspectRatio: '16:9' durationSeconds: 6 model: veo-3.1-fast-generate-preview prompt: >- Cảnh cận cảnh hai người đang nhìn chằm chằm vào một hình vẽ bí ẩn trên tường summary: veo_3_1_fast_generate_preview description: Chuyển văn bản thành video veo-3.1-fast-generate-preview veo_3_1_generate_preview: value: metadata: aspectRatio: '16:9' durationSeconds: 6 model: veo-3.1-generate-preview prompt: >- Cảnh cận cảnh hai người đang nhìn chằm chằm vào một hình vẽ bí ẩn trên tường summary: veo_3_1_generate_preview description: Chuyển văn bản thành video veo-3.1-generate-preview veo_3_1_image2video: value: image: https://example.com/first.jpg metadata: aspectRatio: '16:9' durationSeconds: 6 model: veo-3.1-generate-preview prompt: Tạo chuyển động tự nhiên ngay từ khung hình đầu tiên summary: veo_3_1_image2video description: Chuyển ảnh thành video responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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 security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/3.1 Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208973-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video veo-3.1-fast-generate-preview" Nguồn: https://docs.openaihub.net/api-45208974/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1beta/models/veo-3.1-fast-generate-preview:predictLongRunning: post: summary: Tạo video veo-3.1-fast-generate-preview deprecated: false description: >- Tạo video chạy lâu ở chế độ nhanh bằng Veo 3.1 theo kiểu Gemini (`predictLongRunning`); trả về tên thao tác theo cách bất đồng bộ. operationId: veo_predict_long_running tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/3.1 Định dạng gốc - Video hợp nhất · VEO parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Veo/3.1 Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208974-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Các tác vụ truy vấn" Nguồn: https://docs.openaihub.net/api-45208975/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos/{id}: get: summary: Các tác vụ truy vấn deprecated: false description: >- Truy vấn trạng thái tác vụ Grok Imagine (`GET /v1/videos/{id}`). Dùng chung tuyến vật lý với Sora; phân biệt bằng ID tác vụ / mô hình. Thăm dò các tác vụ được gửi qua `POST /v1/videos/generations` hoặc `POST /v1/videos/edits`. operationId: grok_v1_videos tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/3.1 Định dạng gốc - Grok parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: sora-2:task_01k81e7r1mf0qtvp3ett3mr4jm schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: true example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string - name: X-Forwarded-Host in: header description: Host gốc được chuyển tiếp (trường hợp proxy) required: false example: localhost:5173 schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: {} examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: enhanced_prompt: type: string description: Lời nhắc nâng cao id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái video_url: type: string description: URL video refName: GetV1VideosIdResponse x-apifox-orders: - enhanced_prompt - id - status - status_update_time - video_url x-apidog-orders: - enhanced_prompt - id - status - status_update_time - video_url examples: '1': summary: '1' value: '[long payload omitted: 1,869 units]' '2': summary: '2' value: completed_at: 1761622385 created_at: 1761622232 enhanced_prompt: '' id: video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980 model: sora-2 object: video progress: 100 seconds: '10' size: 1280x720 status: completed status_update_time: 1761622385 video_url: >- https://midjourney-plus.oss-us-west-1.aliyuncs.com/sora/cc4fb429-22a5-4747-a6f9-a6badccf8f42.mp4 headers: {} x-apidog-name: '' '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/Veo/3.1 Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208975-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video (hình ảnh tham chiếu)" Nguồn: https://docs.openaihub.net/api-45208976/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/create: post: summary: Tạo video (hình ảnh tham chiếu) deprecated: false description: >- Omni-Flash · tạo video hợp nhất (`POST /v1/video/create`, tuyến vật lý chuyển tiếp VEO; xem `relay/veo` là tuyến chính). `model=omni-flash` / `omni-flash-edit` định tuyến đến quy trình Omni-Flash; `type` chọn khả năng: - `1` = chuyển văn bản thành video (chỉ yêu cầu `prompt`) - `2` = khung hình đầu/cuối (`images` yêu cầu 1-2 mục) - `3` = hình ảnh tham chiếu (`images` yêu cầu 1-3 mục) - `4` = chỉnh sửa video Omni-Flash (yêu cầu `input_reference`) Trả về `id` (ID tác vụ); thăm dò `GET /v1/video/query?id=` để nhận kết quả. operationId: omni_video_create tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/Định dạng hợp nhất cho video - Omni parameters: - name: Content-Type in: header description: Định dạng dữ liệu phần thân yêu cầu required: false example: application/json schema: type: string - name: Accept in: header description: Định dạng dữ liệu phản hồi mà máy khách dự kiến nhận được required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa xác thực API, định dạng là Bearer + dấu cách + khóa API của bạn required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model - prompt properties: aspect_ratio: type: string enum: - '16:9' - '9:16' description: tỷ lệ khung hình enable_sample: type: boolean description: >- Dòng Omni-Flash chuyển sang 1080p (bỏ qua đối với các mẫu 4K) enable_upsample: type: boolean description: >- Đã nâng cấp lên 1080p (khả dụng trên một số mẫu 4K nhất định) images: type: array items: type: string format: uri description: >- Mảng URL hình ảnh (type=2 yêu cầu 1-2 hình ảnh, type=3 yêu cầu 1-3 hình ảnh) input_reference: type: string description: >- Video tham chieu chinh sua Omni-Flash (canh JSON duoc truyen den URL hoac dataURI) model: type: string description: 'Tên mô hình (ví dụ: omni-flash, omni-flash-edit)' prompt: type: string description: Mô tả nội dung video seconds: type: string description: 'Thời lượng video (giây), ví dụ: "8"' size: type: string description: >- Kích thước tùy chỉnh, tỷ lệ chiều rộng là 16:9 và tỷ lệ chiều cao là 9:16. Khi aspect_ratio có hiệu lực, tham số này không còn giá trị. type: type: integer enum: - 1 - 2 - 3 - 4 description: >- Loại tạo sinh: 1=Video từ văn bản, 2=Khung hình đầu và cuối, 3=Tham chiếu nhiều hình ảnh, 4=Chỉnh sửa video Omni-Flash allOf: - type: string - type: string - type: string - type: string refName: PostV1VideoCreateRequest x-apifox-orders: - aspect_ratio - enable_sample - enable_upsample - images - input_reference - model - prompt - seconds - size - type x-apidog-orders: - aspect_ratio - enable_sample - enable_upsample - images - input_reference - model - prompt - seconds - size - type examples: omni_flash: value: model: omni-flash prompt: xin chào thế giới summary: omni_flash description: >- Khuyến nghị cho người mới bắt đầu: Yêu cầu tối thiểu cho người mới bắt đầu · Kiến thức cơ bản về tạo sinh từ văn bản · mô hình+lời nhắc omni_flash_2: value: aspect_ratio: '16:9' model: omni-flash prompt: Cảnh hoàng hôn bên bờ biển quay từ trên không seconds: '8' summary: omni_flash_2 description: >- Khuyên dùng cho người mới bắt đầu: Màn hình ngang tiêu chuẩn · Vincent Video · model+prompt+aspect_ratio+seconds omni_flash_3: value: aspect_ratio: '9:16' model: omni-flash prompt: Nhân vật đường phố quay chậm seconds: '8' summary: omni_flash_3 description: >- Khuyến nghị cho người mới bắt đầu: tiêu chuẩn màn hình dọc · Vincent Video · model+prompt+aspect_ratio+seconds omni_flash_4: value: images: - >- https://ts1.tc.mm.bing.net/th/id/R-C.8dbf8e136e7d71653b63fdbd4d17fb6c?rik=KEcgD1%2fwKEKc9A&riu=http%3a%2f%2fimg.xintp.com%2f2019%2f12%2f10%2fxl5gp5kgesw.jpg&ehk=j5IVfJ0NDf2S9Ki9dJ7uXRMGlqubf9rR8TGsNLZP%2fMQ%3d&risl=&pid=ImgRaw&r=0 - >- https://ts1.tc.mm.bing.net/th/id/R-C.ef98ae99612a621c19aaf5c02df8590a?rik=bpRpplfXRRo8pA&riu=http%3a%2f%2fimg95.699pic.com%2fphoto%2f50166%2f6903.jpg_wh300.jpg&ehk=yf0pMNdv%2bxIdqiWephK%2fg%2bt9K%2fTLDd8Db46yw8Q%2bSXM%3d&risl=&pid=ImgRaw&r=0 model: omni-flash prompt: Chuyển tiếp mượt mà giữa khung hình đầu và cuối seconds: '8' summary: omni_flash_4 description: >- Khuyên dùng cho người mới bắt đầu: Chuyển tiếp giữa hai hình ảnh · Tạo khung hình đầu và cuối · mô hình+lời nhắc+hình ảnh+số giây omni_flash_5: value: images: - >- https://static.jokers.pub/upload/ai/728c4393-77ee-441a-99fa-ea1c294035a1/Image-91o3qgbn15t9o2k/1779515038884-1742.jpg model: omni-flash prompt: Tạo video giữ nguyên phong cách của chủ thể chính seconds: '8' summary: omni_flash_5 description: >- Khuyến nghị cho người mới bắt đầu: tham chiếu một ảnh · tạo ảnh tham chiếu đệm · mô hình+câu lệnh+ảnh+số giây omni_flash_6: value: aspect_ratio: '9:16' images: - >- https://ts2.tc.mm.bing.net/th/id/OIP-C.iBy7zllJXvjrzOH-VdwH_gHaEK?rs=1&pid=ImgDetMain&o=7&rm=3 - https://imgs.699pic.com/images/600/406/117.jpg!list1x.v2 - >- https://ts2.tc.mm.bing.net/th/id/OIP-C.thJJkD55hZLuc-D86OW7bgHaEW?rs=1&pid=ImgDetMain&o=7&rm=3 model: omni-flash prompt: >- Kết hợp chủ thể và phong cách phối màu của ba hình ảnh tham khảo seconds: '8' summary: omni_flash_6 description: >- Khuyến nghị nâng cao: Kết hợp ba hình ảnh · Tạo hình ảnh tham chiếu Mat · model+prompt+images+aspect_ratio+seconds omni_flash_7: value: model: omni-flash prompt: Video tua nhanh Thành phố Chân trời seconds: '8' type: 1 summary: omni_flash_7 description: >- Khuyến nghị nâng cao: kiểu tường minh Vincent · lệnh gọi tương thích với Vincent · mô hình+lời nhắc+kiểu+số giây omni_flash_edit: value: input_reference: https://example.com/input.mp4 model: omni-flash-edit prompt: Chuyển video gốc sang phong cách điện ảnh type: 4 summary: omni_flash_edit description: >- Khuyến nghị cho người mới bắt đầu: Kiến thức cơ bản về chỉnh sửa URL · Chỉnh sửa video · model+prompt+input_reference+seconds omni_flash_edit_datauri: value: input_reference: >- https://cdn.dealonhorizon.us/video/d2fa3281de7a69f3ac07b3451cf922e3ba609daad00d081674b283a63de67e54.mp4 model: omni-flash-edit prompt: Nâng cao màu sắc và ánh sáng type: 4 summary: omni_flash_edit_datauri description: >- Khuyến nghị nâng cao: Chỉnh sửa DataURI · Chỉnh sửa video · model+prompt+input_reference(dataURI)+seconds responses: '200': description: '' content: application/json: schema: type: object required: - id - status - status_update_time properties: id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái refName: PostV1VideoCreateResponse x-apifox-orders: - id - status - status_update_time x-apidog-orders: - id - status - status_update_time examples: example: summary: example value: id: omni-flash_X:task_uAbDkbRmcOafvSBBmNWwQkIA1gvTdoaX status: queued status_update_time: 1779950697931 headers: {} x-apidog-name: '' '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/Veo/Định dạng hợp nhất cho video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208976-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Các tác vụ truy vấn" Nguồn: https://docs.openaihub.net/api-45208977/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/query: get: summary: Các tác vụ truy vấn deprecated: false description: >- Omni-Flash · truy vấn tác vụ (`GET /v1/video/query`, tuyến vật lý chuyển tiếp VEO; xem `relay/veo` là tuyến chính). Truy vấn trạng thái/kết quả của một tác vụ Omni-Flash được tạo qua `POST /v1/video/create`; khi `status=failed`, `error` cung cấp lý do thất bại. operationId: omni_video_query tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/Định dạng hợp nhất cho video - Omni parameters: - name: id in: query description: ID tài nguyên / tác vụ trong đường dẫn required: false example: omni-flash:1779717386-QYRfzV5zLK schema: type: string - name: model in: query description: Tên mô hình required: false example: omni-flash schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: error: Tạo video thất bại id: omni-flash:1779717386-QYRfzV5zLK status: failed status_update_time: 1779717416 headers: {} x-apidog-name: '' '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/Veo/Định dạng hợp nhất cho video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208977-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Gửi tác vụ tạo video" Nguồn: https://docs.openaihub.net/api-45208978/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /luma/generations: post: summary: Gửi tác vụ tạo video deprecated: false description: >- Video tạo từ văn bản hoặc video tạo từ hình ảnh. Hỗ trợ hai định dạng yêu cầu: - **Định dạng chính thức**: `prompt` + `keyframes` - **Định dạng proxy**: `user_prompt` + `image_url` Tài liệu chính thức: https://docs.lumalabs.ai/docs/video-generation operationId: luma_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Luma/Định dạng API chính thức - Luma parameters: [] requestBody: content: application/json: schema: type: object required: - user_prompt properties: duration: type: string description: Thời lượng chỉ hỗ trợ 5 giây expand_prompt: type: boolean description: Tùy chọn, công tắc tối ưu hóa từ ngữ trong lời nhắc image_end_url: type: string description: Tùy chọn, ảnh khung hình chính mục tiêu image_url: type: string description: Tùy chọn, tham khảo nguồn hình ảnh loop: type: boolean description: Tùy chọn, có tái sử dụng hình ảnh tham chiếu hay không model_name: type: string description: Cách hiển thị chính thức của ray-v1 và ray-v2 là ray1.6 ray2 notify_hook: type: string description: >- Tùy chọn, địa chỉ thông báo callback sau khi quá trình xử lý hoàn tất resolution: type: string description: 720p hoặc 1080p, mặc định là 720p user_prompt: type: string description: Bắt buộc, từ trong lời nhắc/mô tả vấn đề do người dùng nhập refName: LumaSampleRequest x-apifox-orders: - duration - expand_prompt - image_end_url - image_url - loop - model_name - notify_hook - resolution - user_prompt x-apidog-orders: - duration - expand_prompt - image_end_url - image_url - loop - model_name - notify_hook - resolution - user_prompt examples: example_single: value: duration: 5s model_name: ray-v2 resolution: 720p user_prompt: >- Một cơn gió thổi qua khu rừng, khiến tấm mạng che mặt của người phụ nữ khẽ lay động. summary: example_single description: Gửi tác vụ tạo video image2video: value: aspect_ratio: '16:9' image_url: https://example.com/start-frame.jpg user_prompt: Khung cảnh trở nên sống động với làn gió nhẹ summary: image2video description: video từ ảnh text2video: value: aspect_ratio: '16:9' expand_prompt: true user_prompt: >- Một con đại bàng oai vệ bay lượn trên những ngọn núi phủ tuyết vào lúc hoàng hôn summary: text2video description: Video Vincent responses: '200': description: '' content: application/json: schema: 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: '' created_at: '2024-12-22T13:38:40.139Z' id: 4665a07c-7641-4809-a133-10786201bb56 prompt: '' state: đang chờ headers: {} x-apidog-name: '' '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/Định dạng API chính thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208978-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Video mở rộng" Nguồn: https://docs.openaihub.net/api-45208979/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /luma/generations/{id}/extend: post: summary: Video mở rộng deprecated: false description: Kéo dài thời gian tạo dựa trên các video hiện có. operationId: luma_luma_generations_extend tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Luma/Định dạng API chính thức - Luma parameters: - name: id in: path description: ID tác vụ video gốc required: true example: '' schema: type: string requestBody: content: application/json: schema: type: object properties: prompt: type: string description: Mô tả về tiện ích mở rộng (không bắt buộc) user_prompt: type: string description: Mô tả tiện ích mở rộng (định dạng proxy) refName: PostLumaGenerationsIdExtendRequest x-apifox-orders: - prompt - user_prompt x-apidog-orders: - prompt - user_prompt examples: example_single: value: user_prompt: Tiếp tục cảnh đại bàng đáp xuống một vách đá summary: example_single description: mở rộng video responses: '200': description: Tác vụ tiện ích mở rộng đã được tạo thành công content: application/json: schema: 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: Tác vụ tiện ích mở rộng đã được tạo 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/Định dạng API chính thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208979-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn một tác vụ duy nhất" Nguồn: https://docs.openaihub.net/api-45208980/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /luma/generations/{id}: get: summary: Truy vấn một tác vụ duy nhất deprecated: false description: Truy van trang thai va ket qua tao video dua tren ma tac vu. operationId: luma_luma_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Luma/Các tác vụ truy vấn - Luma parameters: - name: id in: path description: ID được trả về khi tạo tác vụ required: true example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 schema: type: string responses: '200': description: thành công content: application/json: schema: 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 '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-45208980-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Lấy nhiều tác vụ theo lô" Nguồn: https://docs.openaihub.net/api-45208981/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /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-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Hình ảnh" Nguồn: https://docs.openaihub.net/api-45208982/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/generations: post: summary: Hình ảnh deprecated: false description: Tạo hình ảnh dựa trên các từ trong lời nhắc bằng văn bản. operationId: kling_images_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling - Kling parameters: [] requestBody: content: application/json: schema: type: object required: - model_name - prompt properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' callback_url: type: string description: URL gọi lại image_fidelity: type: number description: Độ trung thực hình ảnh (cảnh chuyển từ ảnh sang ảnh) model_name: type: string enum: - kling-v1 - kling-v1-5 - kling-v2 - kling-v2-1 description: Phiên bản mô hình hình ảnh examples: - kling-v1-5 'n': type: integer description: Tạo số lượng negative_prompt: type: string description: từ gợi ý phủ định prompt: type: string description: Các từ dùng trong câu lệnh mô tả hình ảnh resolution: type: string enum: - 1k - 2k description: Độ phân giải đầu ra refName: PostKlingV1ImagesGenerationsRequest x-apifox-orders: - aspect_ratio - callback_url - image_fidelity - model_name - 'n' - negative_prompt - prompt - resolution x-apidog-orders: - aspect_ratio - callback_url - image_fidelity - model_name - 'n' - negative_prompt - prompt - resolution examples: example_single: value: aspect_ratio: '1:1' model_name: kling-v1-5 'n': 1 prompt: >- Một chú mèo mướp cam đáng yêu đang ngồi trên bậu cửa sổ, theo phong cách màu nước resolution: 1k summary: example_single description: Hình ảnh Vinh Sơn responses: '200': description: Tác vụ đã được gửi thành công content: application/json: schema: type: object properties: code: type: integer description: Mã trạng thái nghiệp vụ examples: - 0 data: type: object properties: created_at: type: integer description: Thời điểm tạo (mili giây) task_id: type: string description: ID tác vụ, được dùng để kiểm tra định kỳ task_status: type: string enum: - submitted - processing - succeed - failed description: Trạng thái tác vụ updated_at: type: integer description: Cập nhật dấu thời gian (mili giây) description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) x-apifox-orders: - created_at - task_id - task_status - updated_at x-apidog-orders: - created_at - task_id - task_status - updated_at message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. examples: - thành công request_id: type: string description: ID truy vết yêu cầu refName: KlingTaskSubmitResponse x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: created_at: 0 task_id: chuỗi task_status: đã gửi updated_at: 0 message: thành công request_id: chuỗi headers: {} x-apidog-name: Tác vụ đã được gửi 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/Kling x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208982-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "văn bản thành video" Nguồn: https://docs.openaihub.net/api-45208983/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/text2video: post: summary: văn bản thành video deprecated: false description: >- Tạo video dựa trên các từ trong lời nhắc văn bản. Có thể sử dụng phần thân yêu cầu camelCase gốc; `task_id` được trả về sau khi gửi và cần thăm dò trạng thái tác vụ. operationId: kling_text2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling - Kling parameters: [] requestBody: content: application/json: schema: type: object required: - model_name - duration properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' enumDetails: - value: '16:9' displayName: Toàn cảnh description: Bố cục ngang màn hình rộng - value: '9:16' displayName: Chân dung description: Bố cục chân dung video ngắn - value: '1:1' displayName: Hình vuông description: Bố cục hình vuông description: >- Tỷ lệ khung hình (chiều rộng:chiều cao). Các ràng buộc từ hệ thống nguồn: thường dùng 16:9 / 9:16 / 1:1, cổng kết nối không liệt kê trước để kiểm tra. callback_url: type: string format: uri description: >- Địa chỉ gọi lại khi tác vụ hoàn tất. Gửi thông báo bằng phương thức POST sau khi tác vụ thượng nguồn hoàn tất; địa chỉ này phải có thể truy cập được qua mạng công cộng, và cổng kết nối chuyển tiếp nguyên trạng thông tin. camera_control: type: object properties: config: type: object properties: horizontal: type: number description: Chuyển vị ngang pan: type: number description: Di chuyển ngang (sang trái và sang phải) roll: type: number description: xoay tilt: type: number description: Di chuyển dọc (lên và xuống) vertical: type: number description: độ dịch chuyển theo phương thẳng đứng zoom: type: number description: thu phóng description: Cấu hình tham số chuyển động của ống kính x-apifox-orders: - horizontal - pan - roll - tilt - vertical - zoom x-apidog-orders: - horizontal - pan - roll - tilt - vertical - zoom type: type: string description: Loại điều khiển, chẳng hạn như đơn giản description: >- Điều khiển chuyển động của ống kính. Nếu tham số này không được truyền, mô hình sẽ tự động lựa chọn giá trị phù hợp; cổng trung gian sẽ truyền nguyên trạng và không kiểm tra trước phạm vi giá trị cụ thể. x-apifox-orders: - config - type x-apidog-orders: - config - type cfg_scale: type: number description: >- Mức độ tự do khi tạo (CFG). Giá trị càng lớn thì mức độ tương quan giữa kết quả được tạo và câu lệnh càng cao; cổng kết nối không kiểm tra trước phạm vi giá trị, còn các giới hạn của dịch vụ nguồn thường là 0~1. duration: oneOf: - type: string - type: integer description: >- Thời lượng video (giây), bắt buộc. Không phải kling-v3: chỉ 5 hoặc 10; kling-v3: 3~15. Hỗ trợ chuỗi hoặc số nguyên, cổng kết nối chuẩn hóa thành chuỗi. external_task_id: type: string description: >- ID tác vụ bên ngoài của bên gọi, được dùng để liên kết theo cách bảo đảm tính lũy đẳng và đối soát nghiệp vụ; trường `data.task_id` không nằm trong nội dung phản hồi. mode: type: string enum: - std - pro - 4k enumDetails: - value: std displayName: Tiêu chuẩn description: Chế độ tiết kiệm chi phí - value: chuyên nghiệp displayName: Chất lượng cao description: Chế độ hiệu năng cao - value: 4k displayName: 4K description: Chỉ được hỗ trợ trên kling-v3 description: >- Tạo lược đồ. Phía thanh toán mặc định là std khi không được truyền. 4k chỉ dành cho kling-v3; kling-v2-6 yêu cầu pro để bật âm thanh. model_name: type: string enum: - kling-v1 - kling-v1-6 - kling-v2-master - kling-v2-1-master - kling-v2-5-turbo - kling-v2-6 - kling-v3 enumDetails: - value: kling-v1 displayName: V1 description: Mô hình cổ điển; thời lượng chỉ là 5/10 giây - value: kling-v1-6 displayName: V1.6 description: V1.6 được cải tiến; thời lượng chỉ là 5/10 giây - value: kling-v2-master displayName: Bản chính V2 description: Bản chính; thời lượng chỉ là 5/10 giây - value: kling-v2-1-master displayName: Bản chính V2.1 description: Bản chính V2.1; thời lượng chỉ là 5/10 giây - value: kling-v2-5-turbo displayName: V2.5 Turbo description: Hạng Turbo; thời lượng chỉ 5/10 giây - value: kling-v2-6 displayName: V2.6 description: >- Hỗ trợ âm thanh (yêu cầu mode=pro + sound=on); thời lượng chỉ là 5/10 giây - value: kling-v3 displayName: V3 description: Hỗ trợ sound/4k/multi_shot; thời lượng 3–15s description: >- Tên mô hình. Khi không được truyền, hệ thống tính toán mức sử dụng của cổng mặc định là kling-v1, và nên điền rõ giá trị này. Giá trị phải là kling-v3 khi multi_shot=true; giá trị phải là kling-v3 khi mode=4k. multi_prompt: type: array items: type: object required: - index - prompt - duration properties: duration: oneOf: - type: string - type: number - type: integer description: Thời lượng của bảng phân cảnh (giây), ≥1 index: type: integer description: Số thứ tự bảng phân cảnh, bắt đầu từ 1 prompt: type: string description: >- Từ ngữ lời nhắc tích cực của bảng phân cảnh, ≤512 ký tự x-apifox-orders: - duration - index - prompt x-apidog-orders: - duration - index - prompt description: >- Danh sách bảng phân cảnh tùy chỉnh. Bắt buộc khi shot_type=customize, tối đa 6 cảnh quay. Mỗi prompt của mirror ≤512, duration ≥1; tổng duration của từng mirror phải bằng duration cấp cao nhất (sai số ≤0.1). multi_shot: type: boolean description: >- Có nhiều góc máy hay không. Khi là true, chỉ kling-v3 hỗ trợ tính năng này và prompt không hợp lệ; khi là false, không thể truyền shot_type / multi_prompt. negative_prompt: type: string description: >- Các từ gợi ý phủ định. Mô tả nội dung không mong muốn và truyền nội dung đó một cách minh bạch qua cổng. prompt: type: string description: >- Các từ gợi ý tích cực. Bắt buộc khi multi_shot=false (mặc định); không hợp lệ khi multi_shot=true, phản hồi 400 sẽ được gửi. Giới hạn từ nguồn cấp trên ≤2500 ký tự. shot_type: type: string enum: - customize - intelligence enumDetails: - value: tùy chỉnh displayName: Ảnh chụp tùy chỉnh description: >- Yêu cầu multi_prompt; tổng thời lượng của các cảnh phải bằng thời lượng cấp cao nhất - value: trí tuệ displayName: Ảnh chụp tự động description: '`multi_prompt` không bắt buộc' description: >- Phương thức lập bảng phân cảnh. Bắt buộc khi multi_shot=true; không thể được truyền khi multi_shot=false. customize phải được sử dụng cùng với multi_prompt; intelligence sẽ tự động bị loại bỏ khỏi hệ thống nguồn. sound: type: string enum: - 'on' - 'off' enumDetails: - value: bật displayName: Bật âm thanh description: Chỉ v2-6 / v3; v2-6 yêu cầu mode=pro - value: tắt displayName: Lên tiếng description: Mặc định không hiển thị thông báo description: >- Công tắc âm thanh. Cổng chỉ thực hiện xác minh mô hình/lược đồ đối với các giá trị khác null; kích hoạt tính phí âm thanh khi truyền on. Chỉ được hỗ trợ bởi kling-v2-6 / kling-v3; v2-6 yêu cầu mode=pro. voice_list: type: array items: type: object required: - voice_id properties: voice_id: type: string description: ID bản vá tùy chỉnh, từ giao diện tạo bản vá x-apifox-orders: - voice_id x-apidog-orders: - voice_id description: >- Danh sách âm thanh tùy chỉnh. Trường này có thể được truyền trong suốt; quy trình tính phí text2video hiện tại không nhận diện riêng voice_list (không giống image2video, trường này không ảnh hưởng đến hệ số hasVoiceId). refName: PostKlingV1VideosText2videoRequest x-apifox-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list x-apidog-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list examples: '1': value: aspect_ratio: '16:9' duration: '5' mode: std model_name: kling-v1 prompt: >- Cảnh quay từ thiết bị bay không người lái về một đường bờ biển tuyệt đẹp vào lúc hoàng hôn vàng rực summary: '1' description: >- Khuyến nghị cho người mới: Vincent Video · Lộ trình gửi bài tối thiểu khả dụng '2': value: aspect_ratio: '16:9' duration: '10' mode: chuyên nghiệp model_name: kling-v2-master prompt: >- Cảnh quay điện ảnh tiến máy dolly vào trên mặt hồ miền núi phủ sương lúc bình minh, ánh sáng viền dịu nhẹ summary: '2' description: >- Đề xuất cho người mới bắt đầu: Vincent Video · V2 Master chất lượng cao 10 giây '3': value: aspect_ratio: '16:9' duration: '5' mode: chuyên nghiệp model_name: kling-v2-6 prompt: >- Một nhạc công đường phố chơi đàn vĩ cầm tại một góc phố trong thành phố dưới trời mưa, với âm thanh đám đông xung quanh sound: bật summary: '3' description: >- Đề xuất cho người mới bắt đầu: Vincent Video · Âm thanh chuyên nghiệp V2.6 '4': value: aspect_ratio: '16:9' duration: 8 mode: chuyên nghiệp model_name: kling-v3 prompt: >- Cảnh quay từ từ tiến gần vào một thám tử đang đọc hồ sơ vụ án dưới ánh đèn bàn summary: '4' description: >- Khuyến nghị cho người mới bắt đầu: Vincent Video · V3 8 giây mỗi giây '5': value: aspect_ratio: '16:9' cfg_scale: 0.7 duration: '5' mode: std model_name: kling-v1-6 negative_prompt: mờ, chất lượng thấp, hình mờ, chữ phủ lên prompt: >- Một chú ngựa trắng phi nước đại dọc bãi biển lúc bình minh, hiệu ứng nhòe chuyển động điện ảnh summary: '5' description: >- Khuyến nghị nâng cao: Vincent Video · Từ khóa phủ định và cfg_scale '6': value: aspect_ratio: '9:16' callback_url: https://example.com/callback duration: 6 external_task_id: '{{external_task_id}}' mode: 4k model_name: kling-v3 prompt: >- Chân dung cyberpunk dưới mưa neon, máy quay từ từ xoay quanh chủ thể summary: '6' description: >- Đề xuất nâng cao: Vincent Video · Lệnh gọi lại màn hình dọc 4K V3 '7': value: aspect_ratio: '16:9' duration: '6' mode: chuyên nghiệp model_name: kling-v3 multi_prompt: - duration: '2' index: 1 prompt: >- Cảnh toàn rộng mở đầu về đường chân trời của một thành phố tương lai lúc chạng vạng - duration: '2' index: 2 prompt: >- Cảnh quay trung, một người giao hàng chạy qua những con phố đông đúc với các biển hiệu neon - duration: '2' index: 3 prompt: >- Cận cảnh khuôn mặt đầy quyết tâm của người giao hàng, những giọt mưa đọng trên da multi_shot: true shot_type: tùy chỉnh summary: '7' description: 'Đề xuất nâng cao: Vincent Video · Tùy chỉnh đa ống kính V3' '8': value: aspect_ratio: '16:9' duration: '10' mode: chuyên nghiệp model_name: kling-v3 multi_shot: true prompt: >- Hành trình tua nhanh thời gian qua bốn mùa tại cùng một khoảng rừng trống shot_type: trí tuệ summary: '8' description: 'Đề xuất nâng cao: Vincent Video · Trí tuệ đa ống kính V3' '9': value: aspect_ratio: '16:9' camera_control: config: horizontal: 0 pan: 0 roll: 0 tilt: -2.5 vertical: 0 zoom: 1.5 type: simple duration: '5' mode: chuyên nghiệp model_name: kling-v2-5-turbo prompt: >- Chuyển động bay về phía trước như flycam trên một thung lũng núi sâu phủ sương mù buổi sáng summary: '9' description: >- Đề xuất nâng cao: Vincent Video · Điều khiển ống kính camera_control example_single: value: aspect_ratio: '16:9' duration: 5 mode: std model_name: kling-v1-6 prompt: Một con mèo đang chạy trên đồng cỏ, trời nắng đẹp. summary: example_single description: Video Vincent responses: '200': description: Tác vụ đã được gửi thành công content: application/json: schema: type: object properties: code: type: integer description: Mã trạng thái nghiệp vụ examples: - 0 data: type: object properties: created_at: type: integer description: Thời điểm tạo (mili giây) task_id: type: string description: ID tác vụ, được dùng để kiểm tra định kỳ task_status: type: string enum: - submitted - processing - succeed - failed description: Trạng thái tác vụ updated_at: type: integer description: Cập nhật dấu thời gian (mili giây) description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) x-apifox-orders: - created_at - task_id - task_status - updated_at x-apidog-orders: - created_at - task_id - task_status - updated_at message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. examples: - thành công request_id: type: string description: ID truy vết yêu cầu refName: KlingTaskSubmitResponse x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: created_at: 0 task_id: chuỗi task_status: đã gửi updated_at: 0 message: thành công request_id: chuỗi headers: {} x-apidog-name: Tác vụ đã được gửi 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/Kling x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208983-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "ảnh-thành-video" Nguồn: https://docs.openaihub.net/api-45208984/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/image2video: post: summary: ảnh-thành-video deprecated: false description: Tạo video bằng cách sử dụng hình ảnh đầu vào làm khung hình bắt đầu. operationId: kling_image2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling - Kling parameters: [] requestBody: content: application/json: schema: type: object required: - model_name - image - duration properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' enumDetails: - value: '16:9' displayName: Toàn cảnh description: Bố cục ngang màn hình rộng - value: '9:16' displayName: Chân dung description: Bố cục chân dung video ngắn - value: '1:1' displayName: Hình vuông description: Bố cục hình vuông description: >- Tỷ lệ khung hình (chiều rộng:chiều cao). Các ràng buộc từ hệ thống nguồn: thường dùng 16:9 / 9:16 / 1:1, cổng kết nối không liệt kê trước để kiểm tra. callback_url: type: string format: uri description: >- Địa chỉ gọi lại khi tác vụ hoàn tất. Gửi thông báo bằng phương thức POST sau khi tác vụ thượng nguồn hoàn tất; địa chỉ này phải có thể truy cập được qua mạng công cộng, và cổng kết nối chuyển tiếp nguyên trạng thông tin. camera_control: type: object properties: config: type: object properties: horizontal: type: number description: Chuyển vị ngang pan: type: number description: Di chuyển ngang (sang trái và sang phải) roll: type: number description: xoay tilt: type: number description: Di chuyển dọc (lên và xuống) vertical: type: number description: độ dịch chuyển theo phương thẳng đứng zoom: type: number description: thu phóng description: Cấu hình tham số chuyển động của ống kính x-apifox-orders: - horizontal - pan - roll - tilt - vertical - zoom x-apidog-orders: - horizontal - pan - roll - tilt - vertical - zoom type: type: string description: Loại điều khiển, chẳng hạn như đơn giản description: >- Điều khiển chuyển động của ống kính. Nếu tham số này không được truyền, mô hình sẽ tự động lựa chọn giá trị phù hợp; cổng trung gian sẽ truyền nguyên trạng và không kiểm tra trước phạm vi giá trị cụ thể. x-apifox-orders: - config - type x-apidog-orders: - config - type cfg_scale: type: number description: >- Mức độ tự do khi tạo (CFG). Giá trị càng lớn thì mức độ tương quan giữa kết quả được tạo và câu lệnh càng cao; cổng kết nối không kiểm tra trước phạm vi giá trị, còn các giới hạn của dịch vụ nguồn thường là 0~1. duration: oneOf: - type: string - type: integer description: >- Thời lượng video (giây), bắt buộc. Không phải kling-v3: chỉ 5 hoặc 10; kling-v3: 3~15. Hỗ trợ chuỗi hoặc số nguyên, cổng kết nối chuẩn hóa thành chuỗi. external_task_id: type: string description: >- ID tác vụ bên ngoài của bên gọi, được dùng để liên kết theo cách bảo đảm tính lũy đẳng và đối soát nghiệp vụ; trường `data.task_id` không nằm trong nội dung phản hồi. image: type: string description: >- Nhập URL hình ảnh hoặc Base64, bắt buộc. Được dùng làm tham chiếu cho khung hình đầu tiên của video; đây là trường cốt lõi của video tạo từ ảnh. Định dạng/kích thước/độ phân giải được xác minh bởi dịch vụ thượng nguồn, cổng chỉ xác minh rằng trường này không để trống. image_tail: type: string description: >- URL hoặc Base64 của hình ảnh khung hình kết thúc, không bắt buộc. Kết hợp với hình ảnh để thực hiện quá trình chuyển tiếp giữa khung hình đầu tiên và khung hình cuối cùng; nếu không được truyền vào, nội dung sẽ chỉ được tạo từ khung hình đầu tiên. Cổng truyền dữ liệu một cách minh bạch và không kiểm tra trước định dạng. mode: type: string enum: - std - pro - 4k enumDetails: - value: std displayName: Tiêu chuẩn description: Chế độ tiết kiệm chi phí - value: chuyên nghiệp displayName: Chất lượng cao description: Chế độ hiệu năng cao - value: 4k displayName: 4K description: Chỉ được hỗ trợ trên kling-v3 description: >- Tạo lược đồ. Phía thanh toán mặc định là std khi không được truyền. 4k chỉ dành cho kling-v3; kling-v2-6 yêu cầu pro để bật âm thanh. model_name: type: string enum: - kling-v1 - kling-v1-5 - kling-v1-6 - kling-v2-master - kling-v2-1 - kling-v2-1-master - kling-v2-5-turbo - kling-v2-6 - kling-v3 enumDetails: - value: kling-v1 displayName: V1 description: >- Chuyển hình ảnh thành video kiểu cổ điển; thời lượng chỉ 5/10 giây - value: kling-v1-5 displayName: V1.5 description: >- Mô hình chuyên biệt chuyển ảnh thành video; thời lượng chỉ 5/10 giây - value: kling-v1-6 displayName: V1.6 description: >- V1.6 tăng cường chuyển đổi hình ảnh thành video; thời lượng chỉ là 5/10 giây - value: kling-v2-master displayName: Bản chính V2 description: >- Làm chủ việc tạo video từ hình ảnh; thời lượng chỉ 5/10 giây - value: kling-v2-1 displayName: V2.1 description: >- Mô hình chuyên biệt chuyển ảnh thành video; thời lượng chỉ 5/10 giây - value: kling-v2-1-master displayName: Bản chính V2.1 description: >- V2.1 Làm chủ chuyển đổi hình ảnh thành video; thời lượng chỉ là 5/10 giây - value: kling-v2-5-turbo displayName: V2.5 Turbo description: Chuyển ảnh thành video Turbo; thời lượng chỉ 5/10 giây - value: kling-v2-6 displayName: V2.6 description: >- Hỗ trợ âm thanh (yêu cầu mode=pro + sound=on); thời lượng chỉ là 5/10 giây - value: kling-v3 displayName: V3 description: Hỗ trợ sound/4k/multi_shot; thời lượng 3–15s description: >- Tên mô hình. Khi không được truyền, việc tính toán mức sử dụng của cổng mặc định dùng kling-v1, và bạn nên điền rõ giá trị này. Đối với text2video, nên ưu tiên kling-v1-5 / kling-v2-1 hơn. Phải dùng kling-v3 khi multi_shot=true; phải dùng kling-v3 khi mode=4k. multi_prompt: type: array items: type: object required: - index - prompt - duration properties: duration: oneOf: - type: string - type: number - type: integer description: Thời lượng của bảng phân cảnh (giây), ≥1 index: type: integer description: Số thứ tự bảng phân cảnh, bắt đầu từ 1 prompt: type: string description: >- Từ ngữ lời nhắc tích cực của bảng phân cảnh, ≤512 ký tự x-apifox-orders: - duration - index - prompt x-apidog-orders: - duration - index - prompt description: >- Danh sách bảng phân cảnh tùy chỉnh. Bắt buộc khi shot_type=customize, tối đa 6 cảnh quay. Mỗi prompt của mirror ≤512, duration ≥1; tổng duration của từng mirror phải bằng duration cấp cao nhất (sai số ≤0.1). multi_shot: type: boolean description: >- Có nhiều ống kính hay không. Khi là `true`, chỉ `kling-v3` hỗ trợ tùy chọn này và `prompt` không hợp lệ; khi là `false`, không thể truyền `shot_type` / `multi_prompt`, và sẽ xảy ra lỗi 400 nếu các tham số này được truyền. negative_prompt: type: string description: >- Từ gợi ý phủ định. Mô tả nội dung không mong muốn (chẳng hạn như hình ảnh bị nhòe, chất lượng hình ảnh thấp, biến dạng, v.v.), và cổng kết nối sẽ truyền nguyên trạng nội dung đó. prompt: type: string description: >- Các từ gợi ý tích cực. Bắt buộc khi multi_shot=false (mặc định); không hợp lệ khi multi_shot=true, mã 400 sẽ được gửi. Mô tả chuyển động, cảnh quay và phong cách, giới hạn từ dịch vụ thượng nguồn là ≤2500 ký tự. shot_type: type: string enum: - customize - intelligence enumDetails: - value: tùy chỉnh displayName: Ảnh chụp tùy chỉnh description: >- Yêu cầu multi_prompt; tổng thời lượng của các cảnh phải bằng thời lượng cấp cao nhất - value: trí tuệ displayName: Ảnh chụp tự động description: >- `multi_prompt` không bắt buộc; mô hình tự động thực hiện shots description: >- Phương thức lập bảng phân cảnh. Bắt buộc khi multi_shot=true; không thể được truyền khi multi_shot=false. customize phải được sử dụng cùng với multi_prompt; intelligence sẽ tự động bị loại bỏ khỏi hệ thống nguồn. sound: type: string enum: - 'on' - 'off' enumDetails: - value: bật displayName: Bật âm thanh description: >- Chỉ hỗ trợ v2-6 / v3; v2-6 yêu cầu mode=pro; voice_list có thể ảnh hưởng đến hệ số tính phí - value: tắt displayName: Lên tiếng description: Mặc định không hiển thị thông báo description: >- Công tắc âm thanh. Cổng chỉ thực hiện xác minh mô hình/lược đồ đối với các giá trị khác null; kích hoạt tính phí âm thanh khi truyền on. Chỉ được hỗ trợ bởi kling-v2-6 / kling-v3; v2-6 yêu cầu mode=pro. voice_list: type: array items: type: object required: - voice_id properties: voice_id: type: string description: ID bản vá tùy chỉnh, từ giao diện tạo bản vá x-apifox-orders: - voice_id x-apidog-orders: - voice_id description: >- Danh sách âm thanh tùy chỉnh. Tham gia vào hệ số nhân thanh toán (hasVoiceId) khi sound=on và không rỗng; chỉ nhận diện đường dẫn image2video, không bao gồm text2video. Yêu cầu khả năng âm thanh của kling-v2-6 / kling-v3. refName: PostKlingV1VideosImage2videoRequest x-apifox-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - image - image_tail - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list x-apidog-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - image - image_tail - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list examples: '1': value: duration: '5' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-6 prompt: Một chú gấu trúc uống cà phê trong một quán cà phê ấm cúng. summary: '1' description: >- Khuyến nghị cho người mới bắt đầu: Tusheng Video · Quy trình gửi tối thiểu khả dụng '2': value: duration: '5' image: '{{image_url}}' mode: std model_name: kling-v1 prompt: Một con mèo từ từ quay đầu về phía máy quay summary: '2' description: >- Khuyên dùng cho người mới bắt đầu: Video tạo từ hình ảnh · V1 tiêu chuẩn 5 giây '3': value: aspect_ratio: '16:9' duration: '10' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-master prompt: >- Cú máy dolly tiến mang phong cách điện ảnh, ánh sáng viền dịu summary: '3' description: >- Khuyên dùng cho người mới bắt đầu: Ảnh sang video · V2 Master chất lượng cao 10 giây '4': value: duration: '5' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-6 prompt: >- Một nghệ sĩ đường phố chơi đàn violin, âm thanh náo nhiệt của đám đông sound: bật summary: '4' description: >- Khuyên dùng cho người mới bắt đầu: Video Tusheng · âm thanh chuyên nghiệp V2.6 '5': value: duration: 8 image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v3 prompt: Cảnh quay tiến chậm vào chủ thể với ánh sáng kịch tính summary: '5' description: >- Khuyên dùng cho người mới bắt đầu: Video từ ảnh · V3 8 giây mỗi giây '6': value: aspect_ratio: '16:9' cfg_scale: 0.7 duration: '5' image: '{{image_url}}' mode: std model_name: kling-v1-6 negative_prompt: mờ, chất lượng thấp, hình mờ prompt: Một con ngựa trắng đang chạy trên bãi biển lúc bình minh summary: '6' description: >- Khuyến nghị nâng cao: Video tạo từ hình ảnh · Từ khóa phủ định và cfg_scale '7': value: duration: '10' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-6 prompt: >- Một người dẫn chương trình thời sự nói trước máy quay trong trường quay sound: bật voice_list: - voice_id: '{{voice_id}}' summary: '7' description: >- Đề xuất nâng cao: Video tạo từ ảnh · Âm sắc được chỉ định cho âm thanh V2.6 '8': value: aspect_ratio: '9:16' callback_url: https://example.com/callback duration: 6 external_task_id: '{{external_task_id}}' image: '{{image_url}}' mode: 4k model_name: kling-v3 prompt: Chân dung cyberpunk, phản chiếu dưới mưa, độ tương phản cao summary: '8' description: >- Đề xuất nâng cao: Video Tusheng · Lệnh gọi lại màn hình dọc 4K V3 '9': value: duration: 6 image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v3 multi_prompt: - duration: '2' index: 1 prompt: Cảnh toàn cảnh đường chân trời thành phố lúc chạng vạng - duration: '2' index: 2 prompt: Trung cảnh, nhân vật bước vào khung hình - duration: '2' index: 3 prompt: Cận cảnh khuôn mặt, nụ cười nhẹ multi_shot: true shot_type: tùy chỉnh summary: '9' description: >- Đề xuất nâng cao: Video tạo từ hình ảnh · Tùy chỉnh đa ống kính V3 '10': value: camera_control: config: horizontal: 0 pan: 0 roll: 0 tilt: -2.5 vertical: 0 zoom: 1.5 type: simple duration: '5' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-5-turbo prompt: >- Chuyển động tiến về phía trước như thiết bị bay không người lái trên thung lũng núi summary: '10' description: >- Đề xuất nâng cao: Video tạo từ ảnh · Điều khiển ống kính camera_control example_single: value: duration: 5 image: https://example.com/start-frame.jpg mode: std model_name: kling-v1-6 prompt: Máy quay từ từ tiến lại gần, nhân vật mỉm cười summary: example_single description: video từ ảnh responses: '200': description: Tác vụ đã được gửi thành công content: application/json: schema: type: object properties: code: type: integer description: Mã trạng thái nghiệp vụ examples: - 0 data: type: object properties: created_at: type: integer description: Thời điểm tạo (mili giây) task_id: type: string description: ID tác vụ, được dùng để kiểm tra định kỳ task_status: type: string enum: - submitted - processing - succeed - failed description: Trạng thái tác vụ updated_at: type: integer description: Cập nhật dấu thời gian (mili giây) description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) x-apifox-orders: - created_at - task_id - task_status - updated_at x-apidog-orders: - created_at - task_id - task_status - updated_at message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. examples: - thành công request_id: type: string description: ID truy vết yêu cầu refName: KlingTaskSubmitResponse x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: created_at: 0 task_id: chuỗi task_status: đã gửi updated_at: 0 message: thành công request_id: chuỗi headers: {} x-apidog-name: Tác vụ đã được gửi 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/Kling x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208984-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "đồng bộ chuyển động môi" Nguồn: https://docs.openaihub.net/api-45208985/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/lip-sync: post: summary: đồng bộ chuyển động môi deprecated: false description: >- 1. Tạo video 2. Giao diện này yêu cầu ID video hoặc URL video ID video cần được sử dụng trên tài khoản tác vụ cha. Vui lòng thực hiện sớm nhất có thể để tránh gói tài nguyên hết hạn. Tài liệu chính thức: https://app.klingai.com/cn/dev/document-api/apiReference/model/videoTolip Hệ thống cung cấp nhiều âm sắc để lựa chọn, cùng với hiệu ứng âm sắc, ID âm sắc và ngôn ngữ tương ứng cụ thể [nhấp vào đây để xem](https://docs.qingque.cn/s/home/eZQDvafJ4vXQkP8T9ZPvmye8S?identityId=2E1MlYrrPk4) operationId: post-kling-v1-videos-lip-sync tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: true example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: true example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - input properties: input: type: object required: - mode - text - voice_id - voice_language - video_id - video_url properties: mode: type: string enum: - std - pro enumDetails: - value: std displayName: chế độ tiêu chuẩn description: chế độ cơ bản, hiệu quả chi phí tốt hơn - value: chuyên nghiệp displayName: chế độ chuyên gia description: chế độ hiệu suất cao, chất lượng video tốt hơn description: chế độ tạo video text: type: string description: kịch bản cho âm thanh tổng hợp video_id: type: string description: ID của video được tạo bởi Kling AI video_url: type: string description: >- URL của video đã tải lên, loại trừ lẫn nhau với input.video_id; phải thiết lập chính xác một trong hai voice_id: type: string description: ID giọng nói voice_language: type: string enum: - zh - en enumDetails: - value: zh - value: en description: ngôn ngữ giọng nói, tương ứng với mã định danh giọng nói description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - mode - text - video_id - video_url - voice_id - voice_language x-apidog-orders: - mode - text - video_id - video_url - voice_id - voice_language x-apifox-orders: - input x-apidog-orders: - input examples: example: value: input: mode: std text: >- Hôm nay thời tiết rất đẹp Hôm nay thời tiết rất đẹp Hôm nay thời tiết rất đẹp Hôm nay thời tiết rất đẹp Hôm nay thời tiết rất đẹp Hôm nay thời tiết rất đẹp Hôm nay thời tiết rất đẹp Hôm nay thời tiết rất đẹp Hôm nay thời tiết rất đẹp Hôm nay thời tiết rất đẹp Hôm nay thời tiết rất đẹp video_id: '827964097668337738' video_url: https://example.com/sample.mp4 voice_id: girlfriend_1_speech02 voice_language: zh summary: example responses: '200': description: '' content: application/json: schema: type: object required: - code - message - request_id - data properties: code: type: integer description: Mã trạng thái nghiệp vụ data: type: object required: - task_id - task_status - task_info - created_at - updated_at properties: created_at: type: integer description: Thời gian tạo task_id: type: string description: ID tác vụ bất đồng bộ task_info: type: object description: Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. x-apidog-orders: [] task_status: type: string description: Trạng thái tác vụ updated_at: type: integer description: Thời gian cập nhật description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) x-apifox-orders: - created_at - task_id - task_info - task_status - updated_at x-apidog-orders: - created_at - task_id - task_info - task_status - updated_at message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. request_id: type: string description: ID truy vết yêu cầu x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: created_at: 1762832498885 task_id: '817067112967086149' task_info: {} task_status: đã gửi updated_at: 1762832498885 message: THÀNH CÔNG request_id: 38905f60-e76c-4f77-adb3-867a5b67d41e headers: {} x-apidog-name: '' '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/Kling x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208985-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Thử đồ ảo" Nguồn: https://docs.openaihub.net/api-45208986/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/kolors-virtual-try-on: post: summary: Thử đồ ảo deprecated: false description: '' operationId: post-kling-v1-images-kolors-virtual-try-on tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - human_image - cloth_image - model_name properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất cloth_image: type: string description: hình ảnh trang phục dùng để thử đồ ảo human_image: type: string description: >- ảnh người đã tải lên;chấp nhận ảnh Base64 hoặc URL ảnh có thể truy cập;định dạng ảnh được hỗ trợ.jpg / .jpeg / .png;kích thước tệp ảnh không được vượt quá10MB, chiều rộng/chiều cao ảnh phải ít nhất300px model_name: type: string description: >- Liệt kê tên mô hình: kolors-virtual-try-on-v1, kolors-virtual-try-on-v1-5 x-apifox-orders: - callback_url - cloth_image - human_image - model_name x-apidog-orders: - callback_url - cloth_image - human_image - model_name examples: example: value: callback_url: '' cloth_image: >- Vui lòng tải ảnh trực tiếp lên cuộc trò chuyện để tôi có thể đọc và dịch tài liệu, đồng thời giữ nguyên Markdown, mã, định danh, URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON và định dạng. human_image: >- https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg model_name: kolors-virtual-try-on-v1 summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208986-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "phần mở rộng video" Nguồn: https://docs.openaihub.net/api-45208987/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/video-extend: post: summary: phần mở rộng video deprecated: false description: '' operationId: post-kling-v1-videos-video-extend tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - video_id - prompt properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất cfg_scale: type: number description: >- Phạm vi độ mạnh tham chiếu của lời nhắc [0,1]; giá trị càng cao = càng mạnh negative_prompt: type: string description: lời nhắc văn bản phủ định prompt: type: string description: Lời nhắc văn bản tích cực có tối đa 2500 ký tự video_id: type: string description: >- ID video để kéo dài (văn bản/hình ảnh/video); video gốc ≤ 3 phút x-apifox-orders: - callback_url - cfg_scale - negative_prompt - prompt - video_id x-apidog-orders: - callback_url - cfg_scale - negative_prompt - prompt - video_id examples: example: value: callback_url: '' cfg_scale: 0.5 negative_prompt: '' prompt: Kéo dài hiệu ứng hoạt hình video_id: '828006748715380777' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208987-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "hiệu ứng video" Nguồn: https://docs.openaihub.net/api-45208988/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/effects: post: summary: hiệu ứng video deprecated: false description: '' operationId: post-kling-v1-videos-effects tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - effect_scene properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất effect_scene: type: string description: tên cảnh external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ input: type: object properties: image: type: string description: một người images: type: array items: type: string description: hai người description: >- Ảnh tham chiếu (Base64 hoặc URL có thể truy cập). Cấu trúc dữ liệu gửi đi thay đổi tùy theo cảnh; xem phần thân yêu cầu của từng cảnh x-apifox-orders: - image - images x-apidog-orders: - image - images x-apifox-orders: - callback_url - effect_scene - external_task_id - input x-apidog-orders: - callback_url - effect_scene - external_task_id - input examples: example: value: effect_scene: pet_lion input: image: >- Vui lòng tải ảnh trực tiếp lên cuộc trò chuyện để tôi có thể đọc và dịch nội dung. summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208988-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Video học viên tham chiếu nhiều hình ảnh" Nguồn: https://docs.openaihub.net/api-45208989/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/multi-image2video: post: summary: Video học viên tham chiếu nhiều hình ảnh deprecated: false description: '' operationId: post-kling-v1-videos-multi-image2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model_name - image_list - duration properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' enumDetails: - value: '16:9' displayName: Toàn cảnh description: Bố cục ngang màn hình rộng - value: '9:16' displayName: Chân dung description: Bố cục chân dung video ngắn - value: '1:1' displayName: Hình vuông description: Bố cục hình vuông description: >- Tỉ lệ khung hình, không bắt buộc. Cổng kết nối xác thực giá trị liệt kê khi được đặt; nếu không, hệ thống thượng nguồn sẽ quyết định. callback_url: type: string format: uri description: >- URL gọi lại khi tác vụ hoàn tất; phải có thể truy cập công khai; chuyển tiếp qua cổng. cfg_scale: type: number description: >- CFG, tùy chọn. Được chuyển tiếp nguyên trạng qua Gateway; phạm vi không được xác thực trước. duration: oneOf: - type: string enum: - '5' - '10' - type: integer enum: - 5 - 10 description: >- Thời lượng video (giây), bắt buộc. Chỉ được là 5 hoặc 10; chấp nhận chuỗi hoặc số nguyên; gateway chuẩn hóa thành chuỗi. Nếu thiếu, tính phí Relay: thời lượng phải là 5 hoặc 10. external_task_id: type: string description: >- ID tác vụ bên ngoài của bên gọi dùng để bảo đảm tính lũy đẳng/đối soát; không phải dữ liệu phản hồi.task_id. image_list: type: array items: type: object required: - image properties: image: type: string description: >- URL hoặc Base64 của hình ảnh tham chiếu, bắt buộc. Không sử dụng image_url (cổng chỉ đọc hình ảnh). image_fidelity: type: number description: >- Độ trung thực của ảnh; truyền thẳng qua cổng kết nối; phạm vi không được xác thực trước. image_url: type: string description: >- Trường URL hình ảnh dự phòng; quá trình xác thực của cổng kết nối bỏ qua trường này—hãy dùng image. type: type: string description: >- Cờ loại hình ảnh; gateway chuyển tiếp nguyên trạng; enum không được kiểm tra trước tại đây. x-apifox-orders: - image - image_fidelity - image_url - type x-apidog-orders: - image - image_fidelity - image_url - type description: >- Ảnh tham chiếu, bắt buộc, 1–4; mỗi ảnh cần có image (URL/Base64). Gateway chỉ kiểm tra không để trống; định dạng/kích thước do upstream quy định. mode: type: string enum: - std - pro enumDetails: - value: std displayName: Tiêu chuẩn description: Chế độ tiết kiệm chi phí - value: chuyên nghiệp displayName: Chất lượng cao description: chế độ hiệu năng cao, chi phí cao hơn description: >- chế độ tạo sinh. phương thức tính phí mặc định là `std` nếu bị bỏ qua. không hỗ trợ `4k`. model_name: type: string enum: - kling-v1-6 enumDetails: - value: kling-v1-6 displayName: V1.6 description: >- chỉ có mô hình dành cho video tham chiếu nhiều hình ảnh; thời lượng chỉ 5/10 giây description: >- Tên mô hình, bắt buộc. Cổng kết nối chỉ cho phép kling-v1-6; nếu không sẽ trả về 400. negative_prompt: type: string description: >- Lời nhắc phủ định, không bắt buộc. Được chuyển tiếp nguyên trạng qua cổng; độ dài không được xác thực trước (chỉ lời nhắc có kiểm tra giới hạn 2500). prompt: type: string description: >- Lời nhắc tích cực, không bắt buộc. Cổng kết nối không yêu cầu trường này; nếu được đặt, tối đa 2500 ký tự. Nên dùng để định hướng chuyển động/phong cách. x-apifox-orders: - aspect_ratio - callback_url - cfg_scale - duration - external_task_id - image_list - mode - model_name - negative_prompt - prompt x-apidog-orders: - aspect_ratio - callback_url - cfg_scale - duration - external_task_id - image_list - mode - model_name - negative_prompt - prompt examples: '1': value: aspect_ratio: '16:9' duration: '5' image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' mode: std model_name: kling-v1-6 prompt: >- Một cảnh điện ảnh kết hợp các chủ thể từ những hình ảnh tham chiếu, với chuyển động máy quay mượt mà summary: '1' '2': value: aspect_ratio: '9:16' duration: 5 image_list: - image: '{{image_url_1}}' mode: std model_name: kling-v1-6 prompt: >- Nhân vật quay người và bước về phía trước, ánh sáng tự nhiên dịu nhẹ summary: '2' '3': value: aspect_ratio: '16:9' duration: '10' image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' - image: '{{image_url_3}}' - image: '{{image_url_4}}' model_name: kling-v1-6 prompt: >- Kết hợp cảnh, nhân vật, phong cách và ánh sáng từ tất cả hình ảnh tham chiếu summary: '3' '4': value: aspect_ratio: '16:9' cfg_scale: 0.5 duration: '10' image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' mode: chuyên nghiệp model_name: kling-v1-6 negative_prompt: mờ, khuôn mặt biến dạng, chất lượng thấp, hình mờ prompt: >- Cảnh quay rộng hoành tráng, kết hợp cả hai nhân vật vào một cảnh hành động liền mạch summary: '4' '5': value: aspect_ratio: '1:1' callback_url: https://your-server.com/webhook/kling duration: '5' external_task_id: biz-mi2v-20260701-001 image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' - image: '{{image_url_3}}' mode: chuyên nghiệp model_name: kling-v1-6 prompt: >- Video theo phong cách biên tập thời trang với chuyển động lia máy năng động summary: '5' '6': value: aspect_ratio: '16:9' duration: 10 image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' mode: std model_name: kling-v1-6 prompt: Chuyển cảnh quay chậm giữa hai cảnh tham chiếu summary: '6' responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208989-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Các tác vụ truy vấn (miễn phí)" Nguồn: https://docs.openaihub.net/api-45208990/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/{action}/{action2}/{task_id}: get: summary: Các tác vụ truy vấn (miễn phí) deprecated: false description: '' operationId: get-kling-v1-action-action2-task-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling - kling parameters: - name: action in: path description: hình ảnh hoặc video required: true example: video schema: type: string - name: action2 in: path description: >- generations（hình ảnh）、text2video（video）、image2video（video）、lip-sync（video）、kolors-virtual-try-on（hình ảnh） required: true example: text2video schema: type: string - name: task_id in: path description: Mã tác vụ required: true example: CjgHYGhmPtsAAAAAAE9m7g schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: true example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: true example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object x-apidog-orders: [] examples: example: value: {} summary: example responses: '200': description: '' content: application/json: schema: type: object required: - id - object - created - choices - usage properties: choices: type: array items: type: object properties: finish_reason: type: string description: 'Lý do kết thúc, ví dụ: stop, length' index: type: integer description: Chỉ mục của mục ứng viên message: type: object required: - role - content properties: content: type: string description: Nội dung tin nhắn hoặc yêu cầu role: type: string description: >- Vai trò của tin nhắn, ví dụ: system / user / assistant / model description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - content - role x-apidog-orders: - content - role x-apifox-orders: - finish_reason - index - message x-apidog-orders: - finish_reason - index - message description: Danh sách các kết quả ứng viên created: type: integer description: Thời gian tạo (dấu thời gian Unix) id: type: string description: ID tài nguyên hoặc tác vụ object: type: string description: 'Định danh kiểu đối tượng, ví dụ: chat.completion' usage: type: object required: - prompt_tokens - completion_tokens - total_tokens properties: completion_tokens: type: integer description: Số lượng token hoàn thành prompt_tokens: type: integer description: Số lượng token trong lời nhắc total_tokens: type: integer description: Tổng số token description: Thống kê mức sử dụng token x-apifox-orders: - completion_tokens - prompt_tokens - total_tokens x-apidog-orders: - completion_tokens - prompt_tokens - total_tokens x-apifox-orders: - choices - created - id - object - usage x-apidog-orders: - choices - created - id - object - usage examples: example: summary: example value: choices: [] created: 1733851336 id: CjMT7WdSwWcAAAAAALvB3g object: kling.task usage: completion_tokens: 0 prompt_tokens: 0 total_tokens: 0 headers: {} x-apidog-name: '' '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/Kling x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208990-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "văn bản thành video" Nguồn: https://docs.openaihub.net/api-45208991/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/text2video: post: summary: văn bản thành video deprecated: false description: >- Tạo video dựa trên các từ trong lời nhắc văn bản. Có thể sử dụng phần thân yêu cầu camelCase gốc; `task_id` được trả về sau khi gửi và cần thăm dò trạng thái tác vụ. operationId: kling_text2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/văn bản thành video - Kling parameters: [] requestBody: content: application/json: schema: type: object required: - model_name - duration properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' enumDetails: - value: '16:9' displayName: Toàn cảnh description: Bố cục ngang màn hình rộng - value: '9:16' displayName: Chân dung description: Bố cục chân dung video ngắn - value: '1:1' displayName: Hình vuông description: Bố cục hình vuông description: >- Tỷ lệ khung hình (chiều rộng:chiều cao). Các ràng buộc từ hệ thống nguồn: thường dùng 16:9 / 9:16 / 1:1, cổng kết nối không liệt kê trước để kiểm tra. callback_url: type: string format: uri description: >- Địa chỉ gọi lại khi tác vụ hoàn tất. Gửi thông báo bằng phương thức POST sau khi tác vụ thượng nguồn hoàn tất; địa chỉ này phải có thể truy cập được qua mạng công cộng, và cổng kết nối chuyển tiếp nguyên trạng thông tin. camera_control: type: object properties: config: type: object properties: horizontal: type: number description: Chuyển vị ngang pan: type: number description: Di chuyển ngang (sang trái và sang phải) roll: type: number description: xoay tilt: type: number description: Di chuyển dọc (lên và xuống) vertical: type: number description: độ dịch chuyển theo phương thẳng đứng zoom: type: number description: thu phóng description: Cấu hình tham số chuyển động của ống kính x-apifox-orders: - horizontal - pan - roll - tilt - vertical - zoom x-apidog-orders: - horizontal - pan - roll - tilt - vertical - zoom type: type: string description: Loại điều khiển, chẳng hạn như đơn giản description: >- Điều khiển chuyển động của ống kính. Nếu tham số này không được truyền, mô hình sẽ tự động lựa chọn giá trị phù hợp; cổng trung gian sẽ truyền nguyên trạng và không kiểm tra trước phạm vi giá trị cụ thể. x-apifox-orders: - config - type x-apidog-orders: - config - type cfg_scale: type: number description: >- Mức độ tự do khi tạo (CFG). Giá trị càng lớn thì mức độ tương quan giữa kết quả được tạo và câu lệnh càng cao; cổng kết nối không kiểm tra trước phạm vi giá trị, còn các giới hạn của dịch vụ nguồn thường là 0~1. duration: oneOf: - type: string - type: integer description: >- Thời lượng video (giây), bắt buộc. Không phải kling-v3: chỉ 5 hoặc 10; kling-v3: 3~15. Hỗ trợ chuỗi hoặc số nguyên, cổng kết nối chuẩn hóa thành chuỗi. external_task_id: type: string description: >- ID tác vụ bên ngoài của bên gọi, được dùng để liên kết theo cách bảo đảm tính lũy đẳng và đối soát nghiệp vụ; trường `data.task_id` không nằm trong nội dung phản hồi. mode: type: string enum: - std - pro - 4k enumDetails: - value: std displayName: Tiêu chuẩn description: Chế độ tiết kiệm chi phí - value: chuyên nghiệp displayName: Chất lượng cao description: Chế độ hiệu năng cao - value: 4k displayName: 4K description: Chỉ được hỗ trợ trên kling-v3 description: >- Tạo lược đồ. Phía thanh toán mặc định là std khi không được truyền. 4k chỉ dành cho kling-v3; kling-v2-6 yêu cầu pro để bật âm thanh. model_name: type: string enum: - kling-v1 - kling-v1-6 - kling-v2-master - kling-v2-1-master - kling-v2-5-turbo - kling-v2-6 - kling-v3 enumDetails: - value: kling-v1 displayName: V1 description: Mô hình cổ điển; thời lượng chỉ là 5/10 giây - value: kling-v1-6 displayName: V1.6 description: V1.6 được cải tiến; thời lượng chỉ là 5/10 giây - value: kling-v2-master displayName: Bản chính V2 description: Bản chính; thời lượng chỉ là 5/10 giây - value: kling-v2-1-master displayName: Bản chính V2.1 description: Bản chính V2.1; thời lượng chỉ là 5/10 giây - value: kling-v2-5-turbo displayName: V2.5 Turbo description: Hạng Turbo; thời lượng chỉ 5/10 giây - value: kling-v2-6 displayName: V2.6 description: >- Hỗ trợ âm thanh (yêu cầu mode=pro + sound=on); thời lượng chỉ là 5/10 giây - value: kling-v3 displayName: V3 description: Hỗ trợ sound/4k/multi_shot; thời lượng 3–15s description: >- Tên mô hình. Khi không được truyền, hệ thống tính toán mức sử dụng của cổng mặc định là kling-v1, và nên điền rõ giá trị này. Giá trị phải là kling-v3 khi multi_shot=true; giá trị phải là kling-v3 khi mode=4k. multi_prompt: type: array items: type: object required: - index - prompt - duration properties: duration: oneOf: - type: string - type: number - type: integer description: Thời lượng của bảng phân cảnh (giây), ≥1 index: type: integer description: Số thứ tự bảng phân cảnh, bắt đầu từ 1 prompt: type: string description: >- Từ ngữ lời nhắc tích cực của bảng phân cảnh, ≤512 ký tự x-apifox-orders: - duration - index - prompt x-apidog-orders: - duration - index - prompt description: >- Danh sách bảng phân cảnh tùy chỉnh. Bắt buộc khi shot_type=customize, tối đa 6 cảnh quay. Mỗi prompt của mirror ≤512, duration ≥1; tổng duration của từng mirror phải bằng duration cấp cao nhất (sai số ≤0.1). multi_shot: type: boolean description: >- Có nhiều góc máy hay không. Khi là true, chỉ kling-v3 hỗ trợ tính năng này và prompt không hợp lệ; khi là false, không thể truyền shot_type / multi_prompt. negative_prompt: type: string description: >- Các từ gợi ý phủ định. Mô tả nội dung không mong muốn và truyền nội dung đó một cách minh bạch qua cổng. prompt: type: string description: >- Các từ gợi ý tích cực. Bắt buộc khi multi_shot=false (mặc định); không hợp lệ khi multi_shot=true, phản hồi 400 sẽ được gửi. Giới hạn từ nguồn cấp trên ≤2500 ký tự. shot_type: type: string enum: - customize - intelligence enumDetails: - value: tùy chỉnh displayName: Ảnh chụp tùy chỉnh description: >- Yêu cầu multi_prompt; tổng thời lượng của các cảnh phải bằng thời lượng cấp cao nhất - value: trí tuệ displayName: Ảnh chụp tự động description: '`multi_prompt` không bắt buộc' description: >- Phương thức lập bảng phân cảnh. Bắt buộc khi multi_shot=true; không thể được truyền khi multi_shot=false. customize phải được sử dụng cùng với multi_prompt; intelligence sẽ tự động bị loại bỏ khỏi hệ thống nguồn. sound: type: string enum: - 'on' - 'off' enumDetails: - value: bật displayName: Bật âm thanh description: Chỉ v2-6 / v3; v2-6 yêu cầu mode=pro - value: tắt displayName: Lên tiếng description: Mặc định không hiển thị thông báo description: >- Công tắc âm thanh. Cổng chỉ thực hiện xác minh mô hình/lược đồ đối với các giá trị khác null; kích hoạt tính phí âm thanh khi truyền on. Chỉ được hỗ trợ bởi kling-v2-6 / kling-v3; v2-6 yêu cầu mode=pro. voice_list: type: array items: type: object required: - voice_id properties: voice_id: type: string description: ID bản vá tùy chỉnh, từ giao diện tạo bản vá x-apifox-orders: - voice_id x-apidog-orders: - voice_id description: >- Danh sách âm thanh tùy chỉnh. Trường này có thể được truyền trong suốt; quy trình tính phí text2video hiện tại không nhận diện riêng voice_list (không giống image2video, trường này không ảnh hưởng đến hệ số hasVoiceId). refName: PostKlingV1VideosText2videoRequest x-apifox-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list x-apidog-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list examples: '1': value: aspect_ratio: '16:9' duration: '5' mode: std model_name: kling-v1 prompt: >- Cảnh quay từ thiết bị bay không người lái về một đường bờ biển tuyệt đẹp vào lúc hoàng hôn vàng rực summary: '1' description: >- Khuyến nghị cho người mới: Vincent Video · Lộ trình gửi bài tối thiểu khả dụng '2': value: aspect_ratio: '16:9' duration: '10' mode: chuyên nghiệp model_name: kling-v2-master prompt: >- Cảnh quay điện ảnh tiến máy dolly vào trên mặt hồ miền núi phủ sương lúc bình minh, ánh sáng viền dịu nhẹ summary: '2' description: >- Đề xuất cho người mới bắt đầu: Vincent Video · V2 Master chất lượng cao 10 giây '3': value: aspect_ratio: '16:9' duration: '5' mode: chuyên nghiệp model_name: kling-v2-6 prompt: >- Một nhạc công đường phố chơi đàn vĩ cầm tại một góc phố trong thành phố dưới trời mưa, với âm thanh đám đông xung quanh sound: bật summary: '3' description: >- Đề xuất cho người mới bắt đầu: Vincent Video · Âm thanh chuyên nghiệp V2.6 '4': value: aspect_ratio: '16:9' duration: 8 mode: chuyên nghiệp model_name: kling-v3 prompt: >- Cảnh quay từ từ tiến gần vào một thám tử đang đọc hồ sơ vụ án dưới ánh đèn bàn summary: '4' description: >- Khuyến nghị cho người mới bắt đầu: Vincent Video · V3 8 giây mỗi giây '5': value: aspect_ratio: '16:9' cfg_scale: 0.7 duration: '5' mode: std model_name: kling-v1-6 negative_prompt: mờ, chất lượng thấp, hình mờ, chữ phủ lên prompt: >- Một chú ngựa trắng phi nước đại dọc bãi biển lúc bình minh, hiệu ứng nhòe chuyển động điện ảnh summary: '5' description: >- Khuyến nghị nâng cao: Vincent Video · Từ khóa phủ định và cfg_scale '6': value: aspect_ratio: '9:16' callback_url: https://example.com/callback duration: 6 external_task_id: '{{external_task_id}}' mode: 4k model_name: kling-v3 prompt: >- Chân dung cyberpunk dưới mưa neon, máy quay từ từ xoay quanh chủ thể summary: '6' description: >- Đề xuất nâng cao: Vincent Video · Lệnh gọi lại màn hình dọc 4K V3 '7': value: aspect_ratio: '16:9' duration: '6' mode: chuyên nghiệp model_name: kling-v3 multi_prompt: - duration: '2' index: 1 prompt: >- Cảnh toàn rộng mở đầu về đường chân trời của một thành phố tương lai lúc chạng vạng - duration: '2' index: 2 prompt: >- Cảnh quay trung, một người giao hàng chạy qua những con phố đông đúc với các biển hiệu neon - duration: '2' index: 3 prompt: >- Cận cảnh khuôn mặt đầy quyết tâm của người giao hàng, những giọt mưa đọng trên da multi_shot: true shot_type: tùy chỉnh summary: '7' description: 'Đề xuất nâng cao: Vincent Video · Tùy chỉnh đa ống kính V3' '8': value: aspect_ratio: '16:9' duration: '10' mode: chuyên nghiệp model_name: kling-v3 multi_shot: true prompt: >- Hành trình tua nhanh thời gian qua bốn mùa tại cùng một khoảng rừng trống shot_type: trí tuệ summary: '8' description: 'Đề xuất nâng cao: Vincent Video · Trí tuệ đa ống kính V3' '9': value: aspect_ratio: '16:9' camera_control: config: horizontal: 0 pan: 0 roll: 0 tilt: -2.5 vertical: 0 zoom: 1.5 type: simple duration: '5' mode: chuyên nghiệp model_name: kling-v2-5-turbo prompt: >- Chuyển động bay về phía trước như flycam trên một thung lũng núi sâu phủ sương mù buổi sáng summary: '9' description: >- Đề xuất nâng cao: Vincent Video · Điều khiển ống kính camera_control example_single: value: aspect_ratio: '16:9' duration: 5 mode: std model_name: kling-v1-6 prompt: Một con mèo đang chạy trên đồng cỏ, trời nắng đẹp. summary: example_single description: Video Vincent responses: '200': description: Tác vụ đã được gửi thành công content: application/json: schema: type: object properties: code: type: integer description: Mã trạng thái nghiệp vụ examples: - 0 data: type: object properties: created_at: type: integer description: Thời điểm tạo (mili giây) task_id: type: string description: ID tác vụ, được dùng để kiểm tra định kỳ task_status: type: string enum: - submitted - processing - succeed - failed description: Trạng thái tác vụ updated_at: type: integer description: Cập nhật dấu thời gian (mili giây) description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) x-apifox-orders: - created_at - task_id - task_status - updated_at x-apidog-orders: - created_at - task_id - task_status - updated_at message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. examples: - thành công request_id: type: string description: ID truy vết yêu cầu refName: KlingTaskSubmitResponse x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: created_at: 0 task_id: chuỗi task_status: đã gửi updated_at: 0 message: thành công request_id: chuỗi headers: {} x-apidog-name: Tác vụ đã được gửi 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/Kling/văn bản thành video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208991-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45208992/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/text2video/{task_id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: >- Truy van trang thai va ket qua cua tac vu Vincent Video dua tren `task_id`. operationId: kling_get_text2video_task tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/văn bản thành video - Kling parameters: - name: task_id in: path description: task_id được trả về khi gửi một tác vụ required: true example: '1234567890123456' schema: type: string responses: '200': description: thành công content: application/json: schema: type: object properties: code: type: integer description: Mã trạng thái nghiệp vụ data: type: object properties: task_id: type: string description: ID tác vụ bất đồng bộ task_result: type: object properties: images: type: array items: type: object properties: id: type: string description: ID tài nguyên hoặc tác vụ url: type: string description: URL tài nguyên x-apifox-orders: - id - url x-apidog-orders: - id - url description: Danh sách URL hình ảnh hoặc chuỗi Base64 videos: type: array items: type: object properties: duration: type: string description: >- Thời lượng (giây hoặc đơn vị do nền tảng quy định) id: type: string description: ID tài nguyên hoặc tác vụ url: type: string description: Tạo URL video x-apifox-orders: - duration - id - url x-apidog-orders: - duration - id - url description: Danh sách video đã tạo description: Đối tượng kết quả tác vụ x-apifox-orders: - images - videos x-apidog-orders: - images - videos task_status: type: string enum: - submitted - processing - succeed - failed description: Trạng thái tác vụ task_status_msg: type: string description: Thông báo trạng thái tác vụ description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) x-apifox-orders: - task_id - task_result - task_status - task_status_msg x-apidog-orders: - task_id - task_result - task_status - task_status_msg message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. request_id: type: string description: ID truy vết yêu cầu refName: KlingTaskQueryResponse x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: task_id: chuỗi task_result: images: - id: string url: string videos: - duration: chuỗi id: string url: string task_status: đã gửi task_status_msg: chuỗi message: chuỗi request_id: chuỗi headers: {} x-apidog-name: thành công '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/Kling/văn bản thành video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208992-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "ảnh-thành-video" Nguồn: https://docs.openaihub.net/api-45208993/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/image2video: post: summary: ảnh-thành-video deprecated: false description: Tạo video bằng cách sử dụng hình ảnh đầu vào làm khung hình bắt đầu. operationId: kling_image2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/ảnh-thành-video - Kling parameters: [] requestBody: content: application/json: schema: type: object required: - model_name - image - duration properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' enumDetails: - value: '16:9' displayName: Toàn cảnh description: Bố cục ngang màn hình rộng - value: '9:16' displayName: Chân dung description: Bố cục chân dung video ngắn - value: '1:1' displayName: Hình vuông description: Bố cục hình vuông description: >- Tỷ lệ khung hình (chiều rộng:chiều cao). Các ràng buộc từ hệ thống nguồn: thường dùng 16:9 / 9:16 / 1:1, cổng kết nối không liệt kê trước để kiểm tra. callback_url: type: string format: uri description: >- Địa chỉ gọi lại khi tác vụ hoàn tất. Gửi thông báo bằng phương thức POST sau khi tác vụ thượng nguồn hoàn tất; địa chỉ này phải có thể truy cập được qua mạng công cộng, và cổng kết nối chuyển tiếp nguyên trạng thông tin. camera_control: type: object properties: config: type: object properties: horizontal: type: number description: Chuyển vị ngang pan: type: number description: Di chuyển ngang (sang trái và sang phải) roll: type: number description: xoay tilt: type: number description: Di chuyển dọc (lên và xuống) vertical: type: number description: độ dịch chuyển theo phương thẳng đứng zoom: type: number description: thu phóng description: Cấu hình tham số chuyển động của ống kính x-apifox-orders: - horizontal - pan - roll - tilt - vertical - zoom x-apidog-orders: - horizontal - pan - roll - tilt - vertical - zoom type: type: string description: Loại điều khiển, chẳng hạn như đơn giản description: >- Điều khiển chuyển động của ống kính. Nếu tham số này không được truyền, mô hình sẽ tự động lựa chọn giá trị phù hợp; cổng trung gian sẽ truyền nguyên trạng và không kiểm tra trước phạm vi giá trị cụ thể. x-apifox-orders: - config - type x-apidog-orders: - config - type cfg_scale: type: number description: >- Mức độ tự do khi tạo (CFG). Giá trị càng lớn thì mức độ tương quan giữa kết quả được tạo và câu lệnh càng cao; cổng kết nối không kiểm tra trước phạm vi giá trị, còn các giới hạn của dịch vụ nguồn thường là 0~1. duration: oneOf: - type: string - type: integer description: >- Thời lượng video (giây), bắt buộc. Không phải kling-v3: chỉ 5 hoặc 10; kling-v3: 3~15. Hỗ trợ chuỗi hoặc số nguyên, cổng kết nối chuẩn hóa thành chuỗi. external_task_id: type: string description: >- ID tác vụ bên ngoài của bên gọi, được dùng để liên kết theo cách bảo đảm tính lũy đẳng và đối soát nghiệp vụ; trường `data.task_id` không nằm trong nội dung phản hồi. image: type: string description: >- Nhập URL hình ảnh hoặc Base64, bắt buộc. Được dùng làm tham chiếu cho khung hình đầu tiên của video; đây là trường cốt lõi của video tạo từ ảnh. Định dạng/kích thước/độ phân giải được xác minh bởi dịch vụ thượng nguồn, cổng chỉ xác minh rằng trường này không để trống. image_tail: type: string description: >- URL hoặc Base64 của hình ảnh khung hình kết thúc, không bắt buộc. Kết hợp với hình ảnh để thực hiện quá trình chuyển tiếp giữa khung hình đầu tiên và khung hình cuối cùng; nếu không được truyền vào, nội dung sẽ chỉ được tạo từ khung hình đầu tiên. Cổng truyền dữ liệu một cách minh bạch và không kiểm tra trước định dạng. mode: type: string enum: - std - pro - 4k enumDetails: - value: std displayName: Tiêu chuẩn description: Chế độ tiết kiệm chi phí - value: chuyên nghiệp displayName: Chất lượng cao description: Chế độ hiệu năng cao - value: 4k displayName: 4K description: Chỉ được hỗ trợ trên kling-v3 description: >- Tạo lược đồ. Phía thanh toán mặc định là std khi không được truyền. 4k chỉ dành cho kling-v3; kling-v2-6 yêu cầu pro để bật âm thanh. model_name: type: string enum: - kling-v1 - kling-v1-5 - kling-v1-6 - kling-v2-master - kling-v2-1 - kling-v2-1-master - kling-v2-5-turbo - kling-v2-6 - kling-v3 enumDetails: - value: kling-v1 displayName: V1 description: >- Chuyển hình ảnh thành video kiểu cổ điển; thời lượng chỉ 5/10 giây - value: kling-v1-5 displayName: V1.5 description: >- Mô hình chuyên biệt chuyển ảnh thành video; thời lượng chỉ 5/10 giây - value: kling-v1-6 displayName: V1.6 description: >- V1.6 tăng cường chuyển đổi hình ảnh thành video; thời lượng chỉ là 5/10 giây - value: kling-v2-master displayName: Bản chính V2 description: >- Làm chủ việc tạo video từ hình ảnh; thời lượng chỉ 5/10 giây - value: kling-v2-1 displayName: V2.1 description: >- Mô hình chuyên biệt chuyển ảnh thành video; thời lượng chỉ 5/10 giây - value: kling-v2-1-master displayName: Bản chính V2.1 description: >- V2.1 Làm chủ chuyển đổi hình ảnh thành video; thời lượng chỉ là 5/10 giây - value: kling-v2-5-turbo displayName: V2.5 Turbo description: Chuyển ảnh thành video Turbo; thời lượng chỉ 5/10 giây - value: kling-v2-6 displayName: V2.6 description: >- Hỗ trợ âm thanh (yêu cầu mode=pro + sound=on); thời lượng chỉ là 5/10 giây - value: kling-v3 displayName: V3 description: Hỗ trợ sound/4k/multi_shot; thời lượng 3–15s description: >- Tên mô hình. Khi không được truyền, việc tính toán mức sử dụng của cổng mặc định dùng kling-v1, và bạn nên điền rõ giá trị này. Đối với text2video, nên ưu tiên kling-v1-5 / kling-v2-1 hơn. Phải dùng kling-v3 khi multi_shot=true; phải dùng kling-v3 khi mode=4k. multi_prompt: type: array items: type: object required: - index - prompt - duration properties: duration: oneOf: - type: string - type: number - type: integer description: Thời lượng của bảng phân cảnh (giây), ≥1 index: type: integer description: Số thứ tự bảng phân cảnh, bắt đầu từ 1 prompt: type: string description: >- Từ ngữ lời nhắc tích cực của bảng phân cảnh, ≤512 ký tự x-apifox-orders: - duration - index - prompt x-apidog-orders: - duration - index - prompt description: >- Danh sách bảng phân cảnh tùy chỉnh. Bắt buộc khi shot_type=customize, tối đa 6 cảnh quay. Mỗi prompt của mirror ≤512, duration ≥1; tổng duration của từng mirror phải bằng duration cấp cao nhất (sai số ≤0.1). multi_shot: type: boolean description: >- Có nhiều ống kính hay không. Khi là `true`, chỉ `kling-v3` hỗ trợ tùy chọn này và `prompt` không hợp lệ; khi là `false`, không thể truyền `shot_type` / `multi_prompt`, và sẽ xảy ra lỗi 400 nếu các tham số này được truyền. negative_prompt: type: string description: >- Từ gợi ý phủ định. Mô tả nội dung không mong muốn (chẳng hạn như hình ảnh bị nhòe, chất lượng hình ảnh thấp, biến dạng, v.v.), và cổng kết nối sẽ truyền nguyên trạng nội dung đó. prompt: type: string description: >- Các từ gợi ý tích cực. Bắt buộc khi multi_shot=false (mặc định); không hợp lệ khi multi_shot=true, mã 400 sẽ được gửi. Mô tả chuyển động, cảnh quay và phong cách, giới hạn từ dịch vụ thượng nguồn là ≤2500 ký tự. shot_type: type: string enum: - customize - intelligence enumDetails: - value: tùy chỉnh displayName: Ảnh chụp tùy chỉnh description: >- Yêu cầu multi_prompt; tổng thời lượng của các cảnh phải bằng thời lượng cấp cao nhất - value: trí tuệ displayName: Ảnh chụp tự động description: >- `multi_prompt` không bắt buộc; mô hình tự động thực hiện shots description: >- Phương thức lập bảng phân cảnh. Bắt buộc khi multi_shot=true; không thể được truyền khi multi_shot=false. customize phải được sử dụng cùng với multi_prompt; intelligence sẽ tự động bị loại bỏ khỏi hệ thống nguồn. sound: type: string enum: - 'on' - 'off' enumDetails: - value: bật displayName: Bật âm thanh description: >- Chỉ hỗ trợ v2-6 / v3; v2-6 yêu cầu mode=pro; voice_list có thể ảnh hưởng đến hệ số tính phí - value: tắt displayName: Lên tiếng description: Mặc định không hiển thị thông báo description: >- Công tắc âm thanh. Cổng chỉ thực hiện xác minh mô hình/lược đồ đối với các giá trị khác null; kích hoạt tính phí âm thanh khi truyền on. Chỉ được hỗ trợ bởi kling-v2-6 / kling-v3; v2-6 yêu cầu mode=pro. voice_list: type: array items: type: object required: - voice_id properties: voice_id: type: string description: ID bản vá tùy chỉnh, từ giao diện tạo bản vá x-apifox-orders: - voice_id x-apidog-orders: - voice_id description: >- Danh sách âm thanh tùy chỉnh. Tham gia vào hệ số nhân thanh toán (hasVoiceId) khi sound=on và không rỗng; chỉ nhận diện đường dẫn image2video, không bao gồm text2video. Yêu cầu khả năng âm thanh của kling-v2-6 / kling-v3. refName: PostKlingV1VideosImage2videoRequest x-apifox-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - image - image_tail - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list x-apidog-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - image - image_tail - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list examples: '1': value: duration: '5' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-6 prompt: Một chú gấu trúc uống cà phê trong một quán cà phê ấm cúng. summary: '1' description: >- Khuyến nghị cho người mới bắt đầu: Tusheng Video · Quy trình gửi tối thiểu khả dụng '2': value: duration: '5' image: '{{image_url}}' mode: std model_name: kling-v1 prompt: Một con mèo từ từ quay đầu về phía máy quay summary: '2' description: >- Khuyên dùng cho người mới bắt đầu: Video tạo từ hình ảnh · V1 tiêu chuẩn 5 giây '3': value: aspect_ratio: '16:9' duration: '10' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-master prompt: >- Cú máy dolly tiến mang phong cách điện ảnh, ánh sáng viền dịu summary: '3' description: >- Khuyên dùng cho người mới bắt đầu: Ảnh sang video · V2 Master chất lượng cao 10 giây '4': value: duration: '5' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-6 prompt: >- Một nghệ sĩ đường phố chơi đàn violin, âm thanh náo nhiệt của đám đông sound: bật summary: '4' description: >- Khuyên dùng cho người mới bắt đầu: Video Tusheng · âm thanh chuyên nghiệp V2.6 '5': value: duration: 8 image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v3 prompt: Cảnh quay tiến chậm vào chủ thể với ánh sáng kịch tính summary: '5' description: >- Khuyên dùng cho người mới bắt đầu: Video từ ảnh · V3 8 giây mỗi giây '6': value: aspect_ratio: '16:9' cfg_scale: 0.7 duration: '5' image: '{{image_url}}' mode: std model_name: kling-v1-6 negative_prompt: mờ, chất lượng thấp, hình mờ prompt: Một con ngựa trắng đang chạy trên bãi biển lúc bình minh summary: '6' description: >- Khuyến nghị nâng cao: Video tạo từ hình ảnh · Từ khóa phủ định và cfg_scale '7': value: duration: '10' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-6 prompt: >- Một người dẫn chương trình thời sự nói trước máy quay trong trường quay sound: bật voice_list: - voice_id: '{{voice_id}}' summary: '7' description: >- Đề xuất nâng cao: Video tạo từ ảnh · Âm sắc được chỉ định cho âm thanh V2.6 '8': value: aspect_ratio: '9:16' callback_url: https://example.com/callback duration: 6 external_task_id: '{{external_task_id}}' image: '{{image_url}}' mode: 4k model_name: kling-v3 prompt: Chân dung cyberpunk, phản chiếu dưới mưa, độ tương phản cao summary: '8' description: >- Đề xuất nâng cao: Video Tusheng · Lệnh gọi lại màn hình dọc 4K V3 '9': value: duration: 6 image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v3 multi_prompt: - duration: '2' index: 1 prompt: Cảnh toàn cảnh đường chân trời thành phố lúc chạng vạng - duration: '2' index: 2 prompt: Trung cảnh, nhân vật bước vào khung hình - duration: '2' index: 3 prompt: Cận cảnh khuôn mặt, nụ cười nhẹ multi_shot: true shot_type: tùy chỉnh summary: '9' description: >- Đề xuất nâng cao: Video tạo từ hình ảnh · Tùy chỉnh đa ống kính V3 '10': value: camera_control: config: horizontal: 0 pan: 0 roll: 0 tilt: -2.5 vertical: 0 zoom: 1.5 type: simple duration: '5' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-5-turbo prompt: >- Chuyển động tiến về phía trước như thiết bị bay không người lái trên thung lũng núi summary: '10' description: >- Đề xuất nâng cao: Video tạo từ ảnh · Điều khiển ống kính camera_control example_single: value: duration: 5 image: https://example.com/start-frame.jpg mode: std model_name: kling-v1-6 prompt: Máy quay từ từ tiến lại gần, nhân vật mỉm cười summary: example_single description: video từ ảnh responses: '200': description: Tác vụ đã được gửi thành công content: application/json: schema: type: object properties: code: type: integer description: Mã trạng thái nghiệp vụ examples: - 0 data: type: object properties: created_at: type: integer description: Thời điểm tạo (mili giây) task_id: type: string description: ID tác vụ, được dùng để kiểm tra định kỳ task_status: type: string enum: - submitted - processing - succeed - failed description: Trạng thái tác vụ updated_at: type: integer description: Cập nhật dấu thời gian (mili giây) description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) x-apifox-orders: - created_at - task_id - task_status - updated_at x-apidog-orders: - created_at - task_id - task_status - updated_at message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. examples: - thành công request_id: type: string description: ID truy vết yêu cầu refName: KlingTaskSubmitResponse x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: created_at: 0 task_id: chuỗi task_status: đã gửi updated_at: 0 message: thành công request_id: chuỗi headers: {} x-apidog-name: Tác vụ đã được gửi 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/Kling/ảnh-thành-video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208993-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45208994/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/image2video/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-videos-image2video-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/ảnh-thành-video - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '827297867001249878' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/ảnh-thành-video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208994-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Omni-Image" Nguồn: https://docs.openaihub.net/api-45208995/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/omni-image: post: summary: Omni-Image deprecated: false description: '' operationId: post-kling-v1-images-omni-image tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Omni-Image - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model_name - prompt properties: aspect_ratio: type: string description: |- Tỷ lệ khung hình (R:C) enum: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9, auto auto: tự động xác định thông minh từ đầu vào bị bỏ qua khi khớp với tỷ lệ khung hình của nguồn callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ image_list: type: array items: type: object properties: image: type: string description: URL hình ảnh hoặc Base64 x-apifox-orders: - image x-apidog-orders: - image description: danh sách hình ảnh tham chiếu model_name: type: string description: 'Liệt kê tên mô hình: kling-image-o1,kling-v3-omni' 'n': type: integer description: 'Phạm vi số lượng hình ảnh cần tạo: [1,9]' prompt: type: string description: >- lời nhắc dạng văn bản, có thể bao gồm mô tả tích cực và tiêu cực có thể sử dụng các mẫu cho những nhu cầu hình ảnh khác nhau tối đa 2500 ký tự resolution: type: string description: |- Liệt kê độ rõ đầu ra: 1k, 2k 1k: SD 1K 2k: HD 2K result_type: type: string description: |- Chuyển đổi đơn / chuỗi enum: single, series series_amount: type: integer description: |- Hình ảnh trong chuỗi ● range: [2, 9] bị bỏ qua khi result_type là single watermark_info: type: object required: - enabled properties: enabled: type: boolean description: Có được bật hay không description: >- có đồng thời tạo kết quả có hình mờ hay không ● được xác định bởi enabled, dưới dạng khóa:giá trị, như sau: : "watermark_info": { "enabled": boolean // true=tạo, false=không tạo } ● hình mờ tùy chỉnh hiện chưa được hỗ trợ x-apifox-orders: - enabled x-apidog-orders: - enabled x-apifox-orders: - aspect_ratio - callback_url - external_task_id - image_list - model_name - 'n' - prompt - resolution - result_type - series_amount - watermark_info x-apidog-orders: - aspect_ratio - callback_url - external_task_id - image_list - model_name - 'n' - prompt - resolution - result_type - series_amount - watermark_info examples: example: value: aspect_ratio: '' callback_url: '' element_list: - element_id: '835266081714884677' external_task_id: '' model_name: kling-image-o1 'n': 1 prompt: Tạo một bức ảnh về cảnh nhảy múa bên bờ biển resolution: '' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Omni-Image x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208995-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45208996/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/omni-image/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-images-omni-image-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Omni-Image - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Omni-Image x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208996-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Video học viên tham chiếu nhiều hình ảnh" Nguồn: https://docs.openaihub.net/api-45208997/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/multi-image2video: post: summary: Video học viên tham chiếu nhiều hình ảnh deprecated: false description: '' operationId: post-kling-v1-videos-multi-image2video tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Video học viên tham chiếu nhiều hình ảnh - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model_name - image_list - duration properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' enumDetails: - value: '16:9' displayName: Toàn cảnh description: Bố cục ngang màn hình rộng - value: '9:16' displayName: Chân dung description: Bố cục chân dung video ngắn - value: '1:1' displayName: Hình vuông description: Bố cục hình vuông description: >- Tỉ lệ khung hình, không bắt buộc. Cổng kết nối xác thực giá trị liệt kê khi được đặt; nếu không, hệ thống thượng nguồn sẽ quyết định. callback_url: type: string format: uri description: >- URL gọi lại khi tác vụ hoàn tất; phải có thể truy cập công khai; chuyển tiếp qua cổng. cfg_scale: type: number description: >- CFG, tùy chọn. Được chuyển tiếp nguyên trạng qua Gateway; phạm vi không được xác thực trước. duration: oneOf: - type: string enum: - '5' - '10' - type: integer enum: - 5 - 10 description: >- Thời lượng video (giây), bắt buộc. Chỉ được là 5 hoặc 10; chấp nhận chuỗi hoặc số nguyên; gateway chuẩn hóa thành chuỗi. Nếu thiếu, tính phí Relay: thời lượng phải là 5 hoặc 10. external_task_id: type: string description: >- ID tác vụ bên ngoài của bên gọi dùng để bảo đảm tính lũy đẳng/đối soát; không phải dữ liệu phản hồi.task_id. image_list: type: array items: type: object required: - image properties: image: type: string description: >- URL hoặc Base64 của hình ảnh tham chiếu, bắt buộc. Không sử dụng image_url (cổng chỉ đọc hình ảnh). image_fidelity: type: number description: >- Độ trung thực của ảnh; truyền thẳng qua cổng kết nối; phạm vi không được xác thực trước. image_url: type: string description: >- Trường URL hình ảnh dự phòng; quá trình xác thực của cổng kết nối bỏ qua trường này—hãy dùng image. type: type: string description: >- Cờ loại hình ảnh; gateway chuyển tiếp nguyên trạng; enum không được kiểm tra trước tại đây. x-apifox-orders: - image - image_fidelity - image_url - type x-apidog-orders: - image - image_fidelity - image_url - type description: >- Ảnh tham chiếu, bắt buộc, 1–4; mỗi ảnh cần có image (URL/Base64). Gateway chỉ kiểm tra không để trống; định dạng/kích thước do upstream quy định. mode: type: string enum: - std - pro enumDetails: - value: std displayName: Tiêu chuẩn description: Chế độ tiết kiệm chi phí - value: chuyên nghiệp displayName: Chất lượng cao description: chế độ hiệu năng cao, chi phí cao hơn description: >- chế độ tạo sinh. phương thức tính phí mặc định là `std` nếu bị bỏ qua. không hỗ trợ `4k`. model_name: type: string enum: - kling-v1-6 enumDetails: - value: kling-v1-6 displayName: V1.6 description: >- chỉ có mô hình dành cho video tham chiếu nhiều hình ảnh; thời lượng chỉ 5/10 giây description: >- Tên mô hình, bắt buộc. Cổng kết nối chỉ cho phép kling-v1-6; nếu không sẽ trả về 400. negative_prompt: type: string description: >- Lời nhắc phủ định, không bắt buộc. Được chuyển tiếp nguyên trạng qua cổng; độ dài không được xác thực trước (chỉ lời nhắc có kiểm tra giới hạn 2500). prompt: type: string description: >- Lời nhắc tích cực, không bắt buộc. Cổng kết nối không yêu cầu trường này; nếu được đặt, tối đa 2500 ký tự. Nên dùng để định hướng chuyển động/phong cách. x-apifox-orders: - aspect_ratio - callback_url - cfg_scale - duration - external_task_id - image_list - mode - model_name - negative_prompt - prompt x-apidog-orders: - aspect_ratio - callback_url - cfg_scale - duration - external_task_id - image_list - mode - model_name - negative_prompt - prompt examples: '1': value: aspect_ratio: '16:9' duration: '5' image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' mode: std model_name: kling-v1-6 prompt: >- Một cảnh điện ảnh kết hợp các chủ thể từ những hình ảnh tham chiếu, với chuyển động máy quay mượt mà summary: '1' '2': value: aspect_ratio: '9:16' duration: 5 image_list: - image: '{{image_url_1}}' mode: std model_name: kling-v1-6 prompt: >- Nhân vật quay người và bước về phía trước, ánh sáng tự nhiên dịu nhẹ summary: '2' '3': value: aspect_ratio: '16:9' duration: '10' image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' - image: '{{image_url_3}}' - image: '{{image_url_4}}' model_name: kling-v1-6 prompt: >- Kết hợp cảnh, nhân vật, phong cách và ánh sáng từ tất cả hình ảnh tham chiếu summary: '3' '4': value: aspect_ratio: '16:9' cfg_scale: 0.5 duration: '10' image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' mode: chuyên nghiệp model_name: kling-v1-6 negative_prompt: mờ, khuôn mặt biến dạng, chất lượng thấp, hình mờ prompt: >- Cảnh quay rộng hoành tráng, kết hợp cả hai nhân vật vào một cảnh hành động liền mạch summary: '4' '5': value: aspect_ratio: '1:1' callback_url: https://your-server.com/webhook/kling duration: '5' external_task_id: biz-mi2v-20260701-001 image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' - image: '{{image_url_3}}' mode: chuyên nghiệp model_name: kling-v1-6 prompt: >- Video theo phong cách biên tập thời trang với chuyển động lia máy năng động summary: '5' '6': value: aspect_ratio: '16:9' duration: 10 image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' mode: std model_name: kling-v1-6 prompt: Chuyển cảnh quay chậm giữa hai cảnh tham chiếu summary: '6' responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Video học viên tham chiếu nhiều hình ảnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208997-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45208998/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/multi-image2video/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-videos-multi-image2video-id tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Video học viên tham chiếu nhiều hình ảnh - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '827652927698776157' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Video học viên tham chiếu nhiều hình ảnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208998-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Khởi tạo video cần chỉnh sửa" Nguồn: https://docs.openaihub.net/api-45208999/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/multi-elements/init-selection: post: summary: Khởi tạo video cần chỉnh sửa deprecated: false description: '' operationId: post-kling-v1-videos-multi-elements-init-selection tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Chỉnh sửa video đa phương thức - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object properties: video_id: type: string description: >- ID video trong lịch sử (30 ngày gần nhất) chỉ để chỉnh sửa các khoảng thời lượng 2–5 giây hoặc 7–10 giây liên quan đến video_url; cung cấp chính xác một ID video_url: type: string description: >- URL video: liên kết tải xuống khi tải lên; URL được trả về khi chỉnh sửa lựa chọn; chỉ hỗ trợ MP4 và MOV; thời lượng chỉ từ 2–5 giây hoặc 7–10 giây x-apifox-orders: - video_id - video_url x-apidog-orders: - video_id - video_url examples: example: value: video_id: '828013548709777428' video_url: '' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Chỉnh sửa video đa phương thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208999-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Thêm lựa chọn video" Nguồn: https://docs.openaihub.net/api-45209000/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/multi-elements/add-selection: post: summary: Thêm lựa chọn video deprecated: false description: '' operationId: post-kling-v1-videos-multi-elements-add-selection tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Chỉnh sửa video đa phương thức - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - session_id - frame_index - points properties: frame_index: type: integer description: >- chỉ số khung hình; tối đa 10 khung hình được đánh dấu; mỗi yêu cầu một dấu đánh dấu points: type: array items: type: object properties: x: type: integer description: Tọa độ X 'y': type: integer description: Tọa độ Y x-apifox-orders: - x - 'y' x-apidog-orders: - x - 'y' description: >- nhấp vào các tọa độ dưới dạng x,y trong phạm vi: [0,1], theo tỷ lệ phần trăm; [0,1]là góc trên bên trái của khung hình, cho phép nhiều điểm; tối đa 10 điểm cho mỗi khung hình session_id: type: string description: >- ID phiên từ lúc khởi tạo video; không thay đổi khi chỉnh sửa vùng chọn x-apifox-orders: - frame_index - points - session_id x-apidog-orders: - frame_index - points - session_id examples: example: value: frame_index: 1 points: - x: 0 'y': 1 session_id: '828033558945619987' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Chỉnh sửa video đa phương thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209000-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Xóa lựa chọn video" Nguồn: https://docs.openaihub.net/api-45209001/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/multi-elements/delete-selection: post: summary: Xóa lựa chọn video deprecated: false description: '' operationId: post-kling-v1-videos-multi-elements-delete-selection tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Chỉnh sửa video đa phương thức - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - session_id - frame_index - points properties: frame_index: type: integer description: >- chỉ số khung hình; tối đa 10 khung hình được đánh dấu; mỗi yêu cầu một dấu đánh dấu points: type: array items: type: object properties: x: type: integer description: Tọa độ X 'y': type: integer description: Tọa độ Y x-apifox-orders: - x - 'y' x-apidog-orders: - x - 'y' description: >- nhấp vào các tọa độ dưới dạng x,y trong phạm vi: [0,1], theo tỷ lệ phần trăm; [0,1]là góc trên bên trái của khung hình, cho phép nhiều điểm; tối đa 10 điểm cho mỗi khung hình session_id: type: string description: >- ID phiên từ lúc khởi tạo video; không thay đổi khi chỉnh sửa vùng chọn x-apifox-orders: - frame_index - points - session_id x-apidog-orders: - frame_index - points - session_id examples: example: value: frame_index: 1 points: - x: 1 'y': 0 session_id: '828033558945619987' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Chỉnh sửa video đa phương thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209001-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Xem trước video đã chọn" Nguồn: https://docs.openaihub.net/api-45209002/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/multi-elements/preview-selection: post: summary: Xem trước video đã chọn deprecated: false description: '' operationId: post-kling-v1-videos-multi-elements-preview-selection tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Chỉnh sửa video đa phương thức - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - session_id properties: session_id: type: string description: Mã phiên x-apifox-orders: - session_id x-apidog-orders: - session_id examples: example: value: session_id: '828033558945619987' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Chỉnh sửa video đa phương thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209002-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "video đa phương thức" Nguồn: https://docs.openaihub.net/api-45209003/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/multi-elements: post: summary: video đa phương thức deprecated: false description: '' operationId: post-kling-v1-videos-multi-elements tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Chỉnh sửa video đa phương thức - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model_name - session_id - edit_mode - prompt - mode - duration properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất duration: type: string description: |- Thời lượng video được tạo (giây) enum: 5, 10 edit_mode: type: string description: >- kiểu thao tác liệt kê: addition, swap, removal, trong đó: addition: thêm phần tửswap: hoán đổi phần tửremoval: xóa phần tử external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ image_list: type: array items: type: string description: >- Các mẫu lời nhắc được đề xuất. Thêm: Sử dụng ngữ cảnh của <<>>, thêm [x] từ <<>> một cách liền mạch. Hoán đổi: hoán đổi [x] từ <<>> bằng [x] từ <<>>. Xóa: Xóa [x] khỏi <<>>. Dấu ngoặc tiếng Trung / [x] tiếng Anh là các phần do người dùng điền. description: hình ảnh tham chiếu đã cắt mode: type: string description: |- Chế độ tạo video liệt kê: std, pro std: tiêu chuẩn / tiết kiệm chi phí pro: chuyên nghiệp / chất lượng cao model_name: type: string description: 'Enum tên mô hình: kling-v1-6' negative_prompt: type: string description: lời nhắc văn bản phủ định prompt: type: string description: lời nhắc văn bản tích cực session_id: type: string description: >- ID phiên từ lúc khởi tạo video; không thay đổi khi chỉnh sửa vùng chọn x-apifox-orders: - callback_url - duration - edit_mode - external_task_id - image_list - mode - model_name - negative_prompt - prompt - session_id x-apidog-orders: - callback_url - duration - edit_mode - external_task_id - image_list - mode - model_name - negative_prompt - prompt - session_id examples: example: value: callback_url: '' duration: '5' edit_mode: '' external_task_id: '' image_list: [] mode: std model_name: kling-v1-6 negative_prompt: '' prompt: '' session_id: '' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Chỉnh sửa video đa phương thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209003-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209004/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/multi-elements/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-videos-multi-elements-id tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Chỉnh sửa video đa phương thức - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Chỉnh sửa video đa phương thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209004-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "hiệu ứng video" Nguồn: https://docs.openaihub.net/api-45209005/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/effects: post: summary: hiệu ứng video deprecated: false description: '' operationId: post-kling-v1-videos-effects tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/hiệu ứng video - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - effect_scene properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất effect_scene: type: string description: tên cảnh external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ input: type: object properties: image: type: string description: một người images: type: array items: type: string description: hai người description: >- Ảnh tham chiếu (Base64 hoặc URL có thể truy cập). Cấu trúc dữ liệu gửi đi thay đổi tùy theo cảnh; xem phần thân yêu cầu của từng cảnh x-apifox-orders: - image - images x-apidog-orders: - image - images x-apifox-orders: - callback_url - effect_scene - external_task_id - input x-apidog-orders: - callback_url - effect_scene - external_task_id - input examples: example: value: effect_scene: pet_lion input: image: >- Vui lòng tải ảnh trực tiếp lên cuộc trò chuyện để tôi có thể đọc và dịch nội dung. summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/hiệu ứng video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209005-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209006/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/effects/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-videos-effects-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/hiệu ứng video - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '827575379262595082' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/hiệu ứng video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209006-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Hình ảnh" Nguồn: https://docs.openaihub.net/api-45209007/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/generations: post: summary: Hình ảnh deprecated: false description: Tạo hình ảnh dựa trên các từ trong lời nhắc bằng văn bản. operationId: kling_images_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Hình ảnh - Kling parameters: [] requestBody: content: application/json: schema: type: object required: - model_name - prompt properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' callback_url: type: string description: URL gọi lại image_fidelity: type: number description: Độ trung thực hình ảnh (cảnh chuyển từ ảnh sang ảnh) model_name: type: string enum: - kling-v1 - kling-v1-5 - kling-v2 - kling-v2-1 description: Phiên bản mô hình hình ảnh examples: - kling-v1-5 'n': type: integer description: Tạo số lượng negative_prompt: type: string description: từ gợi ý phủ định prompt: type: string description: Các từ dùng trong câu lệnh mô tả hình ảnh resolution: type: string enum: - 1k - 2k description: Độ phân giải đầu ra refName: PostKlingV1ImagesGenerationsRequest x-apifox-orders: - aspect_ratio - callback_url - image_fidelity - model_name - 'n' - negative_prompt - prompt - resolution x-apidog-orders: - aspect_ratio - callback_url - image_fidelity - model_name - 'n' - negative_prompt - prompt - resolution examples: example_single: value: aspect_ratio: '1:1' model_name: kling-v1-5 'n': 1 prompt: >- Một chú mèo mướp cam đáng yêu đang ngồi trên bậu cửa sổ, theo phong cách màu nước resolution: 1k summary: example_single description: Hình ảnh Vinh Sơn responses: '200': description: Tác vụ đã được gửi thành công content: application/json: schema: type: object properties: code: type: integer description: Mã trạng thái nghiệp vụ examples: - 0 data: type: object properties: created_at: type: integer description: Thời điểm tạo (mili giây) task_id: type: string description: ID tác vụ, được dùng để kiểm tra định kỳ task_status: type: string enum: - submitted - processing - succeed - failed description: Trạng thái tác vụ updated_at: type: integer description: Cập nhật dấu thời gian (mili giây) description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) x-apifox-orders: - created_at - task_id - task_status - updated_at x-apidog-orders: - created_at - task_id - task_status - updated_at message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. examples: - thành công request_id: type: string description: ID truy vết yêu cầu refName: KlingTaskSubmitResponse x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: created_at: 0 task_id: chuỗi task_status: đã gửi updated_at: 0 message: thành công request_id: chuỗi headers: {} x-apidog-name: Tác vụ đã được gửi 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/Kling/Hình ảnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209007-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209008/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/generations/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-images-generations-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Hình ảnh - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '825371153572732975' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Hình ảnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209008-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "phần mở rộng video" Nguồn: https://docs.openaihub.net/api-45209009/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/video-extend: post: summary: phần mở rộng video deprecated: false description: '' operationId: post-kling-v1-videos-video-extend tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Hình ảnh/phần mở rộng video - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - video_id - prompt properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất cfg_scale: type: number description: >- Phạm vi độ mạnh tham chiếu của lời nhắc [0,1]; giá trị càng cao = càng mạnh negative_prompt: type: string description: lời nhắc văn bản phủ định prompt: type: string description: Lời nhắc văn bản tích cực có tối đa 2500 ký tự video_id: type: string description: >- ID video để kéo dài (văn bản/hình ảnh/video); video gốc ≤ 3 phút x-apifox-orders: - callback_url - cfg_scale - negative_prompt - prompt - video_id x-apidog-orders: - callback_url - cfg_scale - negative_prompt - prompt - video_id examples: example: value: callback_url: '' cfg_scale: 0.5 negative_prompt: '' prompt: Kéo dài hiệu ứng hoạt hình video_id: '828006748715380777' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Hình ảnh/phần mở rộng video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209009-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209010/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/video-extend/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-videos-video-extend-id tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Hình ảnh/phần mở rộng video - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '827574871634235396' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Hình ảnh/phần mở rộng video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209010-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Nhiều hình ảnh tham khảo" Nguồn: https://docs.openaihub.net/api-45209011/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/multi-image2image: post: summary: Nhiều hình ảnh tham khảo deprecated: false description: '' operationId: post-kling-v1-images-multi-image2image tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Nhiều hình ảnh tham khảo - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model_name - subject_image_list - 'n' properties: aspect_ratio: type: string description: |- Tỷ lệ khung hình (W:H) enum: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ model_name: type: string description: 'Liệt kê tên mô hình: kling-v2, kling-v2-1' 'n': type: integer description: |- Số lượng hình ảnh cần tạo phạm vi: [1,9] prompt: type: string description: |- Lời nhắc văn bản tích cực Tối đa 2500 ký tự scene_image: type: string description: >- Hình ảnh tham chiếu của cảnh chấp nhận hình ảnh Base64 hoặc URL hình ảnh có thể truy cập được style_image: type: string description: >- Hình ảnh tham chiếu phong cách chấp nhận hình ảnh Base64 hoặc URL hình ảnh có thể truy cập được subject_image_list: type: array items: type: object required: - subject_image properties: subject_image: type: string description: Hình ảnh tham chiếu của đối tượng x-apifox-orders: - subject_image x-apidog-orders: - subject_image description: Yêu cầu từ 1–4 hình ảnh x-apifox-orders: - aspect_ratio - callback_url - external_task_id - model_name - 'n' - prompt - scene_image - style_image - subject_image_list x-apidog-orders: - aspect_ratio - callback_url - external_task_id - model_name - 'n' - prompt - scene_image - style_image - subject_image_list examples: example: value: aspect_ratio: '16:9' callback_url: '' external_task_id: '' model_name: kling-v2 'n': 1 prompt: Kết hợp dựa trên đặc điểm của hai hình ảnh scene_image: '' style_image: '' subject_image_list: - subject_image: >- Vui lòng tải hình ảnh lên trực tiếp; tôi không thể truy cập nội dung từ URL này để dịch. - subject_image: >- https://p2-fdl.klingai.com/ksc2/r4gHNdLJu7R_NKFagBrRhUo3pHsXVPKzNvpK03wlneD_9vJUZW305KBZOtLLDMPi3x_S2OA3_kElUJ9OTGiTMJEgl_JquTY_F18h_3T_bUuMAJMwv-Ab4Q0lxaqv5hkTkPf3RiMM-e8L6YDoiu_hqlEWNRoMfcF600L9QjzdeCNWHxt6l1yQHNN-2F1dlnIEEFRCUNtIYl4ld4CTrXU0zQ.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAG1PSTwbCq6_SmEkj2U-TQz3h6o_RMO0KUqJXA27NGRFxm-LmGTjaZHzO05ErU-1RdPfZjNK3M0uZQgSW8l2wVcgIou7OGlV4U0SpKzy-YxHgDwmjhlD389wl-rkRst5lcT-7rHQIBfz43n6hQpftalgQdQjzzX9Ba3mYFhNzCtRqeBJDHWZtmqR7Z_VjyVv6JuKd17mIdxVvUnUbrWebqODuRgWdconrxD-f2sXDo2JxoSbgFFnrpiqTZzapT733K7iU3CIiA53wUUSuPo6Nl3x-sMGxPpxWlgCCGZxjsdEzImNu8MQSgFMAE&x-kcdn-pid=112757&pkey=AAVbt25OjExCTX4XvCkIx0TYQ04HQw2NzKf4Lr5yxgJLFDF-iCUXHjGNnRg50Hk2CbkG5E905N4sXT4AkKNgSeYxfSs4YmmPRabsUxE-4lvP915Q3JT0nV1IvaUlXcBPwuY summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Nhiều hình ảnh tham khảo x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209011-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209012/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/multi-image2image/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-images-multi-image2image-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Nhiều hình ảnh tham khảo - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '827642130750779431' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Nhiều hình ảnh tham khảo x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209012-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "văn bản thành video" Nguồn: https://docs.openaihub.net/api-45209013/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/text-to-video/kling-3.0-turbo: post: summary: văn bản thành video deprecated: false description: '' operationId: post-kling-text-to-video-kling-3-0-turbo tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Keling 3.0turbo - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object properties: contents: type: array items: type: object required: - type - text properties: text: type: string description: >- Dịch tài liệu kỹ thuật này sang tiếng Việt. Giữ nguyên Markdown, mã, định danh, URL, đường dẫn, phần giữ chỗ, cấu trúc JSON và định dạng. Chỉ trả về văn bản đã dịch và không để lại ký tự Hán nào. Văn bản lời nhắc, tối đa 3072 ký tự. type: type: string description: >- Kiểu của text-to-video phải là "prompt"; "first_frame" trả về mã lỗi 400. x-apifox-orders: - text - type x-apidog-orders: - text - type description: >- [Thay thế] Dạng mảng prompt, loại trừ lẫn nhau với prompt cấp cao nhất. Loại của từng mục phải là "prompt" (chuyển văn bản thành video không hỗ trợ first_frame). Gateway trích xuất contents[].text vào prompt cấp cao nhất rồi chuyển tiếp đến dịch vụ thượng nguồn. options: type: object properties: callback_url: type: string format: uri description: >- URL callback ngược dòng sau khi tác vụ hoàn tất (phải có thể truy cập công khai). external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài do bên gọi xác định, dùng cho các truy vấn có tính lũy đẳng và việc đối soát. watermark_info: type: object description: >- Cấu hình hình mờ do hệ thống nguồn xác định, được chuyển tiếp nguyên trạng. x-apidog-orders: [] description: Các tham số điều khiển tác vụ, tất cả đều không bắt buộc. x-apifox-orders: - callback_url - external_task_id - watermark_info x-apidog-orders: - callback_url - external_task_id - watermark_info prompt: type: string description: >- [Khuyến nghị] Lời nhắc cấp cao nhất. Tối đa 3072 ký tự. Dấu câu toàn chiều rộng (, ; : ) được cổng tự động chuyển đổi thành dạng nửa chiều rộng. Loại trừ lẫn nhau với contents[]; nếu cả hai đều được thiết lập, contents[] sẽ bị bỏ qua. settings: type: object properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' enumDetails: - value: '16:9' displayName: Khung ngang 16:9 description: Mặc định; dành cho chế độ ngang / máy tính để bàn - value: '9:16' displayName: Chân dung 9:16 description: >- dành cho video ngắn / chế độ dọc trên thiết bị di động - value: '1:1' displayName: hình vuông 1:1 description: dành cho ảnh bìa vuông trên mạng xã hội description: Tỷ lệ khung hình, mặc định là 16:9. duration: type: integer description: >- Thời lượng video (giây), trong khoảng 3–15, mặc định là 5. Chi phí được tính tăng tuyến tính theo thời lượng. resolution: type: string enum: - 720p - 1080p enumDetails: - value: 720p displayName: SD 720p description: Mặc định; hệ số nhân thanh toán cơ sở - value: 1080p displayName: HD 1080p description: Chi phí ~1.5×, chất lượng cao hơn description: >- Độ phân giải đầu ra, mặc định là 720p. 1080p được tính phí ~1,25×. description: >- Các tham số tạo, tất cả đều không bắt buộc. Giá trị mặc định của Gateway khi bị thiếu: resolution=720p, aspect_ratio=16:9, duration=5. x-apifox-orders: - aspect_ratio - duration - resolution x-apidog-orders: - aspect_ratio - duration - resolution description: >- Phần thân Kling 3.0 Turbo T2V. Cung cấp lời nhắc qua `prompt` cấp cao nhất hoặc `contents[]`; `prompt` cấp cao nhất được ưu tiên. x-apifox-orders: - contents - options - prompt - settings x-apidog-orders: - contents - options - prompt - settings examples: '1': value: contents: - text: Một con mèo đang chạy type: prompt settings: duration: 5 resolution: 720p summary: '1' '2': value: prompt: >- Người phụ nữ trẻ đang đi bộ trên con phố Tokyo rực sáng ánh đèn neon vào ban đêm, chuyển động chậm settings: aspect_ratio: '9:16' duration: 5 resolution: 720p summary: '2' '3': value: prompt: >- Cà phê đang được rót vào một chiếc cốc thủy tinh, cảnh quay cận cảnh, tông màu ấm settings: aspect_ratio: '1:1' duration: 5 resolution: 720p summary: '3' '4': value: prompt: >- Toàn cảnh hùng vĩ từ trên cao của dãy núi Trương Gia Giới nhô lên giữa biển mây, vào giờ vàng, cảnh quay điện ảnh bằng thiết bị bay không người lái settings: aspect_ratio: '16:9' duration: 10 resolution: 1080p summary: '4' '5': value: prompt: >- Người mẫu thời trang sải bước trên sàn diễn, ánh sáng biến đổi linh hoạt, phong cách biên tập thời trang cao cấp settings: aspect_ratio: '9:16' duration: 15 resolution: 1080p summary: '5' '6': value: contents: - text: >- Lá thu rơi trong một khu vườn Nhật Bản, bóng phản chiếu trên hồ cá koi, bầu không khí yên bình type: prompt options: callback_url: https://your-server.com/webhook/kling external_task_id: biz-order-20240623-001 settings: aspect_ratio: '16:9' duration: 8 resolution: 720p summary: '6' '7': value: prompt: >- Cảnh 1,2,một phụ nữ trẻ đứng bên cửa sổ nhìn ra ngoài, ánh sáng ban mai lọt vào;Cảnh 2,3,cô ấy quay lại với nụ cười, tay cầm tách cà phê;Cảnh 3,5,cô ấy bước ra ban công, đường chân trời thành phố ở phía sau, giờ vàng; settings: aspect_ratio: '16:9' duration: 10 resolution: 1080p summary: '7' responses: '200': description: '' content: application/json: schema: type: object required: - code - message - data properties: code: type: integer description: 0 = thành công; khác 0 = thất bại; xem thông báo data: type: object properties: id: type: string description: ID tác vụ (ưu tiên) status: type: string description: 'Trạng thái tác vụ ban đầu, ví dụ: đã gửi / đang chờ' task_id: type: string description: >- ID tác vụ (dự phòng; một số hệ thống nguồn trả về trường này) task_status: type: string description: >- Giống như trạng thái; tên trường thay đổi tùy theo nguồn cung cấp phía trên description: >- Thông tin tác vụ. Cả `id` và `task_id` đều có thể chứa mã tác vụ; ưu tiên `id`. x-apifox-orders: - id - status - task_id - task_status x-apidog-orders: - id - status - task_id - task_status message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. request_id: type: string description: >- ID yêu cầu phía thượng nguồn; cung cấp cho bộ phận hỗ trợ phía thượng nguồn khi khắc phục sự cố x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: id: string status: string task_id: chuỗi task_status: chuỗi message: chuỗi headers: {} x-apidog-name: '' '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/Kling/Keling 3.0turbo x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209013-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "ảnh-thành-video" Nguồn: https://docs.openaihub.net/api-45209014/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/image-to-video/kling-3.0-turbo: post: summary: ảnh-thành-video deprecated: false description: '' operationId: post-kling-image-to-video-kling-3-0-turbo tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Keling 3.0turbo - kling parameters: [] requestBody: content: application/json: schema: type: object required: - contents properties: contents: type: array items: oneOf: - type: object required: - type - url properties: type: type: string description: Kiểu url: type: string format: uri description: >- URL hình ảnh khung hình đầu tiên có thể truy cập công khai. Nguồn đầu vào: jpg/jpeg/png (không hỗ trợ webp); ≤50MB; mỗi cạnh ≥300px; tỷ lệ khung hình từ 1:2.5 đến 2.5:1, nếu không nguồn đầu vào sẽ báo lỗi. description: >- hình ảnh khung hình đầu tiên (yêu cầu ít nhất một hình) x-apifox-orders: - type - url x-apidog-orders: - type - url - type: object required: - type - text properties: text: type: string description: >- Văn bản lời nhắc, tối đa 2500 ký tự (giới hạn I2V; thấp hơn mức 3072 của T2V). type: type: string description: Kiểu description: lời nhắc văn bản (không bắt buộc, tối đa một lời nhắc) x-apifox-orders: - text - type x-apidog-orders: - text - type description: >- Mảng `Content`, bắt buộc. Quy tắc: (1) ≥1 phần tử có `type=first_frame` và `url`; (2) có thể có `type=prompt` (`text` ≤2500); (3) `type` chỉ được là `prompt` hoặc `first_frame`, nếu không sẽ trả về 400. options: type: object properties: callback_url: type: string format: uri description: URL gọi lại của hệ thống nguồn sau khi tác vụ hoàn tất. external_task_id: type: string description: >- ID tác vụ bên ngoài do bên gọi xác định dành cho các truy vấn bảo đảm không tạo hiệu ứng bổ sung khi lặp lại. watermark_info: type: object description: Cấu hình hình chìm, được chuyển tiếp nguyên trạng. x-apidog-orders: [] description: Các tham số điều khiển tác vụ, tất cả đều không bắt buộc. x-apifox-orders: - callback_url - external_task_id - watermark_info x-apidog-orders: - callback_url - external_task_id - watermark_info settings: type: object properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' enumDetails: - value: '16:9' displayName: Khung ngang 16:9 description: >- bị phía thượng nguồn bỏ qua; được dùng làm tham chiếu thanh toán - value: '9:16' displayName: Chân dung 9:16 description: >- bị phía thượng nguồn bỏ qua; được dùng làm tham chiếu thanh toán - value: '1:1' displayName: hình vuông 1:1 description: >- bị phía thượng nguồn bỏ qua; được dùng làm tham chiếu thanh toán description: >- Tỷ lệ khung hình. Cảnh báo: theo quy định chính thức, I2V sử dụng tỷ lệ khung hình của khung hình đầu tiên nên hệ thống thượng nguồn bỏ qua giá trị này; cổng kết nối vẫn sử dụng giá trị đó để tính phí — hãy đặt trùng với khung hình đầu tiên hoặc bỏ qua. duration: type: integer description: >- Thời lượng video (giây), trong khoảng 3–15. Chi phí được tính tỷ lệ thuận theo thời lượng. resolution: type: string enum: - 720p - 1080p enumDetails: - value: 720p displayName: SD 720p description: hệ số nhân tính phí cơ sở - value: 1080p displayName: HD 1080p description: Thanh toán ~1,5 lần description: Độ phân giải đầu ra. 1080p tính phí khoảng 1,5×. description: >- Các tham số tạo sinh, tất cả đều không bắt buộc. Cảnh báo: phần thân I2V được chuyển tiếp nguyên trạng; các thiết lập bị thiếu sẽ không được đặt giá trị mặc định — hãy thiết lập chúng một cách rõ ràng. x-apifox-orders: - aspect_ratio - duration - resolution x-apidog-orders: - aspect_ratio - duration - resolution description: >- Phần thân Kling 3.0 Turbo I2V. Bắt buộc có `contents` với ít nhất 1 mục `type=first_frame`. Phần thân được chuyển tiếp nguyên trạng; `settings` không có giá trị mặc định (phải đặt rõ ràng). x-apifox-orders: - contents - options - settings x-apidog-orders: - contents - options - settings examples: '1': value: contents: - type: first_frame url: https://example.com/first-frame.jpg settings: aspect_ratio: '16:9' duration: 5 resolution: 720p summary: '1' '2': value: contents: - type: first_frame url: https://example.com/first-frame.jpg - text: >- Nhân vật từ từ quay lại và vẫy tay, ánh sáng tự nhiên dịu nhẹ, chuyển động máy quay mượt mà type: prompt settings: aspect_ratio: '16:9' duration: 5 resolution: 720p summary: '2' '3': value: contents: - type: first_frame url: https://example.com/first-frame.jpg settings: aspect_ratio: '9:16' duration: 5 resolution: 720p summary: '3' '4': value: contents: - type: first_frame url: https://example.com/first-frame.jpg - text: >- Máy quay từ từ phóng to, chủ thể mỉm cười nhẹ nhàng, gió khẽ thổi tóc bay type: prompt settings: aspect_ratio: '16:9' duration: 5 resolution: 1080p summary: '4' '5': value: contents: - type: first_frame url: https://example.com/first-frame.jpg - text: >- Nhân vật tự tin bước về phía trước, hậu cảnh nhòe chuyển động, phong cách điện ảnh type: prompt options: callback_url: https://your-server.com/webhook/kling external_task_id: biz-img2v-20240623-001 settings: aspect_ratio: '9:16' duration: 10 resolution: 1080p summary: '5' '6': value: contents: - type: first_frame url: https://example.com/first-frame.jpg - text: >- Những cánh hoa nhẹ nhàng đung đưa, nền hiệu ứng bokeh lung linh, bầu không khí mơ màng type: prompt settings: aspect_ratio: '1:1' duration: 5 resolution: 720p summary: '6' responses: '200': description: '' content: application/json: schema: type: object required: - code - message - data properties: code: type: integer description: 0 = thành công; khác 0 = thất bại; xem thông báo data: type: object properties: id: type: string description: ID tác vụ (ưu tiên) status: type: string description: 'Trạng thái tác vụ ban đầu, ví dụ: đã gửi / đang chờ' task_id: type: string description: >- ID tác vụ (dự phòng; một số hệ thống nguồn trả về trường này) task_status: type: string description: >- Giống như trạng thái; tên trường thay đổi tùy theo nguồn cung cấp phía trên description: >- Thông tin tác vụ. Cả `id` và `task_id` đều có thể chứa mã tác vụ; ưu tiên `id`. x-apifox-orders: - id - status - task_id - task_status x-apidog-orders: - id - status - task_id - task_status message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. request_id: type: string description: >- ID yêu cầu phía thượng nguồn; cung cấp cho bộ phận hỗ trợ phía thượng nguồn khi khắc phục sự cố x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: id: string status: string task_id: chuỗi task_status: chuỗi message: chuỗi headers: {} x-apidog-name: '' '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/Kling/Keling 3.0turbo x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209014-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn video" Nguồn: https://docs.openaihub.net/api-45209015/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/text-to-video/kling-3.0-turbo/{task_id}: get: summary: Truy vấn video deprecated: false description: >- | Đường dẫn | `GET /kling/text-to-video/kling-3.0-turbo/{task_id}` | | Điều kiện tiên quyết | `{{task_id}}` được lấy từ `data.id` trong phản hồi gửi tác vụ | | Mô tả | Video từ ảnh đã thay đổi đường dẫn thành `/kling/image-to-video/kling-3.0-turbo/{{task_id}}` | operationId: get-kling-text-to-video-kling-3-0-turbo-task-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Keling 3.0turbo - kling parameters: - name: task_id in: path description: ID tác vụ bất đồng bộ required: true example: '' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: string examples: example: summary: example value: chuỗi headers: {} x-apidog-name: '' '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/Kling/Keling 3.0turbo x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209015-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Omni-Video" Nguồn: https://docs.openaihub.net/api-45209016/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/omni-video: post: summary: Omni-Video deprecated: false description: >- Tạo video hợp nhất với Kling Omni: chuyển văn bản thành video, tham chiếu hình ảnh, khung hình đầu/cuối, chỉnh sửa video, tham chiếu chủ thể và nhiều cảnh quay. operationId: kling_omni_video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Omni-Video - Kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model_name properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' enumDetails: - value: '16:9' displayName: Toàn cảnh - value: '9:16' displayName: Chân dung - value: '1:1' displayName: Hình vuông description: >- Tỉ lệ khung hình. Nên đặt trường này là bắt buộc khi không sử dụng khung hình đầu tiên và không dùng cho việc chỉnh sửa video. callback_url: type: string format: uri description: >- Địa chỉ gọi lại khi hoàn thành tác vụ phải có thể truy cập được qua mạng công cộng duration: oneOf: - type: string - type: integer description: >- Thời lượng video (giây). o1: 5/10; v3-omni: 3~15; khi refer_type=base, thông số này được xác định qua quá trình phát hiện video và không cần được truyền. element_list: type: array items: type: object required: - element_id properties: element_id: oneOf: - type: string - type: integer description: ID principal, từ giao diện tạo principal x-apifox-orders: - element_id x-apidog-orders: - element_id description: Danh sách tài liệu tham khảo theo chủ đề. external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài của bên gọi, được dùng để đối chiếu nghiệp vụ image_list: type: array items: type: object properties: image_url: type: string description: URL hình ảnh hoặc Base64 type: type: string enum: - first_frame - end_frame enumDetails: - value: first_frame displayName: Khung hình đầu tiên description: Khung hình bắt đầu video - value: end_frame displayName: Khung hình cuối description: Phải được ghép cặp với first_frame description: >- Loại khung hình đầu và cuối. Phải có first_frame nếu có end_frame. x-apifox-orders: - image_url - type x-apidog-orders: - image_url - type description: >- Danh sách hình ảnh tham chiếu. Được dùng để tham chiếu chủ thể/khung cảnh/phong cách hoặc làm khung hình đầu và cuối. mode: type: string enum: - std - pro - 4k enumDetails: - value: std displayName: Tiêu chuẩn - value: chuyên nghiệp displayName: Chất lượng cao description: Cổng mặc định - value: 4k displayName: 4K description: kling-v3-omni only description: >- Tạo lược đồ. Cổng mặc định là pro; chỉ kling-v3-omni hỗ trợ 4k. model_name: type: string enum: - kling-video-o1 - kling-v3-omni enumDetails: - value: kling-video-o1 displayName: Video O1 description: Omni tiêu chuẩn; thời lượng chỉ là 5/10 giây - value: kling-v3-omni displayName: V3 Toàn năng description: Hỗ trợ âm thanh, 4k, multi_shot; thời lượng 3–15 giây description: >- Tên mô hình Omni, bắt buộc. o1 không hỗ trợ sound/4k/multi_shot; v3-omni có đầy đủ chức năng. multi_prompt: type: array items: type: object required: - index - prompt - duration properties: duration: oneOf: - type: string - type: number - type: integer description: Thời lượng của bảng phân cảnh (giây), ≥1 index: type: integer description: Số thứ tự bảng phân cảnh, bắt đầu từ 1 prompt: type: string description: Nội dung nhắc tạo bảng phân cảnh, ≤512 ký tự x-apifox-orders: - duration - index - prompt x-apidog-orders: - duration - index - prompt description: >- Danh sách bảng phân cảnh tùy chỉnh. Bắt buộc khi shot_type=customize, tối đa 6 cảnh quay. multi_shot: type: boolean description: >- Có sử dụng nhiều ống kính hay không, mặc định là false. Chỉ kling-v3-omni mới có thể là true. prompt: type: string description: >- Từ nhắc văn bản, ≤2500 ký tự. Bắt buộc khi `multi_shot=false`; không hợp lệ khi `multi_shot=true`. shot_type: type: string enum: - customize enumDetails: - value: tùy chỉnh displayName: Ảnh chụp tùy chỉnh description: >- Yêu cầu multi_prompt; tổng thời lượng của các cảnh quay bằng thời lượng cấp cao nhất description: >- Phương pháp lập bảng phân cảnh. Bắt buộc khi multi_shot=true; customize phải khớp với multi_prompt. sound: type: string enum: - 'on' - 'off' enumDetails: - value: bật displayName: Bật âm thanh description: Chỉ dành cho v3-omni - value: tắt displayName: Lên tiếng description: Mặc định không hiển thị thông báo description: >- Chuyển đổi có âm thanh. Chỉ bật trên kling-v3-omni; truyền giá trị bật từ o1 sẽ dẫn đến lỗi 400. video_list: type: array items: type: object required: - video_url - refer_type properties: keep_original_sound: type: string enum: - 'yes' - 'no' enumDetails: - value: có displayName: Giữ - value: không displayName: Không giữ lại description: Có giữ lại âm thanh gốc của video hay không refer_type: type: string enum: - feature - base enumDetails: - value: tính năng displayName: Tham khảo tính năng description: Không thể sử dụng cùng với sound=on (v3-omni) - value: cơ sở displayName: Để chỉnh sửa description: >- duration bị bỏ qua; được thay thế bằng độ dài video description: >- feature=tham chieu tinh nang; base=chinh sua video (thoi luong duoc xac dinh boi viec phat hien video). video_url: type: string description: URL video tham khảo, có thể truy cập từ mạng công cộng x-apifox-orders: - keep_original_sound - refer_type - video_url x-apidog-orders: - keep_original_sound - refer_type - video_url description: Danh sách video tham khảo, tối đa 1. watermark_info: type: object properties: enabled: type: boolean description: true tạo ra các kết quả có hình mờ description: Cấu hình hình mờ, truyền trong suốt qua cổng x-apifox-orders: - enabled x-apidog-orders: - enabled refName: PostKlingV1VideosOmniVideoRequest x-apifox-orders: - aspect_ratio - callback_url - duration - element_list - external_task_id - image_list - mode - model_name - multi_prompt - multi_shot - prompt - shot_type - sound - video_list - watermark_info x-apidog-orders: - aspect_ratio - callback_url - duration - element_list - external_task_id - image_list - mode - model_name - multi_prompt - multi_shot - prompt - shot_type - sound - video_list - watermark_info examples: '1': value: aspect_ratio: '16:9' duration: '5' mode: chuyên nghiệp model_name: kling-video-o1 multi_shot: false prompt: >- Một cảnh quay từ trên không đậm chất điện ảnh trên hồ miền núi phủ sương vào lúc bình minh summary: '1' description: >- Khuyến nghị cho người mới: Video Omni Vincent · Quy trình gửi tối thiểu khả dụng (o1) '2': value: aspect_ratio: '16:9' duration: '5' image_list: - image_url: '{{image_url_1}}' - image_url: '{{image_url_2}}' mode: chuyên nghiệp model_name: kling-video-o1 multi_shot: false prompt: >- Nhân vật bước qua một con hẻm rực ánh đèn neon, theo phong cách cyberpunk summary: '2' description: 'Khuyến nghị cho người mới: Video Omni Mat Tusheng · image_list' '3': value: duration: '5' image_list: - image_url: https://example.com/first-frame.jpg type: first_frame - image_url: '{{end_frame_url}}' type: end_frame mode: chuyên nghiệp model_name: kling-video-o1 multi_shot: false prompt: >- Chuyển cảnh mượt mà từ ban ngày sang ban đêm trên cùng một con phố summary: '3' description: >- Khuyến nghị cho người mới bắt đầu: Khung hình đầu và cuối Omni · first_frame + end_frame '4': value: aspect_ratio: '16:9' duration: 8 mode: chuyên nghiệp model_name: kling-v3-omni multi_shot: false prompt: Một ban nhạc jazz biểu diễn ở góc phố dưới trời mưa sound: bật summary: '4' description: >- Khuyên dùng cho người mới bắt đầu: Omni V3 có âm thanh · sound=on '5': value: mode: chuyên nghiệp model_name: kling-v3-omni multi_shot: false prompt: Thay nền bằng đường chân trời của một thành phố tương lai video_list: - keep_original_sound: không refer_type: cơ sở video_url: '{{video_url}}' summary: '5' description: 'Đề xuất nâng cao: Chỉnh sửa video Omni · refer_type=base' '6': value: aspect_ratio: '16:9' duration: '10' mode: chuyên nghiệp model_name: kling-video-o1 multi_shot: false prompt: >- Một vũ công mô phỏng phong cách chuyển động của video tham chiếu video_list: - keep_original_sound: có refer_type: tính năng video_url: '{{ref_video_url}}' summary: '6' description: >- Đề xuất nâng cao: Tài liệu tham khảo tính năng video Omni · refer_type=feature '7': value: aspect_ratio: '1:1' duration: 6 element_list: - element_id: '{{element_id}}' mode: chuyên nghiệp model_name: kling-v3-omni multi_shot: false prompt: >- Đối tượng bước vào một studio ngập tràn ánh nắng và vẫy tay trước máy quay summary: '7' description: 'Khuyến nghị nâng cao: Tham chiếu body Omni · element_list' '8': value: aspect_ratio: '16:9' mode: chuyên nghiệp model_name: kling-v3-omni multi_prompt: - duration: '3' index: 1 prompt: Cảnh toàn của một sân ga tàu hỏa vắng người - duration: '4' index: 2 prompt: Tàu đến, cửa mở, hành khách xuống tàu - duration: '3' index: 3 prompt: Cận cảnh một tấm vé bay phấp phới trong gió multi_shot: true shot_type: tùy chỉnh summary: '8' description: 'Đề xuất nâng cao: Tùy chỉnh đa ống kính Omni V3' '9': value: aspect_ratio: '9:16' callback_url: https://example.com/callback duration: 5 external_task_id: '{{external_task_id}}' mode: chuyên nghiệp model_name: kling-v3-omni multi_shot: false prompt: Sản phẩm trưng bày xoay trên một bục trắng tinh summary: '9' description: 'Khuyến nghị nâng cao: callback Omni và external_task_id' responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Omni-Video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209016-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209017/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/omni-video/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-videos-omni-video-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Omni-Video - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Omni-Video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209017-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Mở rộng hình ảnh" Nguồn: https://docs.openaihub.net/api-45209018/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/editing/expand: post: summary: Mở rộng hình ảnh deprecated: false description: '' operationId: post-kling-v1-images-editing-expand tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Mở rộng hình ảnh - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - image - up_expansion_ratio - down_expansion_ratio - left_expansion_ratio - 'n' - right_expansion_ratio properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất down_expansion_ratio: type: number description: >- Mở rộng xuống dưới; hệ số nhân của chiều cao ban đầu phạm vi: [0,2], diện tích ảnh mới không được vượt quá 3× diện tích ban đầu ví dụ: nếu chiều cao ban đầu là20 và tham số này là0.2, thì: khoảng cách từ đáy ban đầu đến đáy mới =20 x 0.2 = 4, vùng đó là vùng mở rộng external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ image: type: string description: >- Hình ảnh tham chiếu chấp nhận hình ảnh được mã hóa Base64 hoặc URL hình ảnh có thể truy cập được left_expansion_ratio: type: number description: >- Mở rộng sang trái; hệ số nhân của chiều rộng ban đầu phạm vi: [0,2], diện tích ảnh mới không được vượt quá 3 lần diện tích ban đầu ví dụ: nếu chiều rộng ban đầu là 30 và tham số này là 0.3, thì: khoảng cách từ mép trái ban đầu đến mép trái mới = 30 x 0.3 = 9, vùng đó là vùng mở rộng 'n': type: integer description: |- Số lượng hình ảnh cần tạo phạm vi: [1,9] prompt: type: string description: |- Lời nhắc văn bản tích cực Tối đa 2500 ký tự right_expansion_ratio: type: number description: >- Mở rộng sang phải; hệ số nhân của chiều rộng ban đầu phạm vi: [0,2], diện tích ảnh mới không được vượt quá 3 lần diện tích ban đầu ví dụ: nếu chiều rộng ban đầu là 30 và tham số này là 0.4, thì: khoảng cách từ cạnh phải ban đầu đến cạnh phải mới = 30 x 0.4 = 12, vùng đó là vùng mở rộng up_expansion_ratio: type: number description: >- Mở rộng lên trên; hệ số nhân của chiều cao ban đầu phạm vi: [0,2], diện tích ảnh mới không được vượt quá 3 lần diện tích ban đầu ví dụ: nếu chiều cao ban đầu là 20 và tham số này là 0.1, thì: khoảng cách từ mép trên ban đầu đến mép trên mới = 20 x 0.1 = 2, vùng đó là khu vực mở rộng x-apifox-orders: - callback_url - down_expansion_ratio - external_task_id - image - left_expansion_ratio - 'n' - prompt - right_expansion_ratio - up_expansion_ratio x-apidog-orders: - callback_url - down_expansion_ratio - external_task_id - image - left_expansion_ratio - 'n' - prompt - right_expansion_ratio - up_expansion_ratio examples: example: value: callback_url: '' down_expansion_ratio: 0.1 external_task_id: '' image: >- https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg left_expansion_ratio: 0.1 'n': 1 prompt: Trung tâm lấy nét right_expansion_ratio: 0.1 up_expansion_ratio: 0.1 summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Mở rộng hình ảnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209018-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209019/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/editing/expand/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-images-editing-expand-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Mở rộng hình ảnh - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '827641776017661956' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Mở rộng hình ảnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209019-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "nhận dạng hình ảnh" Nguồn: https://docs.openaihub.net/api-45209020/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/image-recognize: post: summary: nhận dạng hình ảnh deprecated: false description: '' operationId: post-kling-v1-videos-image-recognize tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/nhận dạng hình ảnh - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - image properties: image: type: string description: >- Hình ảnh cần nhận dạng. Dữ liệu Base64 hoặc URL có thể truy cập; .jpg/.jpeg/.png; tối đa 10MB; cạnh ngắn nhất 300px; tỷ lệ khung hình 1:2.5–2.5:1 x-apifox-orders: - image x-apidog-orders: - image examples: example: value: image: >- https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/nhận dạng hình ảnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209020-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "con người kỹ thuật số" Nguồn: https://docs.openaihub.net/api-45209021/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/avatar/image2video: post: summary: con người kỹ thuật số deprecated: false description: '' operationId: post-kling-v1-videos-avatar-image2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/con người kỹ thuật số - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - image - audio_id - sound_file - prompt - mode - callback_url - external_task_id properties: audio_id: type: string description: >- ID âm thanh từ API xem trước. Chỉ âm thanh trong 30 ngày gần nhất, có thời lượng 2–300 giây. Phải có chính xác một trong hai: audio_id hoặc sound_file callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ image: type: string description: >- Hình ảnh tham chiếu của người kỹ thuật số. Base64 hoặc URL có thể truy cập; .jpg/.jpeg/.png; tối đa 10MB; cạnh tối thiểu 300px; tỷ lệ khung hình 1:2.5–2.5:1 mode: type: string description: chế độ tạo video prompt: type: string description: lời nhắc văn bản tích cực sound_file: type: string description: >- Tệp âm thanh. Dữ liệu Base64 hoặc URL có thể truy cập; .mp3/.wav/.m4a/.aac; ≤5MB; thời lượng 2–300 giây. Chỉ được cung cấp chính xác một trong hai trường audio_id hoặc sound_file. Định dạng/kích thước không hợp lệ hoặc vấn đề về nội dung sẽ trả về lỗi x-apifox-orders: - audio_id - callback_url - external_task_id - image - mode - prompt - sound_file x-apidog-orders: - audio_id - callback_url - external_task_id - image - mode - prompt - sound_file examples: example: value: audio_id: '825455158141661278' callback_url: '' external_task_id: '' image: >- https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg mode: std prompt: '' sound_file: '' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/con người kỹ thuật số x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209021-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209022/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/avatar/image2video/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-videos-avatar-image2video-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/con người kỹ thuật số - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '825470997289144397' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/con người kỹ thuật số x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209022-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Văn bản thành âm thanh" Nguồn: https://docs.openaihub.net/api-45209023/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/audio/text-to-audio: post: summary: Văn bản thành âm thanh deprecated: false description: '' operationId: kling_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Văn bản thành âm thanh - Kling parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - duration properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất duration: type: string description: >- Thời lượng âm thanh tính bằng giây; phạm vi 3.0–10.0, hỗ trợ một chữ số thập phân external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ prompt: type: string description: Lời nhắc văn bản x-apifox-orders: - callback_url - duration - external_task_id - prompt x-apidog-orders: - callback_url - duration - external_task_id - prompt examples: example: value: callback_url: '' duration: '5' external_task_id: '' prompt: Âm thanh mô tả phong cảnh summary: example responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: Được '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/Kling/Văn bản thành âm thanh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209023-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209024/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/audio/text-to-audio/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-audio-text-to-audio-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Văn bản thành âm thanh - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '825451760445050918' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Văn bản thành âm thanh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209024-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Video sang âm thanh" Nguồn: https://docs.openaihub.net/api-45209025/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/audio/video-to-audio: post: summary: Video sang âm thanh deprecated: false description: '' operationId: post-kling-v1-audio-video-to-audio tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Video sang âm thanh - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object properties: asmr_mode: type: boolean description: >- Chế độ ASMR; tăng cường hiệu ứng âm thanh chi tiết cho các cảnh sống động. true=bật, false=tắt (mặc định) bgm_prompt: type: string description: Câu lệnh tạo BGM callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ sound_effect_prompt: type: string description: Lời nhắc tạo hiệu ứng âm thanh video_id: type: string description: >- ID của video do Kling AI tạo, chỉ áp dụng cho các video trong 30 ngày gần nhất có thời lượng 3.0–20.0 giây video_url: type: string description: >- URL của video đã tải lên. Chỉ cung cấp chính xác một trong hai giá trị này hoặc `video_id`. Định dạng video chỉ hỗ trợ MP4/MOV, kích thước tệp ≤100M, thời lượng video từ 3.0 đến 20.0 giây. x-apifox-orders: - asmr_mode - bgm_prompt - callback_url - external_task_id - sound_effect_prompt - video_id - video_url x-apidog-orders: - asmr_mode - bgm_prompt - callback_url - external_task_id - sound_effect_prompt - video_id - video_url examples: example: value: asmr_mode: false bgm_prompt: '' callback_url: '' external_task_id: '' sound_effect_prompt: Giọng nói của người phù hợp với video video_id: '825406034503692376' video_url: '' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Video sang âm thanh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209025-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209026/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/audio/video-to-audio/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-audio-video-to-audio-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Video sang âm thanh - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '825470612390449223' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Video sang âm thanh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209026-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tổng hợp giọng nói" Nguồn: https://docs.openaihub.net/api-45209027/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/audio/tts: post: summary: Tổng hợp giọng nói deprecated: false description: '' operationId: post-kling-v1-audio-tts tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Tổng hợp giọng nói - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - text - voice_id - voice_language properties: text: type: string description: >- Kịch bản cho âm thanh tổng hợp; độ dài tối đa 1000; văn bản quá dài sẽ gây lỗi; hệ thống xác thực nội dung voice_id: type: string description: >- ID giọng nói: có nhiều giọng nói hệ thống, xem bảng ánh xạ hiệu ứng giọng nói / ID / ngôn ngữ; tính năng nghe thử giọng nói không hỗ trợ văn bản tùy chỉnh tên tệp nghe thử: name#id#language TTS hiện chỉ hỗ trợ giọng nói chính thức, không hỗ trợ giọng nói tùy chỉnh voice_language: type: string description: >- Kịch bản cho âm thanh tổng hợp; độ dài tối đa 1000; văn bản quá dài sẽ gây lỗi; hệ thống xác thực nội dung voice_speed: type: number description: >- Tốc độ nói 0.8–2.0, 1 chữ số thập phân; các giá trị ngoài phạm vi được làm tròn x-apifox-orders: - text - voice_id - voice_language - voice_speed x-apidog-orders: - text - voice_id - voice_language - voice_speed examples: example: value: text: Mô tả hình ảnh nhìn thấy voice_id: genshin_vindi2 voice_language: zh voice_speed: 1 summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Tổng hợp giọng nói x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209027-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Thử đồ ảo" Nguồn: https://docs.openaihub.net/api-45209028/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/kolors-virtual-try-on: post: summary: Thử đồ ảo deprecated: false description: '' operationId: post-kling-v1-images-kolors-virtual-try-on tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Thử đồ ảo - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - human_image - cloth_image - model_name properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất cloth_image: type: string description: hình ảnh trang phục dùng để thử đồ ảo human_image: type: string description: >- ảnh người đã tải lên;chấp nhận ảnh Base64 hoặc URL ảnh có thể truy cập;định dạng ảnh được hỗ trợ.jpg / .jpeg / .png;kích thước tệp ảnh không được vượt quá10MB, chiều rộng/chiều cao ảnh phải ít nhất300px model_name: type: string description: >- Liệt kê tên mô hình: kolors-virtual-try-on-v1, kolors-virtual-try-on-v1-5 x-apifox-orders: - callback_url - cloth_image - human_image - model_name x-apidog-orders: - callback_url - cloth_image - human_image - model_name examples: example: value: callback_url: '' cloth_image: >- Vui lòng tải ảnh trực tiếp lên cuộc trò chuyện để tôi có thể đọc và dịch tài liệu, đồng thời giữ nguyên Markdown, mã, định danh, URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON và định dạng. human_image: >- https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg model_name: kolors-virtual-try-on-v1 summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Thử đồ ảo x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209028-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209029/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/images/kolors-virtual-try-on/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-images-kolors-virtual-try-on-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Thử đồ ảo - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '' schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Thử đồ ảo x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209029-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "nhận dạng khuôn mặt" Nguồn: https://docs.openaihub.net/api-45209030/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/identify-face: post: summary: nhận dạng khuôn mặt deprecated: false description: '' operationId: post-kling-v1-videos-identify-face tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/đồng bộ chuyển động môi - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object properties: video_id: type: string description: >- ID video Kling AI dùng để đồng bộ khẩu hình. Chỉ được cung cấp một trong hai trường này hoặc video_url. Chỉ hỗ trợ video trong 30 ngày gần đây và có thời lượng ≤60 giây video_url: type: string description: >- URL video đã tải lên để đủ điều kiện đồng bộ khẩu hình. Chỉ được cung cấp một trong hai trường này hoặc video_id. Định dạng .mp4/.mov; dung lượng ≤100MB; thời lượng 2–60 giây; độ phân giải 720p/1080p; các cạnh 512–2160px. Nếu xác thực không thành công, hệ thống sẽ trả về lỗi; nội dung được xác thực x-apifox-orders: - video_id - video_url x-apidog-orders: - video_id - video_url examples: example: value: video_id: '827297867148050499' video_url: '' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/đồng bộ chuyển động môi x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209030-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "đồng bộ chuyển động môi" Nguồn: https://docs.openaihub.net/api-45209031/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/advanced-lip-sync: post: summary: đồng bộ chuyển động môi deprecated: false description: '' operationId: post-kling-v1-videos-advanced-lip-sync tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/đồng bộ chuyển động môi - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - session_id - face_choose properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ face_choose: type: array items: type: object required: - face_id - sound_start_time - sound_end_time - sound_insert_time - sound_volume - original_audio_volume properties: audio_id: type: string description: >- ID âm thanh từ API xem trước. Chỉ âm thanh trong 30 ngày gần nhất có thời lượng 2–60 giây. Phải có chính xác một trong hai trường audio_id hoặc sound_file face_id: type: string description: ID khuôn mặt do API nhận diện khuôn mặt trả về original_audio_volume: type: integer description: >- Âm lượng video gốc; giá trị cao hơn = âm thanh lớn hơn; phạm vi [0,2]; không có tác dụng nếu bản gốc không có âm thanh sound_end_time: type: integer description: >- thời gian kết thúc của đoạn âm thanh không được vượt quá thời lượng của âm thanh gốc sound_file: type: string description: >- Tệp âm thanh. Dữ liệu Base64 hoặc URL có thể truy cập; .mp3/.wav/.m4a; ≤5MB; thời lượng 2–60 giây. Chỉ được cung cấp một trong hai trường audio_id hoặc sound_file. Định dạng/kích thước không hợp lệ hoặc vấn đề về nội dung sẽ trả về lỗi sound_insert_time: type: integer description: >- thời gian chèn của khoảng âm thanh đã cắt phải chồng lấp với khoảng thời gian khuôn mặt có thể đồng bộ khẩu hình ít nhất 2 giây; thời điểm bắt đầu chèn không được trước thời điểm bắt đầu video, và thời điểm kết thúc chèn không được sau thời điểm kết thúc video sound_start_time: type: integer description: >- thời gian bắt đầu của đoạn âm thanh;tính tương đối so với thời điểm bắt đầu của âm thanh gốc (0:00), đơn vị: ms;phần âm thanh trước thời điểm bắt đầu sẽ bị cắt bỏ, đoạn âm thanh sau khi cắt phải dài ít nhất 2 giây sound_volume: type: integer description: Âm lượng âm thanh; cao hơn=to hơn; phạm vi [0, 2] x-apifox-orders: - audio_id - face_id - original_audio_volume - sound_end_time - sound_file - sound_insert_time - sound_start_time - sound_volume x-apidog-orders: - audio_id - face_id - original_audio_volume - sound_end_time - sound_file - sound_insert_time - sound_start_time - sound_volume description: >- chỉ định một khuôn mặt để đồng bộ hóa khẩu hình;bao gồm ID khuôn mặt, tham chiếu đồng bộ hóa khẩu hình, v.v.;hiện chỉ hỗ trợ đồng bộ hóa khẩu hình cho một người session_id: type: string description: ID phiên từ API nhận diện khuôn mặt đồng bộ khẩu hình x-apifox-orders: - callback_url - external_task_id - face_choose - session_id x-apidog-orders: - callback_url - external_task_id - face_choose - session_id examples: example: value: callback_url: '' external_task_id: '' face_choose: - audio_id: '825451760499568680' face_id: '-1' original_audio_volume: 1 sound_end_time: 5000 sound_file: '' sound_insert_time: 1000 sound_start_time: 0 sound_volume: 1 session_id: '825465778199224380' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/đồng bộ chuyển động môi x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209031-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209032/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/advanced-lip-sync/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-videos-advanced-lip-sync-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/đồng bộ chuyển động môi - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '825469163380052066' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/đồng bộ chuyển động môi x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209032-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Âm thanh tùy chỉnh" Nguồn: https://docs.openaihub.net/api-45209033/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/general/custom-voices: post: summary: Âm thanh tùy chỉnh deprecated: false description: '' operationId: post-kling-v1-general-custom-voices tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Âm thanh tùy chỉnh - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - voice_name properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ video_id: type: string description: >- ID công việc trước đây, cung cấp âm thanh thông qua các video công việc trước đây. Chỉ những video đáp ứng các điều kiện sau mới có thể tùy chỉnh giọng nói: video từ V2.6 với sound=on video từ API người kỹ thuật số video từ API đồng bộ khẩu hình âm thanh phải có lời nói rõ ràng, không có tạp âm, chỉ có đúng một giọng nói rõ ràng, thời lượng từ 5 giây đến 30 giây voice_name: type: string description: Tên giọng nói voice_url: type: string description: >- URL của tệp giọng nói mẫu hỗ trợ các tệp âm thanh/video .mp3/.wav/.mp4/.mov âm thanh phải có lời nói rõ ràng, không có tiếng ồn, chỉ có đúng một giọng nói rõ ràng, thời lượng từ 5 giây đến 30 giây x-apifox-orders: - callback_url - external_task_id - video_id - voice_name - voice_url x-apidog-orders: - callback_url - external_task_id - video_id - voice_name - voice_url examples: {} responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: callback_url: '' external_task_id: '' video_id: '830460928805724256' voice_name: Kiểm tra âm sắc voice_url: '' headers: {} x-apidog-name: '' '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/Kling/Âm thanh tùy chỉnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209033-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn âm sắc tùy chỉnh (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209034/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/general/custom-voices/{id}: get: summary: Truy vấn âm sắc tùy chỉnh (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-general-custom-voices-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Âm thanh tùy chỉnh - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Âm thanh tùy chỉnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209034-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Kiểm tra âm thanh chính thức" Nguồn: https://docs.openaihub.net/api-45209035/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/general/presets-voices: get: summary: Kiểm tra âm thanh chính thức deprecated: false description: '' operationId: get-kling-v1-general-presets-voices tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Âm thanh tùy chỉnh - kling parameters: - name: pageNum in: query description: Số trang (bắt đầu từ 1) required: false example: 1 schema: type: integer - name: pageSize in: query description: Số mục trên mỗi trang required: false example: 30 schema: type: integer - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object x-apidog-orders: [] examples: {} responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/Âm thanh tùy chỉnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209035-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Xoa am thanh tuy chinh" Nguồn: https://docs.openaihub.net/api-45209036/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/general/delete-voices: post: summary: Xoa am thanh tuy chinh deprecated: false description: '' operationId: post-kling-v1-general-delete-voices tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Âm thanh tùy chỉnh - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - voice_id properties: voice_id: type: string description: Mã giọng nói x-apifox-orders: - voice_id x-apidog-orders: - voice_id examples: {} responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/Âm thanh tùy chỉnh x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209036-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "điều khiển chuyển động" Nguồn: https://docs.openaihub.net/api-45209037/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/motion-control: post: summary: điều khiển chuyển động deprecated: false description: '' operationId: post-kling-v1-videos-motion-control tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/điều khiển chuyển động - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - image_url - video_url - character_orientation - mode properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất character_orientation: type: string description: |- Hướng nhân vật so với hình ảnh hoặc video enum: image, video image: khớp với hình ảnh (video tham chiếu ≤10s) video: khớp với video (video tham chiếu ≤30s) element_list: type: array items: type: object properties: element_id: type: string description: >- khi tham chiếu một chủ thể, hướng hiện tại sẽ tuân theo video tham chiếu hiện tại chỉ có một chủ thể x-apifox-orders: - element_id x-apidog-orders: - element_id description: danh sách tham chiếu chủ đề external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ image_url: type: string description: >- Ảnh tham chiếu; nhân vật/phông nền bám theo ảnh này. Yêu cầu: tỷ lệ nhân vật hoạt hình chân thực hoặc gần chân thực, tránh che khuất; diện tích nhân vật >5%; Base64 hoặc URL có thể truy cập; .jpg/.jpeg/.png; tối đa 10MB; cạnh tối thiểu 300px; tỷ lệ khung hình 1:2.5–2.5:1 keep_original_sound: type: string description: |- có giữ lại âm thanh gốc của video hay không enum: yes, no yes: giữ lại âm thanh gốc no: loại bỏ âm thanh gốc mode: type: string description: |- Chế độ tạo video liệt kê: std, pro std: tiêu chuẩn / tiết kiệm chi phí pro: chuyên nghiệp / chất lượng cao model_name: type: string description: mặc định kling-v2-6 kling-v3 prompt: type: string description: >- lời nhắc bằng văn bản, có thể bao gồm mô tả tích cực và tiêu cực sử dụng lời nhắc để thêm các thành phần / chuyển động máy quay, v.v., xem hướng dẫn điều khiển chuyển động của Kling tối đa 2500 ký tự https://docs.qingque.cn/d/home/eZQAl5y8xNSkr0iYUS8-bpGvP?identityId=2Cn18n4EIHT#section=h.xtmfpd68o18 video_url: type: string description: >- Yêu cầu đối với video: chính xác một người chân thực, thấy toàn thân hoặc nửa thân trên và có đầu, tránh bị che khuất; chuyển động rõ ràng, không lộn người hoặc trồng cây chuối; quay một lần liên tục, người luôn ở trong khung hình. Định dạng .mp4/.mov; dung lượng không quá 100MB; mỗi cạnh từ 340 đến 3850px. Tối thiểu 3 giây; tối đa 30 giây nếu hướng khớp với video, 10 giây nếu khớp với hình ảnh. Nội dung đã được xác thực. watermark_info: type: array items: type: object properties: watermark_info: type: boolean description: |- true=tạo, false=không tạo hình mờ tùy chỉnh hiện chưa được hỗ trợ x-apifox-orders: - watermark_info x-apidog-orders: - watermark_info description: có tạo thêm kết quả có hình chìm hay không x-apifox-orders: - callback_url - character_orientation - element_list - external_task_id - image_url - keep_original_sound - mode - model_name - prompt - video_url - watermark_info x-apidog-orders: - callback_url - character_orientation - element_list - external_task_id - image_url - keep_original_sound - mode - model_name - prompt - video_url - watermark_info examples: example: value: character_orientation: video image_url: >- https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.png keep_original_sound: có mode: chuyên nghiệp model_name: kling-v3 prompt: Cô gái mặc áo thun rộng màu xám và quần short denim. video_url: >- https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4 summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/điều khiển chuyển động x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209037-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn (đơn lẻ)" Nguồn: https://docs.openaihub.net/api-45209038/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/motion-control/{id}: get: summary: Tác vụ truy vấn (đơn lẻ) deprecated: false description: '' operationId: get-kling-v1-videos-motion-control-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/điều khiển chuyển động - kling parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/điều khiển chuyển động x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209038-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Chủ đề (cũ)" Nguồn: https://docs.openaihub.net/api-45209039/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/general/custom-elements: post: summary: Chủ đề (cũ) deprecated: false description: '' operationId: post-kling-v1-general-custom-elements tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/nội dung chính - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - element_name - element_description - element_frontal_image - element_refer_list properties: element_description: type: string description: |- Mô tả chủ đề Tối đa 100 ký tự element_frontal_image: type: string description: >- Ảnh tham chiếu của chủ thể nhìn thẳng. Chấp nhận Base64 hoặc URL có thể truy cập; .jpg/.jpeg/.png; tối đa 10MB; cạnh tối thiểu 300px; tỷ lệ khung hình 1:2.5–2.5:1 element_name: type: string description: |- Tên chủ đề Tối đa 20 ký tự element_refer_list: type: array items: type: object required: - image_url properties: image_url: type: string description: URL hình ảnh x-apifox-orders: - image_url x-apidog-orders: - image_url description: >- Danh sách tham chiếu bổ sung cho chủ thể. Tải lên 1–3 hình tham chiếu từ các góc khác nhau để xác định diện mạo, theo dạng khóa:giá trị, ví dụ: "element_refer_list":[{"image_url":"image_url_1"}, ...] x-apifox-orders: - element_description - element_frontal_image - element_name - element_refer_list x-apidog-orders: - element_description - element_frontal_image - element_name - element_refer_list examples: example: value: element_description: '' element_frontal_image: '' element_name: '' element_refer_list: [] summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/nội dung chính x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209039-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Phần nội dung chính (phiên bản mới)" Nguồn: https://docs.openaihub.net/api-45209040/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/general/advanced-custom-elements: post: summary: Phần nội dung chính (phiên bản mới) deprecated: false description: '' operationId: post-kling-v1-general-advanced-custom-elements tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/nội dung chính - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - element_name - element_description - reference_type properties: callback_url: type: string description: >- URL goi lai ket qua tac vu; neu duoc thiet lap, may chu se thong bao khi trang thai thay doi element_description: type: string description: Vui lòng gửi tài liệu cần dịch. element_image_list: type: object properties: frontal_image: type: string description: Hình ảnh tham chiếu chính diện refer_images: type: array items: type: object required: - image_url properties: image_url: type: string description: URL hình ảnh x-apifox-orders: - image_url x-apidog-orders: - image_url description: Danh sách hình ảnh tham khảo description: >- Xác định chủ thể qua nhiều hình ảnh: ít nhất một frontal_image cùng với 1–3 refer_images khác nhau (image_url). Dưới dạng key:value trong element_image_list. Base64 hoặc URL; .jpg/.jpeg/.png; tối đa 10MB; tối thiểu 300px; tỷ lệ khung hình 1:2.5–2.5:1. Bắt buộc khi reference_type=image_refer x-apifox-orders: - frontal_image - refer_images x-apidog-orders: - frontal_image - refer_images element_name: type: string description: tối đa 20 ký tự element_video_list: type: object properties: refer_videos: type: array items: type: object properties: video_url: type: string description: URL video x-apifox-orders: - video_url x-apidog-orders: - video_url description: Danh sách video tham khảo description: >- Xác định chủ thể qua video. Video có lời nói sẽ kích hoạt tùy chỉnh giọng nói. Hiện tại chỉ hỗ trợ người thật. Bắt buộc đối với tham chiếu video; bị bỏ qua đối với tham chiếu hình ảnh. MP4/MOV; 3–8 giây; 16:9 hoặc 9:16 1080P; mỗi đoạn phim ≤200MB; bắt buộc có video_url. Chủ thể được tùy chỉnh bằng video chỉ khả dụng trên kling-video-o3+ x-apifox-orders: - refer_videos x-apidog-orders: - refer_videos element_voice_id: type: string description: >- có thể liên kết một giọng nói hiện có từ thư viện; khi tham số này để trống, chủ thể này không được liên kết với giọng nói. Chỉ lấy ID thông qua API giọng nói. Chỉ các chủ thể được tùy chỉnh bằng video mới hỗ trợ liên kết giọng nói external_task_id: type: string description: >- ID tác vụ tùy chỉnh. Không ghi đè ID tác vụ hệ thống, nhưng có thể được dùng cho các truy vấn. Phải là duy nhất đối với mỗi người dùng reference_type: type: string description: >- enum: video_refer、 image_refer video_refer: chủ thể video; diện mạo từ element_video_list image_refer: chủ thể nhiều hình ảnh; diện mạo từ element_image_list Chủ thể tùy chỉnh theo video và theo hình ảnh có phạm vi khả dụng khác nhau; xem bảng ánh xạ khả năng / tham số. tag_list: type: array items: type: object properties: tag_id: type: string description: ID thẻ x-apifox-orders: - tag_id x-apidog-orders: - tag_id description: >- Một chủ thể có thể có nhiều thẻ ở dạng khóa:giá trị. ID/tên thẻ: o_101 meme, o_102 người, o_103 động vật, o_104 đạo cụ, o_105 trang phục, o_106 cảnh, o_107 hiệu ứng hình ảnh, o_108 khác x-apifox-orders: - callback_url - element_description - element_image_list - element_name - element_video_list - element_voice_id - external_task_id - reference_type - tag_list x-apidog-orders: - callback_url - element_description - element_image_list - element_name - element_video_list - element_voice_id - external_task_id - reference_type - tag_list examples: example: value: element_description: Kiểm thử element_image_list: frontal_image: >- Không thể truy cập nội dung trong ảnh từ URL này. Vui lòng tải ảnh trực tiếp lên để tôi dịch. refer_images: - image_url: >- Không thể truy cập nội dung trong ảnh từ URL này. Vui lòng tải ảnh trực tiếp lên để tôi dịch. element_name: Phần chính ysh11112311213 reference_type: image_refer summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/nội dung chính x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209040-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn principal tùy chỉnh (một phiên bản mới duy nhất)" Nguồn: https://docs.openaihub.net/api-45209041/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/general/advanced-custom-elements/{task_id}: get: summary: Truy vấn principal tùy chỉnh (một phiên bản mới duy nhất) deprecated: false description: '' operationId: get-kling-v1-general-advanced-custom-elements-task-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/nội dung chính - kling parameters: - name: task_id in: path description: ID tác vụ bất đồng bộ required: true example: '865316601930203176' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/nội dung chính x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209041-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn chủ thể chính thức (phiên bản mới của danh sách)" Nguồn: https://docs.openaihub.net/api-45209042/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/general/advanced-presets-elements: get: summary: Truy vấn chủ thể chính thức (phiên bản mới của danh sách) deprecated: false description: '' operationId: get-kling-v1-general-advanced-presets-elements tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/nội dung chính - kling parameters: - name: pageNum in: query description: Số trang (bắt đầu từ 1) required: false example: '1' schema: type: string - name: pageSize in: query description: Số mục trên mỗi trang required: false example: '10' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: '' '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/Kling/nội dung chính x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209042-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Xóa chủ thể tùy chỉnh (phiên bản mới)" Nguồn: https://docs.openaihub.net/api-45209043/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/general/delete-elements: post: summary: Xóa chủ thể tùy chỉnh (phiên bản mới) deprecated: false description: '' operationId: post-kling-v1-general-delete-elements tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/nội dung chính - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object x-apidog-orders: [] examples: example: value: element_id: elem_805498da-90b2-40c1-a866-cd26eec99263 summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/Kling/nội dung chính x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209043-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Gửi tác vụ tạo video" Nguồn: https://docs.openaihub.net/api-45209044/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /runwayml/v1/image_to_video: post: summary: Gửi tác vụ tạo video deprecated: false description: >- Tạo video bằng cách dùng hình ảnh làm khung hình đầu tiên. Sau khi gửi yêu cầu, `id` của tác vụ được trả về và được thăm dò qua `GET /runwayml/v1/tasks/{task_id}`. Tài liệu chính thức: https://docs.dev.runwayml.com/api/#tag/Start-generating/paths/~1v1~1image_to_video/post operationId: runway_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Đường băng - Đường băng parameters: [] requestBody: content: application/json: schema: type: object required: - model - promptImage - ratio properties: duration: type: integer enum: - 5 - 10 description: Thời lượng video (giây) model: type: string enum: - gen4_turbo - gen3a_turbo - gen3a description: Tên mô hình examples: - gen4_turbo promptImage: oneOf: - type: string description: URL hình ảnh đơn - type: array items: type: object properties: position: type: string enum: - first - last description: 'Định danh vị trí (ví dụ: đầu tiên / cuối cùng)' uri: type: string description: URL hình ảnh x-apifox-orders: - position - uri x-apidog-orders: - position - uri description: Mảng vị trí nhiều hình ảnh description: Khung hình đầu tiên / hình ảnh tham chiếu promptText: type: string description: Các từ khóa trong câu lệnh mô tả chiến dịch/nội dung examples: - Máy quay từ từ phóng to vào chủ thể ratio: type: string enum: - '1280:720' - '720:1280' - '1104:832' - '832:1104' - '960:960' - '1584:672' description: Tỷ lệ khung hình video examples: - '1280:720' seed: type: integer description: giá trị khởi tạo ngẫu nhiên watermark: type: boolean description: Có thêm hình mờ hay không refName: RunwaySampleRequest x-apifox-orders: - duration - model - promptImage - promptText - ratio - seed - watermark x-apidog-orders: - duration - model - promptImage - promptText - ratio - seed - watermark examples: gen4_turbo: value: duration: 5 model: gen4_turbo promptImage: https://example.com/start-frame.jpg promptText: Máy quay từ từ phóng to ratio: '1280:720' summary: gen4_turbo description: video từ ảnh gen4_turbo_2: value: duration: 5 model: gen4_turbo promptImage: https://www.bt.cn/bbs/template/qiao/style/image/btlogo.png promptText: mèo nhảy múa ratio: '1280:720' watermark: false summary: gen4_turbo_2 description: Gửi tác vụ tạo video responses: '200': description: '' content: application/json: schema: type: object required: - id - state properties: batch_id: type: string description: Mã lô created_at: type: string description: Thời gian tạo id: type: string description: Mã tác vụ prompt: type: string description: Lời nhắc văn bản state: type: string description: 'Trạng thái tác vụ, ví dụ: đang chờ / thành công / thất bại' refName: RunwaySampleResponse description: >- Đối tượng tác vụ chuyển ảnh thành video của Runway sau khi gửi (khớp với cấu trúc tác vụ chính thức) x-apifox-orders: - batch_id - created_at - id - prompt - state x-apidog-orders: - batch_id - created_at - id - prompt - state examples: example: summary: example value: batch_id: '' created_at: '2024-12-22T13:38:40.139Z' id: 4665a07c-7641-4809-a133-10786201bb56 prompt: '' state: đang chờ headers: {} x-apidog-name: '' '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/Đường băng x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209044-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn các tác vụ video (miễn phí)" Nguồn: https://docs.openaihub.net/api-45209045/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /runwayml/v1/tasks/{task_id}: get: summary: Truy vấn các tác vụ video (miễn phí) deprecated: false description: >- Truy vấn trạng thái và kết quả của tác vụ Tusheng Video dựa trên ID tác vụ. operationId: runway_runwayml_v1_tasks tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Đường băng - Đường băng parameters: - name: task_id in: path description: ID được trả về khi gửi tác vụ required: true example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 schema: type: string responses: '200': description: '' content: application/json: schema: type: object required: - id - state properties: batch_id: type: string description: Mã lô created_at: type: string description: Thời gian tạo id: type: string description: ID tài nguyên hoặc tác vụ prompt: type: string description: Lời nhắc văn bản state: type: string description: Trạng thái chuyển tiếp tùy chỉnh refName: GetRunwaymlV1TasksTaskIdResponse description: >- Phản hồi truy vấn tác vụ Runway (cùng cấu trúc với phản hồi gửi tác vụ) x-apifox-orders: - batch_id - created_at - id - prompt - state x-apidog-orders: - batch_id - created_at - id - prompt - state examples: example: summary: example value: batch_id: '' created_at: '2024-12-22T13:38:40.139Z' id: 4665a07c-7641-4809-a133-10786201bb56 prompt: '' state: đang chờ headers: {} x-apidog-name: '' '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/Đường băng x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209045-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ" Nguồn: https://docs.openaihub.net/api-45209046/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /volc/v1/contents/generations/tasks: post: summary: Tạo tác vụ deprecated: false description: Gửi tác vụ tạo video Seedance/Doubao. operationId: volc_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Doubao - Doubao Volc parameters: [] requestBody: content: application/json: schema: type: object required: - model - content properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất content: type: array items: type: object properties: image_url: type: object properties: url: type: string description: URL tài nguyên description: URL hình ảnh x-apifox-orders: - url x-apidog-orders: - url role: type: string enum: - first_frame - last_frame - reference_image description: >- Vai trò của tin nhắn, ví dụ: system / user / assistant / model text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. type: type: string enum: - text - image_url description: Kiểu x-apifox-orders: - image_url - role - text - type x-apidog-orders: - image_url - role - text - type description: Mảng nội dung văn bản/hình ảnh model: type: string description: Tên mô hình examples: - doubao-seedance-2-0-260128 refName: VolcSampleRequest x-apifox-orders: - callback_url - content - model x-apidog-orders: - callback_url - content - model examples: doubao_seedance_1_5_pro_251215: value: content: - text: >- Cô gái ôm con cáo, cô gái mở mắt, dịu dàng nhìn về phía máy quay, con cáo thân thiện ôm cô gái, máy quay từ từ lùi ra xa, tóc cô gái lay động trong gió, có thể nghe thấy tiếng gió. type: text - image_url: url: >- https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png type: image_url duration: 4 model: doubao-seedance-1-5-pro-251215 ratio: thích ứng watermark: false summary: doubao_seedance_1_5_pro_251215 description: seedance-1-5-pro doubao_seedance_2_0_260128: value: content: - text: Một con mèo đang chạy trên đồng cỏ. type: text model: doubao-seedance-2-0-260128 summary: doubao_seedance_2_0_260128 description: Video Vincent doubao_seedance_2_0_260128_2: value: content: - image_url: url: https://example.com/frame.jpg role: first_frame type: image_url - text: Máy quay tiến gần type: text model: doubao-seedance-2-0-260128 summary: doubao_seedance_2_0_260128_2 description: video từ ảnh responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái refName: VolcSampleResponse x-apifox-orders: - id - status x-apidog-orders: - id - status examples: '1': summary: '1' value: id: cgt-20250918170228-dw9rb status: submitted '2': summary: '2' value: id: cgt-20260108111352-gwv4p status: submitted headers: {} x-apidog-name: '' '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/Doubao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209046-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn một tác vụ duy nhất" Nguồn: https://docs.openaihub.net/api-45209047/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /volc/v1/contents/generations/tasks/{task_id}: get: summary: Truy vấn một tác vụ duy nhất deprecated: false description: >- Truy vấn trạng thái và kết quả của một tác vụ tạo video duy nhất bằng task_id. operationId: volc_getGenerationsTask tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Doubao - Doubao Volc parameters: - name: task_id in: path description: ID tác vụ bất đồng bộ required: true example: '' schema: type: string responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: thành công '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/Doubao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209047-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn danh sách tác vụ tạo video list-default" Nguồn: https://docs.openaihub.net/api-45209048/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /volc/v1/contents/generations/tasks: get: summary: Truy vấn danh sách tác vụ tạo video list-default deprecated: false description: Danh sách tác vụ truy vấn được phân trang. operationId: volc_listGenerationsTasks tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Doubao - Doubao Volc parameters: - name: page_size in: query description: Số mục trên mỗi trang required: false example: 0 schema: type: integer responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: thành công '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/Doubao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209048-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo một tác vụ tạo video" Nguồn: https://docs.openaihub.net/api-45209049/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/v3/contents/generations/tasks: post: summary: Tạo một tác vụ tạo video deprecated: false description: Gửi tác vụ tạo video Seedance/Doubao. operationId: seedance_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Doubao - Seedance 2.0 parameters: [] requestBody: content: application/json: schema: type: object required: - model - content properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất content: type: array items: type: object properties: image_url: type: object properties: url: type: string description: URL tài nguyên description: URL hình ảnh x-apifox-orders: - url x-apidog-orders: - url role: type: string enum: - first_frame - last_frame - reference_image description: >- Vai trò của tin nhắn, ví dụ: system / user / assistant / model text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. type: type: string enum: - text - image_url description: Kiểu x-apifox-orders: - image_url - role - text - type x-apidog-orders: - image_url - role - text - type description: Mảng nội dung văn bản/hình ảnh model: type: string description: Tên mô hình examples: - doubao-seedance-2-0-260128 refName: SeedanceSampleRequest x-apifox-orders: - callback_url - content - model x-apidog-orders: - callback_url - content - model examples: doubao_seedance_2_0_260128: value: content: - text: Một con mèo đang chạy trên đồng cỏ. type: text model: doubao-seedance-2-0-260128 summary: doubao_seedance_2_0_260128 description: Video Vincent doubao_seedance_2_0_260128_2: value: content: - image_url: url: https://example.com/frame.jpg role: first_frame type: image_url - text: Máy quay tiến gần type: text model: doubao-seedance-2-0-260128 summary: doubao_seedance_2_0_260128_2 description: video từ ảnh responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: Được '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/Doubao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209049-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "API tác vụ truy vấn tạo video doubao-2.0" Nguồn: https://docs.openaihub.net/api-45209050/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/v3/contents/generations/tasks/{id}: get: summary: API tác vụ truy vấn tạo video doubao-2.0 deprecated: false description: >- Vui lòng dán nội dung tài liệu vào đây. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp, nhưng tôi có thể dịch sang tiếng Việt đồng thời giữ nguyên Markdown, mã, định danh, URL, đường dẫn, phần giữ chỗ, cấu trúc JSON và định dạng. operationId: volc_apiV3_getGenerationsTask tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Doubao - Seedance 2.0 · api/v3 parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '' schema: type: string responses: '200': description: '' content: application/json: schema: type: object required: - content - created_at - draft - duration - execution_expires_after - framespersecond - generate_audio - id - model - ratio - resolution - seed - service_tier - status - updated_at - usage properties: content: type: object required: - video_url properties: video_url: type: string description: URL video description: Nội dung tin nhắn hoặc yêu cầu x-apifox-orders: - video_url x-apidog-orders: - video_url created_at: type: integer description: Thời gian tạo draft: type: boolean description: Liệu đó có phải là bản nháp / dữ liệu bản nháp hay không duration: type: integer description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) execution_expires_after: type: integer description: Thời gian hết hạn thực thi framespersecond: type: integer description: Tốc độ khung hình (FPS) generate_audio: type: boolean description: Có tạo âm thanh hay không id: type: string description: ID tài nguyên hoặc tác vụ model: type: string description: Tên mô hình / mã định danh mô hình ratio: type: string description: Tỷ lệ khung hình hoặc tỷ lệ độ phân giải resolution: type: string description: 'Độ phân giải, ví dụ: 720p, 1080p' seed: type: integer description: >- Hạt giống ngẫu nhiên; cùng một hạt giống sẽ tạo ra kết quả có thể tái lập service_tier: type: string description: Cấp dịch vụ / mức ưu tiên status: type: string description: Trạng thái updated_at: type: integer description: Thời gian cập nhật usage: type: object required: - completion_tokens - total_tokens properties: completion_tokens: type: integer description: Số lượng token hoàn thành total_tokens: type: integer description: Tổng số token description: Thống kê mức sử dụng token x-apifox-orders: - completion_tokens - total_tokens x-apidog-orders: - completion_tokens - total_tokens refName: GetApiV3ContentsGenerationsTasksIdResponse x-apifox-orders: - content - created_at - draft - duration - execution_expires_after - framespersecond - generate_audio - id - model - ratio - resolution - seed - service_tier - status - updated_at - usage x-apidog-orders: - content - created_at - draft - duration - execution_expires_after - framespersecond - generate_audio - id - model - ratio - resolution - seed - service_tier - status - updated_at - usage examples: example: summary: example value: content: video_url: >- https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/02177831701906400000000000000000000ffffac1778adc6a32f.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260509%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260509T090109Z&X-Tos-Expires=86400&X-Tos-Signature=699d4a345c3573c9b86f2f145db21c00bfd32d7f8d1fe0bbe499ce54d92a0af5&X-Tos-SignedHeaders=host created_at: 1778317019 draft: false duration: 10 execution_expires_after: 172800 framespersecond: 24 generate_audio: true id: cgt-20260509165650-6rxbv model: doubao-seedance-2-0-260128 ratio: '1:1' resolution: 720p seed: 70882 service_tier: mặc định status: succeeded updated_at: 1778317294 usage: completion_tokens: 216900 total_tokens: 216900 headers: {} x-apidog-name: '' '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/Doubao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209050-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "doubao-2.0 Truy vấn danh sách tác vụ tạo video" Nguồn: https://docs.openaihub.net/api-45209051/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/v3/contents/generations/tasks: get: summary: doubao-2.0 Truy vấn danh sách tác vụ tạo video deprecated: false description: Danh sách tác vụ truy vấn được phân trang. operationId: seedance_list_tasks tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Doubao - Seedance 2.0 parameters: - name: page_size in: query description: Số mục trên mỗi trang required: false example: 0 schema: type: integer responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: thành công '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/Doubao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209051-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo một vai trò" Nguồn: https://docs.openaihub.net/api-45209052/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /sora/v1/characters: post: summary: Tạo một vai trò deprecated: false description: Tạo các nhân vật có thể tái sử dụng từ cảnh quay video. operationId: sora_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/sora - Sora2 parameters: [] requestBody: content: application/json: schema: type: object required: - timestamps properties: from_task: type: string description: Có thể tạo vai trò dựa trên mã định danh tác vụ đã được tạo timestamps: type: string description: >- Đơn vị là giây, ví dụ, ‘1,2’ chỉ các ký tự xuất hiện từ giây thứ 1 đến giây thứ 2 của video. Lưu ý rằng độ chênh lệch của khoảng tối đa là 3 giây và tối thiểu là 1 giây. url: type: string description: >- Video chứa vai trò cần được tạo; hãy chọn một trong hai: `url` hoặc `from_task`. refName: SoraSampleRequest x-apifox-orders: - from_task - timestamps - url x-apidog-orders: - from_task - timestamps - url examples: default: value: timestamps: 1,3 url: https://example.com/video.mp4 summary: default description: Tạo từ URL example_single: value: from_task: video_e50c76ca-21d4-40e9-8485-e4ead2d37133 timestamps: 1,3 summary: example_single description: Tạo một vai trò responses: '200': description: '' content: application/json: schema: type: object required: - id - username - permalink - profile_picture_url properties: id: type: string description: id vai trò permalink: type: string description: >- Trang chủ nhân vật, chuyển đến để mở trang chủ nhân vật openai profile_picture_url: type: string description: Hình đại diện nhân vật username: type: string description: Tên vai trò, được dùng trong từ khóa lời nhắc @{username} refName: SoraSampleResponse x-apifox-orders: - id - permalink - profile_picture_url - username x-apidog-orders: - id - permalink - profile_picture_url - username examples: example: summary: example value: id: ch_6918d62178e48191a0b1ae49be428a13 permalink: https://sora.chatgpt.com/profile/hfspncadz.mooflapand profile_picture_url: >- Tôi không thể truy cập nội dung từ liên kết này. Vui lòng dán tài liệu cần dịch vào đây. username: hfspncadz.mooflapand headers: {} x-apidog-name: '' '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/sora x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209052-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video bằng hình ảnh sora-2" Nguồn: https://docs.openaihub.net/api-45209053/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/create: post: summary: Tạo video bằng hình ảnh sora-2 deprecated: false description: >- Omni-Flash · tạo video hợp nhất (`POST /v1/video/create`, tuyến vật lý chuyển tiếp VEO; xem `relay/veo` là tuyến chính). `model=omni-flash` / `omni-flash-edit` định tuyến đến quy trình Omni-Flash; `type` chọn khả năng: - `1` = chuyển văn bản thành video (chỉ yêu cầu `prompt`) - `2` = khung hình đầu/cuối (`images` yêu cầu 1-2 mục) - `3` = hình ảnh tham chiếu (`images` yêu cầu 1-3 mục) - `4` = chỉnh sửa video Omni-Flash (yêu cầu `input_reference`) Trả về `id` (ID tác vụ); thăm dò `GET /v1/video/query?id=` để nhận kết quả. operationId: omni_video_create tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/sora/Định dạng video hợp nhất - Omni parameters: - name: Content-Type in: header description: Định dạng dữ liệu phần thân yêu cầu required: false example: application/json schema: type: string - name: Accept in: header description: Định dạng dữ liệu phản hồi mà máy khách dự kiến nhận được required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa xác thực API, định dạng là Bearer + dấu cách + khóa API của bạn required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model - prompt properties: aspect_ratio: type: string enum: - '16:9' - '9:16' description: tỷ lệ khung hình enable_sample: type: boolean description: >- Dòng Omni-Flash chuyển sang 1080p (bỏ qua đối với các mẫu 4K) enable_upsample: type: boolean description: >- Đã nâng cấp lên 1080p (khả dụng trên một số mẫu 4K nhất định) images: type: array items: type: string format: uri description: >- Mảng URL hình ảnh (type=2 yêu cầu 1-2 hình ảnh, type=3 yêu cầu 1-3 hình ảnh) input_reference: type: string description: >- Video tham chieu chinh sua Omni-Flash (canh JSON duoc truyen den URL hoac dataURI) model: type: string description: 'Tên mô hình (ví dụ: omni-flash, omni-flash-edit)' prompt: type: string description: Mô tả nội dung video seconds: type: string description: 'Thời lượng video (giây), ví dụ: "8"' size: type: string description: >- Kích thước tùy chỉnh, tỷ lệ chiều rộng là 16:9 và tỷ lệ chiều cao là 9:16. Khi aspect_ratio có hiệu lực, tham số này không còn giá trị. type: type: integer enum: - 1 - 2 - 3 - 4 description: >- Loại tạo sinh: 1=Video từ văn bản, 2=Khung hình đầu và cuối, 3=Tham chiếu nhiều hình ảnh, 4=Chỉnh sửa video Omni-Flash allOf: - type: string - type: string - type: string - type: string refName: PostV1VideoCreateRequest x-apifox-orders: - aspect_ratio - enable_sample - enable_upsample - images - input_reference - model - prompt - seconds - size - type x-apidog-orders: - aspect_ratio - enable_sample - enable_upsample - images - input_reference - model - prompt - seconds - size - type examples: omni_flash: value: model: omni-flash prompt: xin chào thế giới summary: omni_flash description: >- Khuyến nghị cho người mới bắt đầu: Yêu cầu tối thiểu cho người mới bắt đầu · Kiến thức cơ bản về tạo sinh từ văn bản · mô hình+lời nhắc omni_flash_2: value: aspect_ratio: '16:9' model: omni-flash prompt: Cảnh hoàng hôn bên bờ biển quay từ trên không seconds: '8' summary: omni_flash_2 description: >- Khuyên dùng cho người mới bắt đầu: Màn hình ngang tiêu chuẩn · Vincent Video · model+prompt+aspect_ratio+seconds omni_flash_3: value: aspect_ratio: '9:16' model: omni-flash prompt: Nhân vật đường phố quay chậm seconds: '8' summary: omni_flash_3 description: >- Khuyến nghị cho người mới bắt đầu: tiêu chuẩn màn hình dọc · Vincent Video · model+prompt+aspect_ratio+seconds omni_flash_4: value: images: - >- https://ts1.tc.mm.bing.net/th/id/R-C.8dbf8e136e7d71653b63fdbd4d17fb6c?rik=KEcgD1%2fwKEKc9A&riu=http%3a%2f%2fimg.xintp.com%2f2019%2f12%2f10%2fxl5gp5kgesw.jpg&ehk=j5IVfJ0NDf2S9Ki9dJ7uXRMGlqubf9rR8TGsNLZP%2fMQ%3d&risl=&pid=ImgRaw&r=0 - >- https://ts1.tc.mm.bing.net/th/id/R-C.ef98ae99612a621c19aaf5c02df8590a?rik=bpRpplfXRRo8pA&riu=http%3a%2f%2fimg95.699pic.com%2fphoto%2f50166%2f6903.jpg_wh300.jpg&ehk=yf0pMNdv%2bxIdqiWephK%2fg%2bt9K%2fTLDd8Db46yw8Q%2bSXM%3d&risl=&pid=ImgRaw&r=0 model: omni-flash prompt: Chuyển tiếp mượt mà giữa khung hình đầu và cuối seconds: '8' summary: omni_flash_4 description: >- Khuyên dùng cho người mới bắt đầu: Chuyển tiếp giữa hai hình ảnh · Tạo khung hình đầu và cuối · mô hình+lời nhắc+hình ảnh+số giây omni_flash_5: value: images: - >- https://static.jokers.pub/upload/ai/728c4393-77ee-441a-99fa-ea1c294035a1/Image-91o3qgbn15t9o2k/1779515038884-1742.jpg model: omni-flash prompt: Tạo video giữ nguyên phong cách của chủ thể chính seconds: '8' summary: omni_flash_5 description: >- Khuyến nghị cho người mới bắt đầu: tham chiếu một ảnh · tạo ảnh tham chiếu đệm · mô hình+câu lệnh+ảnh+số giây omni_flash_6: value: aspect_ratio: '9:16' images: - >- https://ts2.tc.mm.bing.net/th/id/OIP-C.iBy7zllJXvjrzOH-VdwH_gHaEK?rs=1&pid=ImgDetMain&o=7&rm=3 - https://imgs.699pic.com/images/600/406/117.jpg!list1x.v2 - >- https://ts2.tc.mm.bing.net/th/id/OIP-C.thJJkD55hZLuc-D86OW7bgHaEW?rs=1&pid=ImgDetMain&o=7&rm=3 model: omni-flash prompt: >- Kết hợp chủ thể và phong cách phối màu của ba hình ảnh tham khảo seconds: '8' summary: omni_flash_6 description: >- Khuyến nghị nâng cao: Kết hợp ba hình ảnh · Tạo hình ảnh tham chiếu Mat · model+prompt+images+aspect_ratio+seconds omni_flash_7: value: model: omni-flash prompt: Video tua nhanh Thành phố Chân trời seconds: '8' type: 1 summary: omni_flash_7 description: >- Khuyến nghị nâng cao: kiểu tường minh Vincent · lệnh gọi tương thích với Vincent · mô hình+lời nhắc+kiểu+số giây omni_flash_edit: value: input_reference: https://example.com/input.mp4 model: omni-flash-edit prompt: Chuyển video gốc sang phong cách điện ảnh type: 4 summary: omni_flash_edit description: >- Khuyến nghị cho người mới bắt đầu: Kiến thức cơ bản về chỉnh sửa URL · Chỉnh sửa video · model+prompt+input_reference+seconds omni_flash_edit_datauri: value: input_reference: >- https://cdn.dealonhorizon.us/video/d2fa3281de7a69f3ac07b3451cf922e3ba609daad00d081674b283a63de67e54.mp4 model: omni-flash-edit prompt: Nâng cao màu sắc và ánh sáng type: 4 summary: omni_flash_edit_datauri description: >- Khuyến nghị nâng cao: Chỉnh sửa DataURI · Chỉnh sửa video · model+prompt+input_reference(dataURI)+seconds responses: '200': description: '' content: application/json: schema: type: object required: - id - status - status_update_time properties: id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái refName: PostV1VideoCreateResponse x-apifox-orders: - id - status - status_update_time x-apidog-orders: - id - status - status_update_time examples: example: summary: example value: id: omni-flash_X:task_uAbDkbRmcOafvSBBmNWwQkIA1gvTdoaX status: queued status_update_time: 1779950697931 headers: {} x-apidog-name: '' '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/sora/Định dạng video hợp nhất x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209053-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Các tác vụ truy vấn" Nguồn: https://docs.openaihub.net/api-45209054/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/query: get: summary: Các tác vụ truy vấn deprecated: false description: >- Omni-Flash · truy vấn tác vụ (`GET /v1/video/query`, tuyến vật lý chuyển tiếp VEO; xem `relay/veo` là tuyến chính). Truy vấn trạng thái/kết quả của một tác vụ Omni-Flash được tạo qua `POST /v1/video/create`; khi `status=failed`, `error` cung cấp lý do thất bại. operationId: omni_video_query tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/sora/Định dạng video hợp nhất - Omni parameters: - name: id in: query description: ID tài nguyên / tác vụ trong đường dẫn required: false example: omni-flash:1779717386-QYRfzV5zLK schema: type: string - name: model in: query description: Tên mô hình required: false example: omni-flash schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: error: Tạo video thất bại id: omni-flash:1779717386-QYRfzV5zLK status: failed status_update_time: 1779717416 headers: {} x-apidog-name: '' '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/sora/Định dạng video hợp nhất x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209054-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "OpenAI tạo video (có hình ảnh)" Nguồn: https://docs.openaihub.net/api-45209055/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos: post: summary: OpenAI tạo video (có hình ảnh) deprecated: false description: '' operationId: post-v1-videos tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/sora/Định dạng video chính thức của OpenAI - hiểu thấu đáo parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: input_reference: type: string description: URL hình ảnh examples: - '' example: '' model: type: string description: Tên mô hình examples: - grok-videos example: grok-videos prompt: type: string description: Lời nhắc examples: - Để chú bò vui vẻ nhảy điệu Khoa Mục Ba example: Để chú bò vui vẻ nhảy điệu Khoa Mục Ba seconds: type: number description: Thời lượng 6s / 10s examples: - 6 example: 6 size: type: string description: 16:9 , 9:16 examples: - '16:9' example: '16:9' required: - model - prompt examples: example: value: input_reference: '' model: grok-videos prompt: Để chú bò vui vẻ nhảy điệu Khoa Mục Ba seconds: 6 size: '16:9' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/sora/Định dạng video chính thức của OpenAI x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209055-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "openai chỉnh sửa video" Nguồn: https://docs.openaihub.net/api-45209056/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos/{id}/remix: post: summary: openai chỉnh sửa video deprecated: false description: >- Chỉ dành cho Sora2 · phối lại/chỉnh sửa một video hiện có (`POST /v1/videos/{id}/remix`). operationId: sora_v1_videos_remix tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/sora/Định dạng video chính thức của OpenAI - Sora2 parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: video_099c5197-abfd-4e16-88ff-1e162f2a5c77 schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string requestBody: content: application/json: schema: type: object required: - prompt properties: prompt: type: string description: Lời nhắc văn bản x-apifox-orders: - prompt x-apidog-orders: - prompt examples: openai_single: value: prompt: Làm cho giao diện tinh tế hơn một chút size: 1280x720 summary: openai_single description: openai chỉnh sửa video responses: '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: '' content: application/json: schema: type: object required: - error properties: error: type: object required: - message - message_zh - type properties: message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. message_zh: type: string description: Thông báo lỗi / lời nhắc bằng tiếng Trung type: type: string description: Kiểu description: Thông báo lỗi x-apifox-orders: - message - message_zh - type x-apidog-orders: - message - message_zh - type x-apifox-orders: - error x-apidog-orders: - error examples: example: summary: example value: error: message: Thông tin xác thực không hợp lệ message_zh: Thông tin xác thực không hợp lệ type: invalid_request_error headers: {} x-apidog-name: '' security: [] x-apidog-folder: >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/sora/Định dạng video chính thức của OpenAI x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209056-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ truy vấn OpenAI" Nguồn: https://docs.openaihub.net/api-45209057/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos/{id}: get: summary: Tác vụ truy vấn OpenAI deprecated: false description: >- Truy vấn trạng thái tác vụ Grok Imagine (`GET /v1/videos/{id}`). Dùng chung tuyến vật lý với Sora; phân biệt bằng ID tác vụ / mô hình. Thăm dò các tác vụ được gửi qua `POST /v1/videos/generations` hoặc `POST /v1/videos/edits`. operationId: grok_v1_videos tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/sora/Định dạng video chính thức của OpenAI - Grok parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: sora-2:task_01k81e7r1mf0qtvp3ett3mr4jm schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: true example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string - name: X-Forwarded-Host in: header description: Host gốc được chuyển tiếp (trường hợp proxy) required: false example: localhost:5173 schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: {} examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: enhanced_prompt: type: string description: Lời nhắc nâng cao id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái video_url: type: string description: URL video refName: GetV1VideosIdResponse x-apifox-orders: - enhanced_prompt - id - status - status_update_time - video_url x-apidog-orders: - enhanced_prompt - id - status - status_update_time - video_url examples: '1': summary: '1' value: '[long payload omitted: 1,869 units]' '2': summary: '2' value: completed_at: 1761622385 created_at: 1761622232 enhanced_prompt: '' id: video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980 model: sora-2 object: video progress: 100 seconds: '10' size: 1280x720 status: completed status_update_time: 1761622385 video_url: >- https://midjourney-plus.oss-us-west-1.aliyuncs.com/sora/cc4fb429-22a5-4747-a6f9-a6badccf8f42.mp4 headers: {} x-apidog-name: '' '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/sora/Định dạng video chính thức của OpenAI x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209057-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tải xuống video OpenAI" Nguồn: https://docs.openaihub.net/api-45209058/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos/{id}/content: get: summary: Tải xuống video OpenAI deprecated: false description: >- Chỉ dành cho Sora2 · tải xuống nội dung video đã hoàn tất (`GET /v1/videos/{id}/content`). operationId: sora_v1_videos_content tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/sora/Định dạng video chính thức của OpenAI - Sora2 parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: video_099c5197-abfd-4e16-88ff-1e162f2a5c77 schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: true example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string - name: X-Forwarded-Host in: header description: Host gốc được chuyển tiếp (trường hợp proxy) required: false example: localhost:5173 schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: {} examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - status - video_url - enhanced_prompt - status_update_time properties: enhanced_prompt: type: string description: Lời nhắc nâng cao id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái video_url: type: string description: URL video nullable: true refName: GetV1VideosIdContentResponse x-apifox-orders: - enhanced_prompt - id - status - status_update_time - video_url x-apidog-orders: - enhanced_prompt - id - status - status_update_time - video_url examples: example: summary: example value: enhanced_prompt: chuỗi id: string status: string status_update_time: 0 video_url: chuỗi headers: {} x-apidog-name: '' '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/sora/Định dạng video chính thức của OpenAI x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209058-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo một nhân vật từ video đã tải lên" Nguồn: https://docs.openaihub.net/api-45209059/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos/characters: post: summary: Tạo một nhân vật từ video đã tải lên deprecated: false description: >- Chỉ dành cho Sora2 · tạo một nhân vật có thể tái sử dụng từ video đã tải lên (`POST /v1/videos/characters`). operationId: sora_v1_videos_characters tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/sora/Định dạng video chính thức của OpenAI - Sora2 parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: name: type: string description: |- Định nghĩa tên vai trò. Độ dài tối đa 80 Độ dài tối thiểu 1 examples: - Chú cá nhỏ đáng yêu example: Chú cá nhỏ đáng yêu video: type: string format: binary description: >- Tệp video dùng để tạo nhân vật. Tính năng tải nhân vật lên hiện hoạt động tốt nhất với video có tỷ lệ khung hình 16:9 hoặc 9:16, thời lượng ngắn từ 2 đến 4 giây và độ phân giải từ 720p đến 1080p. Video nguồn của nhân vật hoạt động tốt nhất khi có cùng tỷ lệ khung hình với đầu ra yêu cầu. Nếu tỷ lệ khung hình khác nhau, nhân vật có thể trông bị kéo giãn hoặc biến dạng. Một video có thể chứa tối đa hai nhân vật. examples: - file://C:\Users\Administrator\Desktop\tai-xuong.mp4 example: file://C:\Users\Administrator\Desktop\tai-xuong.mp4 required: - name - video examples: example: value: name: Chú cá nhỏ đáng yêu video: file://C:\Users\Administrator\Desktop\tai-xuong.mp4 x-i18n: en-US: name: Cute little fish summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: created_at: 1761622232 id: video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980 model: sora-2 object: video progress: 0 seconds: '10' size: 1280x720 status: queued headers: {} x-apidog-name: '' '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/sora/Định dạng video chính thức của OpenAI x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209059-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video" Nguồn: https://docs.openaihub.net/api-45209060/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/chat/completions: post: summary: Tạo video deprecated: false description: >- Cổng tương thích OpenAI hợp nhất. Chọn nguồn thượng nguồn thông qua `model`, ví dụ: - `gpt-4o` / `gpt-4o-audio-preview` → OpenAI - `gemini-2.5-flash-all` → Google Gemini (định dạng tương thích) - Với các mô hình khác, xem `GET /v1/models` Tài liệu chính thức của OpenAI: https://platform.openai.com/docs/api-reference/chat/create Định dạng tên mô hình là: gpt-4-gizmo-*, và hệ thống sẽ tự động nhận dạng. Ví dụ, GPTs này: https://chatgpt.com/g/g-B3hgivKK9-write-for-me Khi đó, tên mô hình của nó phải được điền là: gpt-4-gizmo-g-B3hgivKK9 Danh sách GPTs: https://chatgpt.com/gpts operationId: v1_chat_completions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/sora/định dạng trò chuyện - Trò chuyện parameters: [] requestBody: content: application/json: schema: type: object required: - model - messages properties: enable_thinking: type: boolean description: >- Có bật chế độ suy luận hay không (phần mở rộng của kho này). Chỉ giá trị Boolean `true` mới có hiệu lực; hãy chọn một trong các giá trị của `extra_body.enable_thinking`. extra_body: type: object properties: enable_thinking: type: boolean description: >- Bật chế độ suy luận trong `extra_body`; chỉ chấp nhận giá trị `true`. google: type: object description: >- Các phần mở rộng hộp thoại Gemini như thinking_config, response_modalities. x-apidog-orders: [] description: >- Các tham số mở rộng cho hội thoại. Thường dùng: enable_thinking; một số mô hình Gemini có thể dùng google.thinking_config, vân vân. Việc tham số có hiệu lực hay không phụ thuộc vào kênh và mô hình. x-apifox-orders: - enable_thinking - google x-apidog-orders: - enable_thinking - google frequency_penalty: type: number description: >- Hệ số phạt tần suất, khoảng -2~2. Giá trị dương làm giảm xác suất lặp lại cùng một từ. logit_bias: type: object description: >- Điều chỉnh xác suất xuất hiện theo ID token, và giá trị là một đối tượng ánh xạ với các giá trị nằm trong khoảng từ -100 đến 100. x-apidog-orders: [] max_completion_tokens: type: integer description: >- Giới hạn token tối đa cho phần hoàn thành (thường được dùng hơn trong các mô hình suy luận như dòng o và GPT-5). `max_tokens` có thể được kế thừa khi không được thiết lập. max_tokens: type: integer description: >- Số lượng token tối đa được tạo trong phản hồi này (các trường dùng chung). messages: type: array items: type: object required: - role - content properties: content: oneOf: - type: string - type: array items: type: object required: - type properties: image_url: type: object required: - url properties: detail: type: string enum: - auto - low - high description: >- Độ chính xác khi hiểu hình ảnh: tự động/thấp/cao. url: type: string description: >- URL hình ảnh hoặc data:image/...;base64,... . description: >- Hình ảnh khi type=image_url. Nếu cổng kết nối bật proxy hình ảnh, url có thể bị thay thế. x-apifox-orders: - detail - url x-apidog-orders: - detail - url text: type: string description: Nội dung văn bản khi type=text. type: type: string enum: - text - image_url description: >- Loại khối nội dung: `text` là văn bản, `image_url` là hình ảnh. refName: Phần nội dung x-apifox-orders: - image_url - text - type x-apidog-orders: - image_url - text - type description: >- Nội dung tin nhắn: văn bản thuần túy hoặc mảng kết hợp hình ảnh và văn bản (xem ContentPart). name: type: string description: >- Tùy chọn. Phân biệt tên người nói trong các tình huống có nhiều người dùng. reasoning_content: type: string description: >- Văn bản về quá trình suy luận/tư duy (được dùng khi suy luận về các mô hình và tiếp nối ngữ cảnh). role: type: string enum: - system - user - assistant - tool - developer description: >- Vai trò của thông điệp. system: cài đặt hệ thống; user: người dùng; assistant: mô hình; tool: kết quả trả về của công cụ. tool_call_id: type: string description: >- Bắt buộc khi role là tool, tương ứng với tool_calls[].id của nội dung được trả về tại một thời điểm nhất định. tool_calls: type: array items: type: object properties: function: type: object properties: arguments: type: string description: Các tham số dưới dạng chuỗi JSON. name: type: string description: Tên description: Định nghĩa hoặc kết quả của lời gọi hàm x-apifox-orders: - arguments - name x-apidog-orders: - arguments - name id: type: string description: >- Mã định danh lời gọi, thông điệp của công cụ cần tương ứng với tool_call_id. type: type: string enum: - function description: Kiểu x-apifox-orders: - function - id - type x-apidog-orders: - function - id - type description: >- Một danh sách các yêu cầu gọi công cụ (do mô hình khởi tạo) trong thông điệp của trợ lý. refName: Thông điệp x-apifox-orders: - content - name - reasoning_content - role - tool_call_id - tool_calls x-apidog-orders: - content - name - reasoning_content - role - tool_call_id - tool_calls description: >- Danh sách các tin nhắn trong cuộc hội thoại, ít nhất một tin nhắn. Hỗ trợ nhiều lượt: system/user/assistant/tool. model: type: string description: >- ID mô hình cần sử dụng. Cổng sẽ chọn các kênh bằng cách nhóm mã thông báo và có thể thực hiện ánh xạ tên mô hình hoặc phân giải hậu tố (chẳng hạn như -thinking, -search). 'n': type: integer description: >- Dịch tài liệu kỹ thuật này sang tiếng Việt. Giữ nguyên Markdown, mã nguồn, định danh, URL, đường dẫn, phần giữ chỗ, cấu trúc JSON và định dạng. Chỉ trả về văn bản đã dịch và không để lại ký tự Hán nào. Tạo một số phương án trả lời của trợ lý cho cùng một lượt đầu vào. parallel_tool_calls: type: boolean description: >- Có cho phép thực hiện nhiều lệnh gọi công cụ song song trong một phản hồi hay không (khi hệ thống đầu nguồn hỗ trợ). presence_penalty: type: number description: >- Có một hệ số phạt, khoảng -2~2. Giá trị dương làm giảm sự lặp lại của các biểu thức chủ đề đã xuất hiện. reasoning_effort: type: string description: >- Mức độ mạnh của mô hình suy luận (chẳng hạn như thấp / trung bình / cao). Giá trị này cũng có thể được cổng kết nối tự động chèn thông qua hậu tố của tên mô hình. response_format: type: object properties: json_schema: type: object description: Định nghĩa cấu trúc đầu ra khi type=json_schema. x-apidog-orders: [] type: type: string enum: - text - json_object - json_schema description: >- text: văn bản thông thường; json_object: đối tượng JSON; json_schema: đầu ra có cấu trúc theo schema. refName: ResponseFormat x-apifox-orders: - json_schema - type x-apidog-orders: - json_schema - type seed: type: number description: >- Hạt giống ngẫu nhiên, dùng để cố gắng thu được kết quả có thể tái tạo với cùng các tham số (không đảm bảo tính nhất quán hoàn toàn). Lưu ý rằng trường này có tên là seed. stop: oneOf: - type: string - type: array items: type: string description: >- Dừng việc tạo nội dung khi gặp các chuỗi này. Có thể là một chuỗi đơn hoặc một mảng chuỗi (tối đa 4 chuỗi). stream: type: boolean description: >- Có truyền phát đầu ra hay không. false: Trả về toàn bộ JSON trong một lần; true: Đẩy tăng dần qua SSE, kết thúc bằng data: [DONE]. stream_options: type: object properties: include_usage: type: boolean description: >- Liệu mức sử dụng (token prompt/completion) có được bao gồm ở cuối luồng hay không. refName: StreamOptions x-apifox-orders: - include_usage x-apidog-orders: - include_usage temperature: type: number description: >- Nhiệt độ lấy mẫu, thường nằm trong khoảng 0~2. Giá trị càng cao, phản hồi càng ngẫu nhiên; giá trị càng thấp, phản hồi càng ổn định. Thông thường, chỉ điều chỉnh một trong hai tham số này cùng với top_p. tool_choice: oneOf: - type: string enum: - none - auto - required - type: object properties: function: type: object required: - name properties: name: type: string description: Tên hàm bắt buộc phải được gọi. description: Định nghĩa hoặc kết quả của lời gọi hàm x-apifox-orders: - name x-apidog-orders: - name type: type: string x-apifox-orders: - function - type x-apidog-orders: - function - type description: >- Dịch tài liệu kỹ thuật này sang tiếng Việt. Giữ nguyên Markdown, mã, định danh, URL, đường dẫn, phần giữ chỗ, cấu trúc JSON và định dạng. Chỉ trả về văn bản đã dịch và không để lại ký tự Hán nào. Kiểm soát việc có gọi công cụ hay không: none (không gọi), auto (tự động), required (bắt buộc phải gọi), hoặc chỉ định một hàm. tools: type: array items: type: object required: - type - function properties: function: type: object required: - name properties: description: type: string description: >- Phần mô tả chức năng giúp mô hình quyết định thời điểm gọi chức năng đó. name: type: string description: Tên hàm mà mô hình dùng để khởi tạo lệnh gọi. parameters: type: object description: Lược đồ JSON của các tham số hàm. x-apidog-orders: [] description: Định nghĩa hoặc kết quả của lời gọi hàm x-apifox-orders: - description - name - parameters x-apidog-orders: - description - name - parameters type: type: string enum: - function description: Đã sửa thành hàm. refName: Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. x-apifox-orders: - function - type x-apidog-orders: - function - type description: >- Danh sách các công cụ (hàm) mà mô hình có thể gọi, được dùng để gọi hàm trong các cuộc hội thoại. top_p: type: number description: >- Lấy mẫu hạt nhân, 0~1. Chỉ lấy mẫu các token có xác suất tích lũy đạt đến top_p. user: type: string description: >- Mã định danh duy nhất của người dùng cuối giúp phát hiện hành vi lạm dụng và thống kê ở phía nền tảng. web_search_options: type: object properties: search_context_size: type: string enum: - high - medium - low description: >- Kích thước ngữ cảnh tìm kiếm trên Internet; nếu không được truyền, cổng mặc định sử dụng mức trung bình. user_location: type: object description: >- Vị trí địa lý của người dùng, v.v., được sử dụng cho kết quả tìm kiếm đã bản địa hóa (cấu trúc phụ thuộc vào nguồn cung cấp phía trên). x-apidog-orders: [] refName: WebSearchOptions x-apifox-orders: - search_context_size - user_location x-apidog-orders: - search_context_size - user_location refName: V1ChatCompletionsRequest description: >- Chỉ áp dụng cho các tình huống hội thoại nhiều lượt, tương ứng với các trường liên quan đến hội thoại của dto.GeneralOpenAIRequest. Bắt buộc: model, messages (không được để trống). Xác thực: Authorization: Bearer {API Key}. x-apifox-orders: - enable_thinking - extra_body - frequency_penalty - logit_bias - max_completion_tokens - max_tokens - messages - model - 'n' - parallel_tool_calls - presence_penalty - reasoning_effort - response_format - seed - stop - stream - stream_options - temperature - tool_choice - tools - top_p - user - web_search_options x-apidog-orders: - enable_thinking - extra_body - frequency_penalty - logit_bias - max_completion_tokens - max_tokens - messages - model - 'n' - parallel_tool_calls - presence_penalty - reasoning_effort - response_format - seed - stop - stream - stream_options - temperature - tool_choice - tools - top_p - user - web_search_options examples: deepseek_chat: value: extra_body: enable_thinking: true messages: - content: >- Có ba chiếc hộp, chỉ một hộp có phần thưởng. Bạn chọn hộp số 2, người dẫn chương trình mở hộp số 3 (trống), rồi hỏi bạn có muốn đổi sang hộp số 1 không? Hãy phân tích và đưa ra lời khuyên. role: user model: deepseek-chat stream: true stream_options: include_usage: true summary: deepseek_chat description: >- Khuyến nghị nâng cao: Hội thoại suy luận DeepSeek (truyền phát) · stream + extra_body.enable_thinking deepseek_ocr: value: messages: - content: - text: >- Hãy nhận dạng toàn bộ văn bản trong hình ảnh và xuất theo đúng thứ tự của bản gốc, không giải thích. type: text - image_url: detail: cao url: https://example.com/document-scan.png type: image_url role: user model: deepseek-ocr stream: false summary: deepseek_ocr description: >- Khuyến nghị nâng cao: DeepSeek-OCR để nhận dạng văn bản · image_url + từ khóa nhắc nhận dạng hình ảnh gemini_multimodal: value: messages: - content: - text: Trong bức ảnh này có gì? Vui lòng mô tả chi tiết. type: text - image_url: url: >- https://lsky.zhongzhuan.chat/i/2024/10/17/6711068a14527.png type: image_url role: user model: gemini-2.5-flash-all stream: true temperature: 0.5 top_p: 1 summary: gemini_multimodal description: Gemini đa phương thức (khả năng hiểu hình ảnh) gpt4o_audio: value: audio: format: wav voice: hợp kim messages: - content: >- Chó golden retriever có phải là giống chó phù hợp với gia đình không? role: user modalities: - văn bản - âm thanh model: gpt-4o-audio-preview summary: gpt4o_audio description: Đầu ra âm thanh của GPT-4o gpt_4_gizmo_g_2fkfe8rbu: value: messages: - content: Bạn là ai? role: user model: gpt-4-gizmo-g-2fkFE8rbu stream: false summary: gpt_4_gizmo_g_2fkfe8rbu description: Đối thoại GPTs gpt_4o: value: messages: - content: Bạn là một cô gái mèo luôn sẵn lòng giúp đỡ mọi người. role: Vui lòng cung cấp tài liệu kỹ thuật cần dịch. - content: Hãy giúp tôi tóm tắt HTTP là gì. role: user model: gpt-4o summary: gpt_4o description: >- Khuyến nghị cho người mới bắt đầu: hội thoại cơ bản (không truyền phát) gpt_4o_10: value: messages: - content: - text: Tóm tắt nội dung hình ảnh và trả lời theo từng ý. type: text - image_url: detail: cao url: https://example.com/demo.jpg type: image_url role: user model: gpt-4o stream: false summary: gpt_4o_10 description: >- Đề xuất nâng cao: Hình ảnh hội thoại (không truyền phát) · extra_body.google.response_modalities + image_config gpt_4o_11: value: max_tokens: 256 messages: - content: Giới thiệu API gateway là gì trong một câu. role: user model: gpt-4o 'n': 2 temperature: 0.8 summary: gpt_4o_11 description: 'Khuyến nghị nâng cao: nhiều phản hồi ứng viên · n' gpt_4o_12: value: functions: - description: Tra cứu thời tiết thành phố name: get_weather parameters: properties: city: description: Tên thành phố type: string x-i18n: en-US: description: tên thành phố required: - city type: object x-i18n: en-US: description: Kiểm tra thời tiết thành phố messages: - content: Thời tiết ở Bắc Kinh hiện giờ thế nào? role: user model: gpt-4o tool_choice: tự động summary: gpt_4o_12 description: >- Khuyến nghị nâng cao: Gọi hàm (phiên bản cũ) · functions + tool_choice gpt_4o_2: value: messages: - content: >- Hãy dùng 3 câu để giải thích token là gì và đưa ra một ví dụ. role: user model: gpt-4o stream: true stream_options: include_usage: true summary: gpt_4o_2 description: >- Khuyến nghị cho người mới: Hội thoại truyền phát · stream + stream_options.include_usage gpt_4o_3: value: messages: - content: >- Viết một đoạn nội dung quảng bá sản phẩm không quá 200 chữ; khi gặp STOP thì dừng lại. role: user model: gpt-4o stop: - Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. - DỪNG LẠI temperature: 0.4 top_p: 0.9 summary: gpt_4o_3 description: >- Khuyến nghị nâng cao: Kiểm soát lấy mẫu: temperature + top_p + stop gpt_4o_4: value: messages: - content: Thời tiết ở Bắc Kinh hôm nay thế nào? role: user model: gpt-4o tool_choice: tự động tools: - function: description: Lấy thông tin thời tiết của thành phố được chỉ định name: get_weather parameters: properties: city: description: Tên thành phố type: string x-i18n: en-US: description: tên thành phố required: - city type: object x-i18n: en-US: description: >- Lấy thông tin thời tiết cho một thành phố được chỉ định type: function summary: gpt_4o_4 description: 'Khuyến nghị nâng cao: gọi công cụ (tools + tool_choice)' gpt_4o_5: value: messages: - content: >- {"title":"Cách viết tài liệu API","bullets":["Mô tả mục đích, phạm vi và đối tượng sử dụng của API.","Liệt kê URL, phương thức HTTP, tiêu đề yêu cầu và cơ chế xác thực.","Giải thích rõ tham số đường dẫn, tham số truy vấn và nội dung yêu cầu, bao gồm kiểu dữ liệu, điều kiện bắt buộc và giá trị mẫu.","Cung cấp ví dụ yêu cầu và phản hồi, đồng thời giữ nguyên định dạng JSON.","Ghi rõ mã trạng thái HTTP, mã lỗi, thông báo lỗi và cách xử lý.","Nêu quy tắc phân trang, giới hạn tần suất, phiên bản API và lịch sử thay đổi."]} role: user model: gpt-4o response_format: type: json_object summary: gpt_4o_5 description: >- Khuyến nghị nâng cao: Bắt buộc đầu ra có cấu trúc (response_format) gpt_4o_6: value: messages: - content: - text: >- Trong bức ảnh này có gì? Vui lòng mô tả bằng tiếng Trung và đưa ra những bối cảnh có thể xảy ra. type: text - image_url: detail: cao url: https://example.com/image.jpg type: image_url role: user model: gpt-4o summary: gpt_4o_6 description: >- Khuyến nghị nâng cao: Ví dụ đa phương thức: messages.content với hình ảnh (image_url gpt_4o_7: value: messages: - content: >- Gần đây có những bài viết chất lượng cao nào về tác nhân AI? Hãy cung cấp cho tôi 3 bài và mô tả ngắn gọn. role: user model: gpt-4o web_search_options: search_context_size: trung bình summary: gpt_4o_7 description: >- Khuyến nghị nâng cao: Các tùy chọn mạng/tìm kiếm (web_search_options) gpt_4o_8: value: messages: - content: - text: Hãy mô tả bức ảnh này bằng tiếng Trung. type: text - image_url: detail: cao url: https://example.com/demo.jpg type: image_url role: user model: gpt-4o stream: true summary: gpt_4o_8 description: >- Đề xuất nâng cao: Hội thoại bằng hình ảnh và văn bản (truyền liên tục) · stream + image_url.url gpt_4o_9: value: messages: - content: - text: Chữ trong hình là gì? type: text - image_url: detail: tự động url: >- data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg== type: image_url role: user model: gpt-4o stream: true summary: gpt_4o_9 description: >- Khuyến nghị nâng cao: Đối thoại bằng hình ảnh và văn bản (truyền phát) · stream + image_url (base64) o3_mini: value: max_completion_tokens: 2000 messages: - content: >- Chứng minh: Nếu n là số lẻ thì n² cũng là số lẻ. Hãy suy luận từng bước. role: user model: o3-mini reasoning_effort: cao summary: o3_mini description: >- Khuyến nghị nâng cao: Kiểm soát mức độ nỗ lực của mô hình suy luận (reasoning_effort) qwen_max: value: extra_body: enable_thinking: true messages: - content: >- Tính toán: Nếu một hệ thống xử lý 120 yêu cầu mỗi giây, thì trong 5 phút hệ thống đó có thể xử lý bao nhiêu yêu cầu? Hãy trình bày quá trình tính. 5 phút = 5 × 60 = 300 giây Tổng số yêu cầu có thể xử lý = 120 × 300 = 36.000 yêu cầu Đáp án: Hệ thống có thể xử lý 36.000 yêu cầu trong 5 phút. role: user model: qwen-max summary: qwen_max description: >- Khuyến nghị nâng cao: sử dụng chế độ suy luận (`enable_thinking` / `extra_body.enable_thinking`) qwen_mt_turbo: value: messages: - content: >- Vui lòng dịch đoạn tiếng Anh dưới đây sang tiếng Trung giản thể, chỉ xuất bản dịch: Xin chào, chào mừng bạn đến với nền tảng API của chúng tôi. role: user model: qwen-mt-turbo stream: false summary: qwen_mt_turbo description: 'Đề xuất nâng cao: dịch máy · model(qwen-mt) + messages' responses: '200': description: '' content: application/json: schema: type: object required: - id - object - created - model - choices - usage - system_fingerprint - service_tier properties: choices: type: array items: type: object properties: finish_reason: type: string description: 'Lý do kết thúc, ví dụ: stop, length' index: type: integer description: Chỉ mục của mục ứng viên logprobs: type: string description: Thông tin xác suất lôgarit (nếu được bật) nullable: true message: type: object required: - role - content - refusal - annotations properties: annotations: type: array items: type: string description: Chú thích / thông tin trích dẫn content: type: string description: Nội dung tin nhắn hoặc yêu cầu refusal: type: string description: Nội dung từ chối (nếu có) nullable: true role: type: string description: >- Vai trò của tin nhắn, ví dụ: system / user / assistant / model description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - annotations - content - refusal - role x-apidog-orders: - annotations - content - refusal - role x-apifox-orders: - finish_reason - index - logprobs - message x-apidog-orders: - finish_reason - index - logprobs - message description: Danh sách các kết quả ứng viên created: type: integer description: Thời gian tạo (dấu thời gian Unix) id: type: string description: ID tài nguyên hoặc tác vụ model: type: string description: Tên mô hình / mã định danh mô hình object: type: string description: 'Định danh kiểu đối tượng, ví dụ: chat.completion' service_tier: type: string description: Cấp dịch vụ / mức ưu tiên system_fingerprint: type: string description: Dấu vân tay cấu hình phía máy chủ usage: type: object required: - prompt_tokens - completion_tokens - total_tokens - prompt_tokens_details - completion_tokens_details - latency_checkpoint properties: completion_tokens: type: integer description: Số lượng token hoàn thành completion_tokens_details: type: object required: - reasoning_tokens - audio_tokens - accepted_prediction_tokens - rejected_prediction_tokens properties: accepted_prediction_tokens: type: integer description: Số lượng token dự đoán được chấp nhận audio_tokens: type: integer description: Số lượng token liên quan đến âm thanh reasoning_tokens: type: integer description: Số token được sử dụng trong quá trình suy luận rejected_prediction_tokens: type: integer description: Số lượng token dự đoán bị từ chối description: Phân tích chi tiết số token hoàn thành x-apifox-orders: - accepted_prediction_tokens - audio_tokens - reasoning_tokens - rejected_prediction_tokens x-apidog-orders: - accepted_prediction_tokens - audio_tokens - reasoning_tokens - rejected_prediction_tokens latency_checkpoint: type: object required: - engine_tbt_ms - engine_ttft_ms - engine_ttlt_ms - pre_inference_ms - service_tbt_ms - service_ttft_ms - service_ttlt_ms - total_duration_ms - user_visible_ttft_ms properties: engine_tbt_ms: type: integer description: Thời gian giữa các token của engine (ms) engine_ttft_ms: type: integer description: Thời gian của bộ máy đến token đầu tiên (ms) engine_ttlt_ms: type: integer description: Tổng độ trễ của bộ máy (ms) pre_inference_ms: type: integer description: Thời gian chuẩn bị trước khi suy luận (ms) service_tbt_ms: type: integer description: >- Khoảng thời gian giữa các token ở phía dịch vụ (ms) service_ttft_ms: type: integer description: Thời gian từ phía dịch vụ đến mã từ đầu tiên (ms) service_ttlt_ms: type: integer description: Tổng độ trễ phía dịch vụ (ms) total_duration_ms: type: integer description: Tổng thời lượng (ms) user_visible_ttft_ms: type: integer description: >- Thời gian đến token đầu tiên mà người dùng nhìn thấy (ms) description: Thông tin điểm kiểm tra độ trễ x-apifox-orders: - engine_tbt_ms - engine_ttft_ms - engine_ttlt_ms - pre_inference_ms - service_tbt_ms - service_ttft_ms - service_ttlt_ms - total_duration_ms - user_visible_ttft_ms x-apidog-orders: - engine_tbt_ms - engine_ttft_ms - engine_ttlt_ms - pre_inference_ms - service_tbt_ms - service_ttft_ms - service_ttlt_ms - total_duration_ms - user_visible_ttft_ms prompt_tokens: type: integer description: Số lượng token trong lời nhắc prompt_tokens_details: type: object required: - cached_tokens - audio_tokens properties: audio_tokens: type: integer description: Số lượng token liên quan đến âm thanh cached_tokens: type: integer description: Số lượng token trúng bộ nhớ đệm description: Phân tích chi tiết token của lời nhắc x-apifox-orders: - audio_tokens - cached_tokens x-apidog-orders: - audio_tokens - cached_tokens total_tokens: type: integer description: Tổng số token description: Thống kê mức sử dụng token x-apifox-orders: - completion_tokens - completion_tokens_details - latency_checkpoint - prompt_tokens - prompt_tokens_details - total_tokens x-apidog-orders: - completion_tokens - completion_tokens_details - latency_checkpoint - prompt_tokens - prompt_tokens_details - total_tokens refName: V1ChatCompletionsResponse x-apifox-orders: - choices - created - id - model - object - service_tier - system_fingerprint - usage x-apidog-orders: - choices - created - id - model - object - service_tier - system_fingerprint - usage examples: example: summary: example value: choices: - finish_reason: dừng index: 0 logprobs: '' message: annotations: [] content: Xin chào, hôm nay tôi có thể hỗ trợ bạn như thế nào? refusal: '' role: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. created: 1677652288 id: chatcmpl-123 model: gpt-4o object: chat.completion service_tier: mặc định system_fingerprint: fp_abc123 usage: completion_tokens: 12 completion_tokens_details: accepted_prediction_tokens: 0 audio_tokens: 0 reasoning_tokens: 0 rejected_prediction_tokens: 0 latency_checkpoint: engine_tbt_ms: 0 engine_ttft_ms: 0 engine_ttlt_ms: 0 pre_inference_ms: 0 service_tbt_ms: 0 service_ttft_ms: 0 service_ttlt_ms: 0 total_duration_ms: 0 user_visible_ttft_ms: 0 prompt_tokens: 9 prompt_tokens_details: audio_tokens: 0 cached_tokens: 0 total_tokens: 21 headers: {} x-apidog-name: '' '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/sora/định dạng trò chuyện x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209060-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video" Nguồn: https://docs.openaihub.net/api-45209061/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /alibailian/api/v1/services/aigc/video-generation/video-synthesis: post: summary: Tạo video deprecated: false description: >- Diem tao thong nhat cho cac tac vu tong hop video bat dong bo, chang han nhu tao video tu hinh anh/van ban bang Wan va chinh sua video bang HappyHorse, duoc phan biet boi `model`: - Cac mo hinh tao video tu hinh anh cua Wan (vi du: `wan2.5-i2v-preview`): bat buoc phai co `input.img_url` (hinh anh khung hinh dau tien) va `input.prompt`. - `happyhorse-1.0-video-edit`: bat buoc phai co `input.media` (1 video + 0-5 hinh anh tham chieu). Tra ve `output.task_id`; tham do `GET /alibailian/api/v1/tasks/{task_id}` de lay ket qua. operationId: alibailian_video_synthesis tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Thông Nghĩa Vạn Tượng - Xưởng mô hình Alibaba parameters: [] requestBody: content: application/json: schema: type: object required: - model - input properties: input: type: object required: - prompt properties: audio_url: type: string description: >- Tùy chọn. URL âm thanh tùy chỉnh (wav/mp3, 3-30 giây, tối đa 15MB) được dùng làm âm thanh cho video được tạo; chỉ được hỗ trợ bởi các mô hình thuộc dòng Wan 2.5/2.6. Nếu dài hơn `duration`, chỉ 5/10 giây đầu tiên được sử dụng; nếu ngắn hơn, phần video còn lại sẽ không có âm thanh. img_url: type: string description: >- URL hình ảnh khung hình đầu tiên hoặc Base64 (`data:{MIME_type};base64,{data}`), hỗ trợ JPEG/JPG/PNG/BMP/WEBP. **Bắt buộc đối với các mô hình chuyển hình ảnh thành video Wan** (ví dụ: `wan2.5-i2v-preview`); không được `happyhorse-1.0-video-edit` sử dụng (thay vào đó, hãy dùng `media`). media: type: array items: type: object required: - type - url properties: type: type: string description: >- Loại tư liệu phương tiện. Các giá trị tùy chọn là: video: bắt buộc phải được truyền vào. Video cần chỉnh sửa. reference_image: không bắt buộc. Hình ảnh tham chiếu. Các giới hạn về tư liệu: Số lượng video: Chỉ duy nhất một. Số lượng hình ảnh tham chiếu: từ 0 đến 5. url: type: string description: >- Video đầu vào (type=video) URL của video cần chỉnh sửa phải là URL có thể truy cập từ mạng công cộng. Hỗ trợ giao thức HTTP và HTTPS. Giá trị ví dụ: https://xxx/xxx.mp4. Giới hạn đối với video: Định dạng: MP4, MOV (khuyến nghị mã hóa H.264). Thời lượng: 3~60 giây. Độ phân giải: không quá 2160 pixel ở cạnh dài và không dưới 320 pixel ở cạnh ngắn. Tỷ lệ khung hình: 1:2.5~2.5:1. Kích thước tệp: không quá 100MB. Tốc độ khung hình: lớn hơn 8fps. Mô tả Thời lượng video đầu ra: 3~15 giây. Khi video đầu vào không vượt quá 15 giây, thời lượng video đầu ra được giữ nguyên như video đầu vào. Khi video đầu vào vượt quá 15 giây, hệ thống sẽ tự động lấy 15 giây đầu tiên tính từ đầu video làm đoạn hợp lệ, vì vậy thời lượng đầu ra tối đa là 15 giây. Hình ảnh đầu vào (type=reference_image) URL của hình ảnh tham chiếu phải là URL có thể truy cập từ mạng công cộng. Hỗ trợ giao thức HTTP hoặc HTTPS. Giá trị ví dụ: https://xxx/xxx.png. Giới hạn đối với hình ảnh: Định dạng: JPEG, JPG, PNG, WEBP. Độ phân giải: chiều rộng và chiều cao không được dưới 300 pixel. Tỷ lệ khung hình: 1:2.5~2.5:1. Kích thước tệp: không quá 10MB. x-apifox-orders: - type - url x-apidog-orders: - type - url description: >- Danh sach tu lieu phuong tien, dung de chi dinh video va cac hinh anh tham chieu can duoc chinh sua. Mang phai chua 1 phan tu loai video; tuy chon chua tu 0 den 5 phan tu loai reference_image. prompt: type: string description: >- Các từ trong lời nhắc văn bản. Được dùng để mô tả ý định chỉnh sửa video (chuyển đổi phong cách, thay thế một phần, v.v.) cho HappyHorse, hoặc nội dung video cho các mô hình chuyển hình ảnh thành video/chuyển văn bản thành video của Wan. Hỗ trợ đầu vào bằng mọi ngôn ngữ; độ dài không vượt quá 5000 ký tự không phải tiếng Trung hoặc 2500 ký tự tiếng Trung; phần vượt quá sẽ tự động bị cắt bỏ. description: >- Đầu vào. Tùy theo `model`, bắt buộc cung cấp chính xác một trong hai trường: `img_url` (bắt buộc đối với các mô hình Wan chuyển hình ảnh thành video) hoặc `media` (bắt buộc đối với `happyhorse-1.0-video-edit`). x-apifox-orders: - audio_url - img_url - media - prompt x-apidog-orders: - audio_url - img_url - media - prompt model: type: string description: |- Tên mô hình. Giá trị cố định: happyhorse-1.0-video-edit. parameters: type: object properties: audio_setting: type: string description: >- Điều khiển âm thanh (chỉ dành cho `happyhorse-1.0-video-edit`). auto: Giá trị mặc định, do chính mô hình điều khiển. origin: Giữ nguyên âm thanh gốc của video đầu vào. duration: type: integer enum: - 5 - 10 description: >- Thời lượng video tính bằng giây (chỉ dành cho các mô hình Wan), có thể là 5 hoặc 10; thời lượng đầu ra của `happyhorse-1.0-video-edit` được xác định bởi video đầu vào và không sử dụng trường này. prompt_extend: type: boolean description: >- Có bật tính năng viết lại lời nhắc thông minh hay không (chỉ dành cho các mô hình Wan). Khi được bật, một LLM sẽ viết lại lời nhắc đầu vào; tính năng này cải thiện đáng kể kết quả đối với các lời nhắc ngắn nhưng làm tăng độ trễ. resolution: type: string description: |- Mức độ phân giải của video được tạo. Các giá trị tùy chọn: 1080P: Giá trị mặc định. 720P seed: type: integer description: >- Hạt giống ngẫu nhiên (chỉ dành cho các mô hình Wan), phạm vi `[0, 2147483647]`. Được tự động tạo nếu không được chỉ định. watermark: type: boolean description: >- Có thêm biểu trưng hình mờ vào video được tạo hay không. Hình mờ nằm ở góc dưới bên phải của video và nội dung văn bản được cố định là "Happy Horse". true: Giá trị mặc định, thêm hình mờ. false: Không thêm hình mờ. description: tham số x-apifox-orders: - audio_setting - duration - prompt_extend - resolution - seed - watermark x-apidog-orders: - audio_setting - duration - prompt_extend - resolution - seed - watermark refName: >- PostAlibailianApiV1ServicesAigcVideoGenerationVideoSynthesisRequest x-apifox-orders: - input - model - parameters x-apidog-orders: - input - model - parameters examples: happyhorse_1_0_video_edit: value: input: media: - type: video url: >- https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/dozxak/Wan_Video_Edit_33_1.mp4 - type: reference_image url: >- https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260415/hynnff/wan-video-edit-clothes.webp prompt: >- Cho nhân vật đầu ngựa thân người trong video mặc chiếc áo len sọc trong ảnh. model: happyhorse-1.0-video-edit parameters: resolution: 720P summary: happyhorse_1_0_video_edit description: happyhorse-1.0-video-edit wan2_5_i2v_preview: value: input: img_url: >- https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png prompt: Một con mèo đang chạy trên đồng cỏ. model: wan2.5-i2v-preview parameters: duration: 5 resolution: 720P summary: wan2_5_i2v_preview description: Ảnh thành video (Wan 2.5) responses: '200': description: '' content: application/json: schema: type: object required: - request_id - output properties: output: type: object required: - task_id - task_status properties: task_id: type: string description: ID tác vụ bất đồng bộ task_status: type: string description: Trạng thái tác vụ description: Kết quả đầu ra x-apifox-orders: - task_id - task_status x-apidog-orders: - task_id - task_status request_id: type: string description: ID truy vết yêu cầu refName: >- PostAlibailianApiV1ServicesAigcVideoGenerationVideoSynthesisResponse x-apifox-orders: - output - request_id x-apidog-orders: - output - request_id examples: example: summary: example value: output: task_id: 86438901-c911-4bfa-9137-621478c85efd task_status: ĐANG CHỜ request_id: 1445f928-f1b6-9c43-8143-bfaddb5989cf headers: {} x-apidog-name: '' '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/Thông Nghĩa Vạn Tượng x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209061-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn video" Nguồn: https://docs.openaihub.net/api-45209062/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /alibailian/api/v1/tasks/{task_id}: get: summary: Truy vấn video deprecated: false description: >- Truy vấn trạng thái thực thi/kết quả của các tác vụ bất đồng bộ được tạo thông qua `POST /alibailian/api/v1/services/aigc/video-generation/video-synthesis`, v.v. Đây là một trong hai tiền tố đường dẫn cho cùng một tuyến phía máy chủ như `GET /alibailian/tasks/{task_id}`; có thể dùng một trong hai. `output.video_url` hợp lệ khi `task_status` là `SUCCEEDED` (có giới hạn thời gian). operationId: alibailian_get_task_api_path tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Thông Nghĩa Vạn Tượng - Xưởng mô hình Alibaba parameters: - name: task_id in: path description: ID tác vụ bất đồng bộ required: true example: '' schema: type: string responses: '200': description: '' content: application/json: schema: type: object required: - usage - output - request_id properties: output: type: object required: - task_id - end_time - video_url - orig_prompt - submit_time - task_status - actual_prompt - scheduled_time properties: actual_prompt: type: string description: Lời nhắc thực tế đã dùng end_time: type: string description: Thời gian kết thúc orig_prompt: type: string description: Lời nhắc ban đầu scheduled_time: type: string description: Thời gian thực thi theo lịch submit_time: type: string description: Thời gian gửi task_id: type: string description: ID tác vụ bất đồng bộ task_status: type: string description: Trạng thái tác vụ video_url: type: string description: URL video description: Kết quả đầu ra x-apifox-orders: - actual_prompt - end_time - orig_prompt - scheduled_time - submit_time - task_id - task_status - video_url x-apidog-orders: - actual_prompt - end_time - orig_prompt - scheduled_time - submit_time - task_id - task_status - video_url request_id: type: string description: ID truy vết yêu cầu usage: type: object required: - SR - duration - video_count properties: SR: type: integer description: Chỉ số sử dụng liên quan đến siêu phân giải duration: type: integer description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) video_count: type: integer description: Số lượng video description: Thống kê mức sử dụng token x-apifox-orders: - SR - duration - video_count x-apidog-orders: - SR - duration - video_count refName: GetAlibailianApiV1TasksTaskIdResponse x-apifox-orders: - output - request_id - usage x-apidog-orders: - output - request_id - usage examples: example: summary: example value: output: actual_prompt: >- Người đàn ông mặc áo màu cam cưỡi chổi bay vụt qua với tốc độ cao từ bên phải sang bên trái khung hình, cơ thể chúi về phía trước, hai tay nắm chặt cán chổi, đầu hướng thẳng về trước, miệng há ra và hét lớn: 'Này! Đừng cản tôi!'. Cây chổi di chuyển nhanh trong không trung, phần lông chổi bị nhòe do tốc độ. Ba người phía dưới đứng trên vỉa hè, cầm đũa phép chĩa về phía người đang bay trên không; đầu họ hơi xoay theo hướng bay của người đó và mắt dõi theo hành động của anh ta. Ở hậu cảnh liên tục vang lên tiếng xe cộ trên đường phố, tiếng người đi bộ trò chuyện, tiếng gió và tiếng rít khi cây chổi xé qua không khí. end_time: '2025-10-11T19:02:27.297Z' orig_prompt: Điều chỉnh ánh sáng một chút scheduled_time: '2025-10-11T18:55:57.908Z' submit_time: '2025-10-11T18:55:56.952Z' task_id: a55bfe14-6e78-4b9d-b97d-128420399ed1 task_status: THÀNH CÔNG video_url: >- https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/1d/21/20251011/9b1c82b0/a55bfe14-6e78-4b9d-b97d-128420399ed1.mp4?Expires=1760266939&OSSAccessKeyId=LTAI5tDUB1cEqFCYhEwWry26&Signature=Fjpx1uAlmLmeYGWx0Ye7n%2F%2F9Isw%3D request_id: ec8f059e-f2e5-4887-bb43-3306cd38f403 usage: SR: 480 duration: 5 video_count: 1 headers: {} x-apidog-name: '' '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/Thông Nghĩa Vạn Tượng x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209062-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Video mở rộng" Nguồn: https://docs.openaihub.net/api-45209063/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/extend: post: summary: Video mở rộng deprecated: false description: >- Chuỗi video hợp nhất VEO · kéo dài một video hiện có (`POST /v1/video/extend`); tính năng kéo dài Grok-Video sử dụng tuyến này tùy theo mô hình. operationId: veo_video_extend tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/hiểu thấu đáo/Định dạng hợp nhất cho video - Video hợp nhất · VEO parameters: [] requestBody: content: application/json: schema: type: object required: - model - task_id properties: model: type: string description: Tên mô hình examples: - grok-video parent_post_id: type: string description: ID bài đăng gốc (Grok-Video) prompt: type: string description: Mở rộng phần mô tả task_id: type: string description: ID tác vụ video gốc refName: PostV1VideoExtendRequest x-apifox-orders: - model - parent_post_id - prompt - task_id x-apidog-orders: - model - parent_post_id - prompt - task_id examples: grok_video: value: model: grok-video prompt: Tiếp tục cảnh đại bàng hạ cánh task_id: task_abc123 summary: grok_video description: mở rộng video responses: '200': description: Tác vụ tiện ích mở rộng đã được tạo thành công content: application/json: schema: type: object properties: enhanced_prompt: type: string description: >- Các từ trong lời nhắc đã được tối ưu hóa Các từ trong lời nhắc đã được tối ưu hóa id: type: string description: Mã tác vụ Mã tác vụ progress: oneOf: - type: integer - type: string description: phần trăm tiến độ phần trăm tiến độ status: type: string enum: - pending - image_downloading - video_generating - video_generation_completed - video_upsampling - completed - failed description: trạng thái tác vụ trạng thái tác vụ status_update_time: type: integer description: >- dấu thời gian cập nhật trạng thái dấu thời gian cập nhật trạng thái video_url: type: string description: >- URL video (sẽ có sau khi hoàn tất) URL video (sẽ có sau khi hoàn tất) refName: UnifiedVideoResponse x-apifox-orders: - enhanced_prompt - id - progress - status - status_update_time - video_url x-apidog-orders: - enhanced_prompt - id - progress - status - status_update_time - video_url examples: example: summary: example value: enhanced_prompt: chuỗi id: string progress: 0 status: pending status_update_time: 0 video_url: chuỗi headers: {} x-apidog-name: Tác vụ tiện ích mở rộng đã được tạo 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/hiểu thấu đáo/Định dạng hợp nhất cho video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209063-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video" Nguồn: https://docs.openaihub.net/api-45209064/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/create: post: summary: Tạo video deprecated: false description: >- Omni-Flash · tạo video hợp nhất (`POST /v1/video/create`, tuyến vật lý chuyển tiếp VEO; xem `relay/veo` là tuyến chính). `model=omni-flash` / `omni-flash-edit` định tuyến đến quy trình Omni-Flash; `type` chọn khả năng: - `1` = chuyển văn bản thành video (chỉ yêu cầu `prompt`) - `2` = khung hình đầu/cuối (`images` yêu cầu 1-2 mục) - `3` = hình ảnh tham chiếu (`images` yêu cầu 1-3 mục) - `4` = chỉnh sửa video Omni-Flash (yêu cầu `input_reference`) Trả về `id` (ID tác vụ); thăm dò `GET /v1/video/query?id=` để nhận kết quả. operationId: omni_video_create tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/hiểu thấu đáo/Định dạng hợp nhất cho video - Omni parameters: - name: Content-Type in: header description: Định dạng dữ liệu phần thân yêu cầu required: false example: application/json schema: type: string - name: Accept in: header description: Định dạng dữ liệu phản hồi mà máy khách dự kiến nhận được required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa xác thực API, định dạng là Bearer + dấu cách + khóa API của bạn required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model - prompt properties: aspect_ratio: type: string enum: - '16:9' - '9:16' description: tỷ lệ khung hình enable_sample: type: boolean description: >- Dòng Omni-Flash chuyển sang 1080p (bỏ qua đối với các mẫu 4K) enable_upsample: type: boolean description: >- Đã nâng cấp lên 1080p (khả dụng trên một số mẫu 4K nhất định) images: type: array items: type: string format: uri description: >- Mảng URL hình ảnh (type=2 yêu cầu 1-2 hình ảnh, type=3 yêu cầu 1-3 hình ảnh) input_reference: type: string description: >- Video tham chieu chinh sua Omni-Flash (canh JSON duoc truyen den URL hoac dataURI) model: type: string description: 'Tên mô hình (ví dụ: omni-flash, omni-flash-edit)' prompt: type: string description: Mô tả nội dung video seconds: type: string description: 'Thời lượng video (giây), ví dụ: "8"' size: type: string description: >- Kích thước tùy chỉnh, tỷ lệ chiều rộng là 16:9 và tỷ lệ chiều cao là 9:16. Khi aspect_ratio có hiệu lực, tham số này không còn giá trị. type: type: integer enum: - 1 - 2 - 3 - 4 description: >- Loại tạo sinh: 1=Video từ văn bản, 2=Khung hình đầu và cuối, 3=Tham chiếu nhiều hình ảnh, 4=Chỉnh sửa video Omni-Flash allOf: - type: string - type: string - type: string - type: string refName: PostV1VideoCreateRequest x-apifox-orders: - aspect_ratio - enable_sample - enable_upsample - images - input_reference - model - prompt - seconds - size - type x-apidog-orders: - aspect_ratio - enable_sample - enable_upsample - images - input_reference - model - prompt - seconds - size - type examples: omni_flash: value: model: omni-flash prompt: xin chào thế giới summary: omni_flash description: >- Khuyến nghị cho người mới bắt đầu: Yêu cầu tối thiểu cho người mới bắt đầu · Kiến thức cơ bản về tạo sinh từ văn bản · mô hình+lời nhắc omni_flash_2: value: aspect_ratio: '16:9' model: omni-flash prompt: Cảnh hoàng hôn bên bờ biển quay từ trên không seconds: '8' summary: omni_flash_2 description: >- Khuyên dùng cho người mới bắt đầu: Màn hình ngang tiêu chuẩn · Vincent Video · model+prompt+aspect_ratio+seconds omni_flash_3: value: aspect_ratio: '9:16' model: omni-flash prompt: Nhân vật đường phố quay chậm seconds: '8' summary: omni_flash_3 description: >- Khuyến nghị cho người mới bắt đầu: tiêu chuẩn màn hình dọc · Vincent Video · model+prompt+aspect_ratio+seconds omni_flash_4: value: images: - >- https://ts1.tc.mm.bing.net/th/id/R-C.8dbf8e136e7d71653b63fdbd4d17fb6c?rik=KEcgD1%2fwKEKc9A&riu=http%3a%2f%2fimg.xintp.com%2f2019%2f12%2f10%2fxl5gp5kgesw.jpg&ehk=j5IVfJ0NDf2S9Ki9dJ7uXRMGlqubf9rR8TGsNLZP%2fMQ%3d&risl=&pid=ImgRaw&r=0 - >- https://ts1.tc.mm.bing.net/th/id/R-C.ef98ae99612a621c19aaf5c02df8590a?rik=bpRpplfXRRo8pA&riu=http%3a%2f%2fimg95.699pic.com%2fphoto%2f50166%2f6903.jpg_wh300.jpg&ehk=yf0pMNdv%2bxIdqiWephK%2fg%2bt9K%2fTLDd8Db46yw8Q%2bSXM%3d&risl=&pid=ImgRaw&r=0 model: omni-flash prompt: Chuyển tiếp mượt mà giữa khung hình đầu và cuối seconds: '8' summary: omni_flash_4 description: >- Khuyên dùng cho người mới bắt đầu: Chuyển tiếp giữa hai hình ảnh · Tạo khung hình đầu và cuối · mô hình+lời nhắc+hình ảnh+số giây omni_flash_5: value: images: - >- https://static.jokers.pub/upload/ai/728c4393-77ee-441a-99fa-ea1c294035a1/Image-91o3qgbn15t9o2k/1779515038884-1742.jpg model: omni-flash prompt: Tạo video giữ nguyên phong cách của chủ thể chính seconds: '8' summary: omni_flash_5 description: >- Khuyến nghị cho người mới bắt đầu: tham chiếu một ảnh · tạo ảnh tham chiếu đệm · mô hình+câu lệnh+ảnh+số giây omni_flash_6: value: aspect_ratio: '9:16' images: - >- https://ts2.tc.mm.bing.net/th/id/OIP-C.iBy7zllJXvjrzOH-VdwH_gHaEK?rs=1&pid=ImgDetMain&o=7&rm=3 - https://imgs.699pic.com/images/600/406/117.jpg!list1x.v2 - >- https://ts2.tc.mm.bing.net/th/id/OIP-C.thJJkD55hZLuc-D86OW7bgHaEW?rs=1&pid=ImgDetMain&o=7&rm=3 model: omni-flash prompt: >- Kết hợp chủ thể và phong cách phối màu của ba hình ảnh tham khảo seconds: '8' summary: omni_flash_6 description: >- Khuyến nghị nâng cao: Kết hợp ba hình ảnh · Tạo hình ảnh tham chiếu Mat · model+prompt+images+aspect_ratio+seconds omni_flash_7: value: model: omni-flash prompt: Video tua nhanh Thành phố Chân trời seconds: '8' type: 1 summary: omni_flash_7 description: >- Khuyến nghị nâng cao: kiểu tường minh Vincent · lệnh gọi tương thích với Vincent · mô hình+lời nhắc+kiểu+số giây omni_flash_edit: value: input_reference: https://example.com/input.mp4 model: omni-flash-edit prompt: Chuyển video gốc sang phong cách điện ảnh type: 4 summary: omni_flash_edit description: >- Khuyến nghị cho người mới bắt đầu: Kiến thức cơ bản về chỉnh sửa URL · Chỉnh sửa video · model+prompt+input_reference+seconds omni_flash_edit_datauri: value: input_reference: >- https://cdn.dealonhorizon.us/video/d2fa3281de7a69f3ac07b3451cf922e3ba609daad00d081674b283a63de67e54.mp4 model: omni-flash-edit prompt: Nâng cao màu sắc và ánh sáng type: 4 summary: omni_flash_edit_datauri description: >- Khuyến nghị nâng cao: Chỉnh sửa DataURI · Chỉnh sửa video · model+prompt+input_reference(dataURI)+seconds responses: '200': description: '' content: application/json: schema: type: object required: - id - status - status_update_time properties: id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái refName: PostV1VideoCreateResponse x-apifox-orders: - id - status - status_update_time x-apidog-orders: - id - status - status_update_time examples: example: summary: example value: id: omni-flash_X:task_uAbDkbRmcOafvSBBmNWwQkIA1gvTdoaX status: queued status_update_time: 1779950697931 headers: {} x-apidog-name: '' '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/hiểu thấu đáo/Định dạng hợp nhất cho video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209064-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Các tác vụ truy vấn" Nguồn: https://docs.openaihub.net/api-45209065/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/query: get: summary: Các tác vụ truy vấn deprecated: false description: >- Omni-Flash · truy vấn tác vụ (`GET /v1/video/query`, tuyến vật lý chuyển tiếp VEO; xem `relay/veo` là tuyến chính). Truy vấn trạng thái/kết quả của một tác vụ Omni-Flash được tạo qua `POST /v1/video/create`; khi `status=failed`, `error` cung cấp lý do thất bại. operationId: omni_video_query tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/hiểu thấu đáo/Định dạng hợp nhất cho video - Omni parameters: - name: id in: query description: ID tài nguyên / tác vụ trong đường dẫn required: false example: omni-flash:1779717386-QYRfzV5zLK schema: type: string - name: model in: query description: Tên mô hình required: false example: omni-flash schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: error: Tạo video thất bại id: omni-flash:1779717386-QYRfzV5zLK status: failed status_update_time: 1779717416 headers: {} x-apidog-name: '' '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/hiểu thấu đáo/Định dạng hợp nhất cho video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209065-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "openai tạo video, hình ảnh và video" Nguồn: https://docs.openaihub.net/api-45209066/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos: post: summary: openai tạo video, hình ảnh và video deprecated: false description: '' operationId: post-v1-videos tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/hiểu thấu đáo/Định dạng video OpenAI - hiểu thấu đáo parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: input_reference: type: string description: URL hình ảnh examples: - '' example: '' model: type: string description: Tên mô hình examples: - grok-videos example: grok-videos prompt: type: string description: Lời nhắc examples: - Để chú bò vui vẻ nhảy điệu Khoa Mục Ba example: Để chú bò vui vẻ nhảy điệu Khoa Mục Ba seconds: type: number description: Thời lượng 6s / 10s examples: - 6 example: 6 size: type: string description: 16:9 , 9:16 examples: - '16:9' example: '16:9' required: - model - prompt examples: example: value: input_reference: '' model: grok-videos prompt: Để chú bò vui vẻ nhảy điệu Khoa Mục Ba seconds: 6 size: '16:9' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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/hiểu thấu đáo/Định dạng video OpenAI x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209066-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Các tác vụ truy vấn" Nguồn: https://docs.openaihub.net/api-45209067/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/query: get: summary: Các tác vụ truy vấn deprecated: false description: >- Omni-Flash · truy vấn tác vụ (`GET /v1/video/query`, tuyến vật lý chuyển tiếp VEO; xem `relay/veo` là tuyến chính). Truy vấn trạng thái/kết quả của một tác vụ Omni-Flash được tạo qua `POST /v1/video/create`; khi `status=failed`, `error` cung cấp lý do thất bại. operationId: omni_video_query tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/hiểu thấu đáo/Định dạng video OpenAI - Omni parameters: - name: id in: query description: ID tài nguyên / tác vụ trong đường dẫn required: false example: omni-flash:1779717386-QYRfzV5zLK schema: type: string - name: model in: query description: Tên mô hình required: false example: omni-flash schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: error: Tạo video thất bại id: omni-flash:1779717386-QYRfzV5zLK status: failed status_update_time: 1779717416 headers: {} x-apidog-name: '' '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/hiểu thấu đáo/Định dạng video OpenAI x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209067-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video" Nguồn: https://docs.openaihub.net/api-45209068/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos/generations: post: summary: Tạo video deprecated: false description: >- Grok Imagine chuyển văn bản/hình ảnh thành video (`POST /v1/videos/generations`). Điểm truy cập JSON gốc của xAI; thăm dò qua `GET /v1/videos/{id}`. operationId: grok_v1_videos_generations tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/hiểu thấu đáo/định dạng chính thức - Grok parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: '' schema: type: string requestBody: content: application/json: schema: type: object required: - model - prompt - resolution - aspect_ratio - duration properties: aspect_ratio: type: string description: ("1:1" | "16:9" | "9:16") duration: type: integer description: '[1, 15]' image: type: object required: - url properties: url: type: string description: URL tài nguyên description: Không thể sử dụng cùng với reference_images x-apifox-orders: - url x-apidog-orders: - url model: type: string description: grok-imagine-video, grok-imagine-video-1.5-preview prompt: type: string description: từ trong lời nhắc reference_images: type: array items: type: object properties: url: type: string description: URL tài nguyên x-apifox-orders: - url x-apidog-orders: - url description: Không thể sử dụng cùng với reference_images resolution: type: string description: ("480p" | "720p") refName: PostV1VideosGenerationsRequest x-apifox-orders: - aspect_ratio - duration - image - model - prompt - reference_images - resolution x-apidog-orders: - aspect_ratio - duration - image - model - prompt - reference_images - resolution examples: {} responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: aspect_ratio: '16:9' duration: 4 model: grok-imagine-video prompt: >- Một hồ nước thanh bình lúc bình minh, với màn sương trôi là là trên mặt nước resolution: 480p headers: {} x-apidog-name: '' '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/hiểu thấu đáo/định dạng chính thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209068-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Chỉnh sửa video" Nguồn: https://docs.openaihub.net/api-45209069/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos/edits: post: summary: Chỉnh sửa video deprecated: false description: >- Chỉnh sửa video bằng Grok Imagine (`POST /v1/videos/edits`). Được hỗ trợ bởi các mô hình grok-imagine-video; thăm dò trạng thái qua `GET /v1/videos/{id}`. operationId: grok_v1_videos_edits tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/hiểu thấu đáo/định dạng chính thức - Grok parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: '' schema: type: string requestBody: content: application/json: schema: type: object required: - model - prompt - resolution - aspect_ratio - video properties: aspect_ratio: type: string description: ("1:1" | "16:9" | "9:16" ) model: type: string description: grok-imagine-video prompt: type: string description: từ trong lời nhắc resolution: type: string description: ("480p" | "720p") video: type: object required: - url properties: url: type: string description: URL tài nguyên description: URL hoặc mã định danh video x-apifox-orders: - url x-apidog-orders: - url refName: PostV1VideosEditsRequest x-apifox-orders: - aspect_ratio - model - prompt - resolution - video x-apidog-orders: - aspect_ratio - model - prompt - resolution - video examples: {} responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: aspect_ratio: '16:9' model: grok-imagine-video prompt: Đeo cho người phụ nữ một chiếc vòng cổ bạc. resolution: 480p video: url: >- https://imageproxy.zhongzhuan.chat/api/proxy/image/5dada4bd5c095d1062b79582a51481bf.mp4 headers: {} x-apidog-name: '' '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/hiểu thấu đáo/định dạng chính thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209069-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn video" Nguồn: https://docs.openaihub.net/api-45209070/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/videos/{id}: get: summary: Truy vấn video deprecated: false description: >- Truy vấn trạng thái tác vụ Grok Imagine (`GET /v1/videos/{id}`). Dùng chung tuyến vật lý với Sora; phân biệt bằng ID tác vụ / mô hình. Thăm dò các tác vụ được gửi qua `POST /v1/videos/generations` hoặc `POST /v1/videos/edits`. operationId: grok_v1_videos tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/hiểu thấu đáo/định dạng chính thức - Grok parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: sora-2:task_01k81e7r1mf0qtvp3ett3mr4jm schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: true example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string - name: X-Forwarded-Host in: header description: Host gốc được chuyển tiếp (trường hợp proxy) required: false example: localhost:5173 schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: {} examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: enhanced_prompt: type: string description: Lời nhắc nâng cao id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái video_url: type: string description: URL video refName: GetV1VideosIdResponse x-apifox-orders: - enhanced_prompt - id - status - status_update_time - video_url x-apidog-orders: - enhanced_prompt - id - status - status_update_time - video_url examples: '1': summary: '1' value: '[long payload omitted: 1,869 units]' '2': summary: '2' value: completed_at: 1761622385 created_at: 1761622232 enhanced_prompt: '' id: video_5c6a605a-30c0-4a6a-9dbd-d1d6cfdd9980 model: sora-2 object: video progress: 100 seconds: '10' size: 1280x720 status: completed status_update_time: 1761622385 video_url: >- https://midjourney-plus.oss-us-west-1.aliyuncs.com/sora/cc4fb429-22a5-4747-a6f9-a6badccf8f42.mp4 headers: {} x-apidog-name: '' '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/hiểu thấu đáo/định dạng chính thức x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209070-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ video Tusheng" Nguồn: https://docs.openaihub.net/api-45209071/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /ent/v2/img2video: post: summary: Tạo tác vụ video Tusheng deprecated: false description: Tạo một video từ khung hình đầu tiên của hình ảnh. operationId: vidu_img2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ - Ví dụ parameters: [] requestBody: content: application/json: schema: type: object required: - model - images properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '4:3' - '3:4' - '1:1' - auto description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' audio: type: boolean description: Tham số hoặc URL liên quan đến âm thanh callback_url: type: string description: URL gọi lại khi hoàn tất tác vụ duration: type: integer description: Thời lượng video (giây) images: type: array items: type: string description: URL hình ảnh khung hình đầu tiên, chỉ 1 model: type: string description: Tên mô hình prompt: type: string description: từ gợi ý văn bản resolution: type: string description: Độ phân giải, chẳng hạn như 720p/1080p seed: type: integer description: Hạt giống ngẫu nhiên, 0 là ngẫu nhiên watermark: type: boolean description: Có thêm hình mờ hay không refName: PostEntV2Img2videoRequest x-apifox-orders: - aspect_ratio - audio - callback_url - duration - images - model - prompt - resolution - seed - watermark x-apidog-orders: - aspect_ratio - audio - callback_url - duration - images - model - prompt - resolution - seed - watermark examples: viduq2_pro: value: duration: 5 images: - https://example.com/frame.jpg model: viduq2-pro prompt: Máy quay từ từ tiến lại gần summary: viduq2_pro description: video từ ảnh responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công 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/Ví dụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209071-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo một tác vụ video học viên tham chiếu (cuộc gọi chủ thể)" Nguồn: https://docs.openaihub.net/api-45209072/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /ent/v2/reference2video: post: summary: Tạo một tác vụ video học viên tham chiếu (cuộc gọi chủ thể) deprecated: false description: Tạo video từ nhiều hình ảnh/video tham chiếu. operationId: vidu_reference2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ - Ví dụ parameters: [] requestBody: content: application/json: schema: type: object required: - model - prompt properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '4:3' - '3:4' - '1:1' - auto description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' callback_url: type: string description: URL gọi lại khi hoàn tất tác vụ duration: type: integer description: Thời lượng video (giây) images: type: array items: type: string description: Danh sách URL hình ảnh hoặc chuỗi Base64 model: type: string description: Tên mô hình prompt: type: string description: từ gợi ý văn bản resolution: type: string description: Độ phân giải, chẳng hạn như 720p/1080p seed: type: integer description: Hạt giống ngẫu nhiên, 0 là ngẫu nhiên subjects: type: array items: type: object properties: id: type: string description: ID tài nguyên hoặc tác vụ images: type: array items: type: string description: Danh sách URL hình ảnh hoặc chuỗi Base64 name: type: string description: Tên x-apifox-orders: - id - images - name x-apidog-orders: - id - images - name description: Danh sách tham chiếu chủ thể / ký tự watermark: type: boolean description: Có thêm hình mờ hay không refName: PostEntV2Reference2videoRequest x-apifox-orders: - aspect_ratio - callback_url - duration - images - model - prompt - resolution - seed - subjects - watermark x-apidog-orders: - aspect_ratio - callback_url - duration - images - model - prompt - resolution - seed - subjects - watermark examples: {} responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công 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/Ví dụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209072-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ video để tạo khung hình đầu và cuối" Nguồn: https://docs.openaihub.net/api-45209073/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /ent/v2/start-end2video: post: summary: Tạo tác vụ video để tạo khung hình đầu và cuối deprecated: false description: Khung hình đầu tiên + khung hình cuối cùng tạo ra một video chuyển cảnh. operationId: vidu_start_end2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ - Ví dụ parameters: [] requestBody: content: application/json: schema: type: object required: - model - images properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '4:3' - '3:4' - '1:1' - auto description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' callback_url: type: string description: URL gọi lại khi hoàn tất tác vụ duration: type: integer description: Thời lượng video (giây) images: type: array items: type: string description: Danh sách URL hình ảnh hoặc chuỗi Base64 model: type: string description: Tên mô hình prompt: type: string description: từ gợi ý văn bản resolution: type: string description: Độ phân giải, chẳng hạn như 720p/1080p seed: type: integer description: Hạt giống ngẫu nhiên, 0 là ngẫu nhiên watermark: type: boolean description: Có thêm hình mờ hay không refName: PostEntV2StartEnd2videoRequest x-apifox-orders: - aspect_ratio - callback_url - duration - images - model - prompt - resolution - seed - watermark x-apidog-orders: - aspect_ratio - callback_url - duration - images - model - prompt - resolution - seed - watermark examples: {} responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công 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/Ví dụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209073-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ sinh ảnh" Nguồn: https://docs.openaihub.net/api-45209074/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /ent/v2/reference2image: post: summary: Tạo tác vụ sinh ảnh deprecated: false description: Tạo hình ảnh từ ảnh tham chiếu. operationId: vidu_reference2image tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ - Ví dụ parameters: [] requestBody: content: application/json: schema: type: object required: - model - prompt properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '4:3' - '3:4' - '1:1' - auto description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' images: type: array items: type: string description: Danh sách URL hình ảnh hoặc chuỗi Base64 model: type: string description: Tên mô hình prompt: type: string description: từ gợi ý văn bản resolution: type: string description: Độ phân giải, chẳng hạn như 720p/1080p refName: PostEntV2Reference2imageRequest x-apifox-orders: - aspect_ratio - images - model - prompt - resolution x-apidog-orders: - aspect_ratio - images - model - prompt - resolution examples: {} responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công 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/Ví dụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209074-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo một tác vụ âm thanh Vincent" Nguồn: https://docs.openaihub.net/api-45209075/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /ent/v2/text2audio: post: summary: Tạo một tác vụ âm thanh Vincent deprecated: false description: Tạo âm thanh dựa trên mô tả văn bản. operationId: vidu_text2audio tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ - Ví dụ parameters: [] requestBody: content: application/json: schema: type: object required: - model - prompt properties: duration: type: number description: 2–10 giây model: type: string description: Tên mô hình / mã định danh mô hình examples: - audio1.0 prompt: type: string description: Lời nhắc văn bản refName: PostEntV2Text2audioRequest x-apifox-orders: - duration - model - prompt x-apidog-orders: - duration - model - prompt examples: {} responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công 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/Ví dụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209075-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tổng hợp giọng nói" Nguồn: https://docs.openaihub.net/api-45209076/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /ent/v2/audio-tts: post: summary: Tổng hợp giọng nói deprecated: false description: Chuyển văn bản thành giọng nói. operationId: vidu_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ - Ví dụ parameters: [] requestBody: content: application/json: schema: type: object required: - text - voice_setting_voice_id properties: text: type: string description: Văn bản cần được tổng hợp voice_setting_pitch: type: integer description: Cao độ voice_setting_speed: type: number description: Tốc độ nói voice_setting_voice_id: type: string description: Mã giọng nói voice_setting_volume: type: integer description: Âm lượng refName: ViduSampleRequest x-apifox-orders: - text - voice_setting_pitch - voice_setting_speed - voice_setting_voice_id - voice_setting_volume x-apidog-orders: - text - voice_setting_pitch - voice_setting_speed - voice_setting_voice_id - voice_setting_volume examples: {} responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: Được '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/Ví dụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209076-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo một tác vụ video Vincent" Nguồn: https://docs.openaihub.net/api-45209077/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /ent/v2/text2video: post: summary: Tạo một tác vụ video Vincent deprecated: false description: Tạo video dựa trên các từ trong lời nhắc văn bản. operationId: vidu_text2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ - Ví dụ parameters: [] requestBody: content: application/json: schema: type: object required: - model - prompt properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '4:3' - '3:4' - '1:1' - auto description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' bgm: type: boolean description: Có thêm nhạc nền hay không callback_url: type: string description: URL gọi lại khi hoàn tất tác vụ duration: type: integer description: Thời lượng video (giây) model: type: string description: Tên mô hình prompt: type: string description: từ gợi ý văn bản resolution: type: string description: Độ phân giải, chẳng hạn như 720p/1080p seed: type: integer description: Hạt giống ngẫu nhiên, 0 là ngẫu nhiên style: type: string enum: - general - anime description: Tham số phong cách watermark: type: boolean description: Có thêm hình mờ hay không refName: PostEntV2Text2videoRequest x-apifox-orders: - aspect_ratio - bgm - callback_url - duration - model - prompt - resolution - seed - style - watermark x-apidog-orders: - aspect_ratio - bgm - callback_url - duration - model - prompt - resolution - seed - style - watermark examples: viduq2: value: aspect_ratio: '16:9' duration: 5 model: viduq2 prompt: Một con mèo đang chạy trên đồng cỏ. summary: viduq2 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công 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/Ví dụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209077-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Lấy kết quả yêu cầu" Nguồn: https://docs.openaihub.net/api-45209078/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /ent/v2/tasks/{id}/creations: get: summary: Lấy kết quả yêu cầu deprecated: false description: Truy vấn để tạo kết quả dựa trên mã tác vụ. operationId: vidu_task_creations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ - Ví dụ parameters: - name: id in: path description: ID tài nguyên / tác vụ trong đường dẫn required: true example: '' schema: type: string responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: thành công '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/Ví dụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209078-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video" Nguồn: https://docs.openaihub.net/api-45209079/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /vidu-native/video/generations: post: summary: Tạo video deprecated: false description: '' operationId: post-vidu-native-video-generations tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ/Định dạng hợp nhất cho video - ví dụ parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: true example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model - prompt - aspect_ratio - size - images properties: aspect_ratio: type: string description: 'tùy chọn: 2:3, 3:2, 1:1' images: type: array items: type: string description: liên kết hình ảnh model: type: string description: |- Tên mô hình. Các giá trị liệt kê phổ biến: viduq2 viduq2-pro viduq2-turbo viduq3-pro viduq3-turbo examples: - viduq2 prompt: type: string description: Lời nhắc size: type: string description: 720P hoặc 1080P x-apifox-orders: - aspect_ratio - images - model - prompt - size x-apidog-orders: - aspect_ratio - images - model - prompt - size examples: example: value: aspect_ratio: '1:1' images: - https://example.com/ref.png model: viduq2 prompt: Một chú mèo con đáng yêu đang chơi đùa trong vườn. settings: settings: aspect_ratio: '16:9' duration: 4 resolution: 1080p size: 1080P summary: example responses: '200': description: '' content: application/json: schema: type: object required: - id - status - status_update_time properties: id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái x-apifox-orders: - id - status - status_update_time x-apidog-orders: - id - status - status_update_time examples: '1': summary: '1' value: id: viduq2:1762241017-xTL0P9HvGF status: pending status_update_time: 1762241017286 '2': summary: '2' value: id: 033fa60e-f37c-4ff6-a44d-5585ffea938d status: processing status_update_time: 1764522528 headers: {} x-apidog-name: '' '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/Ví dụ/Định dạng hợp nhất cho video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209079-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Các tác vụ truy vấn" Nguồn: https://docs.openaihub.net/api-45209080/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /vidu-native/video/generations/{task_id}: get: summary: Các tác vụ truy vấn deprecated: false description: >- Với một lời nhắc, mô hình trả về một hoặc nhiều phần hoàn tất được dự đoán và tùy chọn xác suất của token. Tạo một phần hoàn tất cho lời nhắc và các tham số đã cung cấp operationId: get-vidu-native-video-generations-task-id tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ/Định dạng hợp nhất cho video - ví dụ parameters: - name: task_id in: path description: ID tác vụ bất đồng bộ required: true example: '' schema: type: string - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: true example: application/json schema: type: string - name: Accept in: header description: Content-Type dự kiến của phản hồi required: true example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string - name: X-Forwarded-Host in: header description: Host gốc được chuyển tiếp (trường hợp proxy) required: false example: localhost:5173 schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: {} examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - status - status_update_time properties: enhanced_prompt: type: string description: Lời nhắc nâng cao id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái video_url: type: string description: URL video nullable: true x-apifox-orders: - enhanced_prompt - id - status - status_update_time - video_url x-apidog-orders: - enhanced_prompt - id - status - status_update_time - video_url examples: '1': summary: '1' value: enhanced_prompt: >- ``` Một bức tranh kỹ thuật số siêu thực và kỳ ảo về một cô bò nâu oai vệ với đôi cánh lớn phủ đầy lông vũ, đang duyên dáng bay vút qua bầu trời xanh rực rỡ. Cô bò mang vẻ mặt vui sướng, chiếc đuôi tung bay phía sau khi lướt giữa những đám mây trắng bồng bềnh. Bên dưới, những mảng đất nông nghiệp xanh tươi trải dài đến tận chân trời, điểm xuyết các công trình nông trại nhỏ bé và một nhóm nông dân sửng sốt đang ngước nhìn đầy kinh ngạc. Khung cảnh ngập trong ánh nắng vàng ấm áp, tạo nên bầu không khí tựa giấc mơ và đầy phép màu. Phong cách nghệ thuật lấy cảm hứng từ tranh minh họa kỳ ảo, với những nét cọ mềm mại và màu sắc phong phú, rực rỡ. ``` id: 033fa60e-f37c-4ff6-a44d-5585ffea938d status: pending status_update_time: 1750323167003 '2': summary: '2' value: completed_at: 1764522552 id: 033fa60e-f37c-4ff6-a44d-5585ffea938d model: viduq2 progress: 100 prompt: Một con mèo đang chạy trên đồng cỏ. status: completed status_update_time: 1764522552 thumbnail_url: https://example.com/vidu/thumb.jpg video_url: https://example.com/vidu/output.mp4 headers: {} x-apidog-name: '' '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/Ví dụ/Định dạng hợp nhất cho video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209080-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ" Nguồn: https://docs.openaihub.net/api-45209081/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /tencent-vod/v1/aigc-video: post: summary: Tạo tác vụ deprecated: false description: >- Tạo video theo yêu cầu của Tencent Cloud. Tài liệu chính thức: https://cloud.tencent.com/document/product/266/126240 operationId: tencent_vod_aigc_video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Tencent AIGC - VOD của Tencent Cloud parameters: [] requestBody: content: application/json: schema: type: object required: - model_name - prompt - model_version properties: enhance_prompt: type: string description: >- Có tự động tối ưu hóa nội dung câu lệnh hay không. Khi được bật, các câu lệnh đầu vào sẽ được tự động tối ưu hóa để cải thiện chất lượng bản dựng. Các giá trị gồm: Enabled: bật; Disabled: tắt; Giá trị ví dụ: Enabled ext_info: type: object properties: AdditionalParameters: type: object properties: multi_prompt: type: array items: type: object properties: duration: type: integer description: >- Thoi luong bang phan canh: ○Thoi luong cua moi bang phan canh khong duoc lon hon tong thoi luong cua tac vu hien tai va khong duoc nho hon 1 ○Tong thoi luong cua tat ca cac bang phan canh bang tong thoi luong cua tac vu hien tai index: type: integer description: >- Số thứ tự bảng phân cảnh: ○Hỗ trợ tối đa 6 bảng phân cảnh và tối thiểu 1 bảng phân cảnh ○Độ dài tối đa của mỗi nội dung liên quan đến bảng phân cảnh không vượt quá 512 prompt: type: string description: >- Lời nhắc bảng phân cảnh: Khi sử dụng tính năng này, nội dung được truyền vào tham số số từ tổng cộng của lời nhắc bên ngoài sẽ không hợp lệ. x-apifox-orders: - duration - index - prompt x-apidog-orders: - duration - index - prompt description: >- Thông tin của từng bảng phân cảnh, chẳng hạn như từ khóa nhắc lệnh, thời lượng, v.v. ●Xác định số thứ tự của bảng phân cảnh cùng các từ khóa nhắc lệnh và thời lượng tương ứng thông qua các tham số index, prompt và duration, trong đó: ○Hỗ trợ tối đa 6 bảng phân cảnh và tối thiểu 1 bảng phân cảnh ○Độ dài tối đa của mỗi nội dung liên quan đến bảng phân cảnh không vượt quá 512 ○Thời lượng của mỗi bảng phân cảnh không được lớn hơn tổng thời lượng của tác vụ hiện tại và không được nhỏ hơn 1 ○Tổng thời lượng của tất cả bảng phân cảnh bằng tổng thời lượng của tác vụ hiện tại Sử dụng key:value để truyền tải, Các mô hình khả dụng: 3.0 và 3.0-Omni của Kling multi_shot: type: boolean description: >- Có tạo video đa góc máy hay không ●Khi tham số hiện tại là true, tham số prompt không có hiệu lực ●Khi tham số hiện tại là false, tham số shot_type và tham số multi_prompt không có hiệu lực. Các mô hình khả dụng: Kling 3.0 và 3.0-Omni Lưu ý: Tính năng tham chiếu video của Kling 3.0-Omni không hỗ trợ chế độ đa máy quay shot_type: type: string description: >- Phương pháp lập bảng phân cảnh ●Giá trị liệt kê: customize Khi tham số multi_shot là true, tham số hiện tại là bắt buộc Các mô hình khả dụng: Kling 3.0 và 3.0-Omni description: Các tham số bổ sung x-apifox-orders: - multi_prompt - multi_shot - shot_type x-apidog-orders: - multi_prompt - multi_shot - shot_type description: >- Các trường dành riêng, được sử dụng cho các mục đích đặc biệt. Giá trị ví dụ: myextinfo x-apifox-orders: - AdditionalParameters x-apidog-orders: - AdditionalParameters file_infos: type: array items: type: object properties: category: type: string description: |- Phân loại tập tin. Các giá trị là: Image: hình ảnh; Video: video. Giá trị ví dụ: Image file_id: type: string description: >- ID tệp phương tiện của tệp hình ảnh, là mã định danh duy nhất toàn cục của tệp trên dịch vụ đám mây theo yêu cầu, được hệ thống nền của dịch vụ đám mây theo yêu cầu cấp sau khi tải lên thành công. Có thể lấy trường này trong thông báo sự kiện hoàn tất tải video lên hoặc trên bảng điều khiển đám mây theo yêu cầu. Tham số này hợp lệ khi giá trị của Type là File. Mô tả: 1. Nên sử dụng hình ảnh có kích thước nhỏ hơn 7M; 2. Các giá trị định dạng hình ảnh là: jpeg, jpg, png, webp. Giá trị ví dụ: 3704211***509819 text: type: string description: >- Nhập thông tin mô tả của hình ảnh để giúp mô hình hiểu hình ảnh. Chỉ hợp lệ với GEM 2.5 và GEM 3.0. Giá trị ví dụ: Bối cảnh tác vụ: Đây là tòa nhà chính cần được cải tạo (Hình 1), không được thay đổi hình dạng của tòa nhà. type: type: string description: |- Loại tệp video đầu vào. Các giá trị gồm: File: tệp phương tiện theo yêu cầu; Url: URL có thể truy cập; Giá trị ví dụ: File url: type: string description: >- URL tệp có thể truy cập được. Tham số này hợp lệ khi giá trị của Type là Url. Mô tả: 1. Nên sử dụng hình ảnh nhỏ hơn 7M; 2. Giá trị định dạng hình ảnh là: jpeg, jpg, png, webp. Giá trị ví dụ: https://test.com/1.png x-apifox-orders: - category - file_id - text - type - url x-apidog-orders: - category - file_id - text - type - url description: >- Danh sách gồm tối đa ba hình ảnh tài nguyên, mô tả các hình ảnh tài nguyên sẽ được mô hình sử dụng khi tạo video. Các mô hình hỗ trợ đầu vào nhiều hình ảnh: 1. GV: khi sử dụng đầu vào nhiều hình ảnh, không thể sử dụng LastFrameFileId và LastFrameUrl. 2. Vidu hỗ trợ video tham chiếu nhiều hình ảnh. Có thể truyền các hình ảnh 1-7 của mô hình q2 thông qua ObjectId trong FileInfos dưới dạng id chủ thể. Lưu ý: 1. Kích thước hình ảnh không được vượt quá 10M. 2. Các định dạng hình ảnh được hỗ trợ: jpeg, png. last_frame_url: type: string description: >- URL của tệp phương tiện được dùng làm khung hình kết thúc khi tạo video. Mô tả: 1. Chỉ hỗ trợ các mô hình GV, Kling và Vidu. Các mô hình khác hiện chưa được hỗ trợ. Khi ModelName là GV, nếu tham số này được chỉ định thì FileInfos cũng phải được chỉ định làm khung hình đầu tiên của video cần tạo. Tham số này chỉ có thể được chỉ định khi ModelName là Kling, ModelVersion là 2.1 và độ phân giải đầu ra được chỉ định là 1080P. Tham số này chỉ có thể được chỉ định khi ModelName là Vidu và ModelVersion là q2-pro hoặc q2-turbo. 2. Kích thước hình ảnh phải nhỏ hơn 5M. 3. 3. Giá trị định dạng hình ảnh là: jpeg, jpg, png, webp. Giá trị ví dụ: https://test.com/1.png model_name: type: string description: |- Tên mô hình. Giá trị: Hailuo: conch; Kling: Keling; Vidu; Giá trị ví dụ: GV model_version: type: string description: >- phiên bản mô hình. Giá trị: Khi ModelName là Hailuo, các giá trị tùy chọn là 02, 2.3, 2.3-fast; Khi ModelName là Kling, các giá trị tùy chọn là 1.6, 2.0, 2.1, 2.5, O1, 3.0, 3.0-Omni; Khi ModelName là Vidu, các giá trị tùy chọn là q2, q2-pro, q2-turbo, q3-pro, q3-turbo; Giá trị ví dụ: 2.3 negative_prompt: type: string description: |- Từ nhắc để ngăn mô hình tạo video. Giá trị ví dụ: red output_config: type: object properties: aspect_ratio: type: string description: >- Chỉ định tỷ lệ khung hình của video được tạo. Khi ModelName là Kling và sử dụng video Vincent, các giá trị tùy chọn là 16:9, 9:16, 1:1 và giá trị mặc định là 16:9; Khi ModelName là Vidu, lúc tạo video và sử dụng hình ảnh tham chiếu, các giá trị tùy chọn là 16:9, 9:16, 4:3, 3:4 và 1:1. Chỉ phiên bản q2 hỗ trợ 4:3 và 3:4. Khi ModelName là Hailuo, tính năng này chưa được hỗ trợ. Giá trị ví dụ: 16:9 audio_generation: type: string description: >- Có tạo âm thanh hay không. Các mô hình được hỗ trợ bao gồm GV, OS. Các giá trị gồm: Enabled: bật; Disabled: tắt; Giá trị mặc định: Disabled Giá trị ví dụ: Enabled duration: type: number description: >- Thời lượng của video được tạo, đơn vị: giây. Khi ModelName là Kling, các giá trị tùy chọn là 5 và 10, và giá trị mặc định là 5; Khi ModelName là Kling và ModelVersion là 3.0 hoặc 3.0-Omni, các giá trị tùy chọn là 3-15, giá trị mặc định là 5 Khi ModelName là Kling và ModelVersion là 3.0 - tệp do Omni truyền vào được phân loại là Video, giá trị tùy chọn là 3-10, giá trị mặc định là 5 Khi ModelName là Hailuo, các giá trị tùy chọn là 6 và 10, và giá trị mặc định là 6; Khi ModelName là Vidu, có thể chỉ định giá trị từ 1-10; Giá trị ví dụ: 8.0 input_compliance_check: type: string description: >- Có bật kiểm tra tuân thủ cho nội dung đầu vào hay không. Các giá trị gồm: Enabled: bật; Disabled: tắt; Giá trị ví dụ: Enabled output_compliance_check: type: string description: >- Có bật kiểm tra tính tuân thủ của nội dung đầu ra hay không. Các giá trị gồm: Enabled: bật; Disabled: tắt; Giá trị ví dụ: Enabled person_generation: type: string description: >- Có cho phép tạo nhân vật hoặc khuôn mặt hay không. Các giá trị gồm: AllowAdult: Cho phép tạo người trưởng thành; Disallowed: Không được phép đưa người hoặc khuôn mặt vào hình ảnh; Giá trị ví dụ: AllowAdult resolution: type: string description: >- Độ phân giải của video được tạo. Khi ModelName là Kling, các giá trị tùy chọn là 720P và 1080P, và giá trị mặc định là 720P; Khi ModelName là Hailuo, các giá trị tùy chọn là 768P và 1080P, và giá trị mặc định là 768P; Khi ModelName là Vidu, các giá trị tùy chọn là 720P và 1080P, và giá trị mặc định là 720P; Giá trị ví dụ: 720P storage_mode: type: string description: >- Chế độ lưu trữ. Các giá trị gồm: Permanent: Lưu trữ vĩnh viễn, các tệp hình ảnh được tạo sẽ được lưu trữ trên đám mây khi có yêu cầu, và có thể lấy FileId trong thông báo sự kiện; Temporary: Lưu trữ tạm thời. Các tệp hình ảnh được tạo sẽ không được lưu trữ trên đám mây khi có yêu cầu. Có thể lấy URL truy cập tạm thời trong thông báo sự kiện; Giá trị mặc định: Temporary description: Cấu hình tệp phương tiện đầu ra cho các tác vụ tạo video. x-apifox-orders: - aspect_ratio - audio_generation - duration - input_compliance_check - output_compliance_check - person_generation - resolution - storage_mode x-apidog-orders: - aspect_ratio - audio_generation - duration - input_compliance_check - output_compliance_check - person_generation - resolution - storage_mode prompt: type: string description: từ trong lời nhắc scene_type: type: string description: |- Loại cảnh. Các giá trị như sau: Khi ModelName là Kling: motion_control biểu thị điều khiển chuyển động; avatar_i2v biểu thị người kỹ thuật số; lip_sync có nghĩa là đồng bộ khẩu hình; Các ModelName khác hiện chưa được hỗ trợ. Giá trị ví dụ: motion_control session_context: type: string description: >- Ngữ cảnh nguồn, được dùng để truyền thông tin yêu cầu của người dùng một cách minh bạch. Lệnh gọi lại khi hoàn tất quá trình tái tạo chất lượng âm thanh và video sẽ trả về giá trị của trường này, với độ dài tối đa là 1000 ký tự. Giá trị ví dụ: mySessionContext session_id: type: string description: >- Mã định danh được dùng để loại bỏ yêu cầu trùng lặp. Nếu có yêu cầu sử dụng cùng mã định danh trong vòng ba ngày, yêu cầu này sẽ trả về lỗi. Độ dài tối đa là 50 ký tự; không cung cấp giá trị hoặc dùng chuỗi rỗng để biểu thị rằng không loại bỏ yêu cầu trùng lặp. Giá trị ví dụ: mysession tasks_priority: type: integer description: >- Mức độ ưu tiên của tác vụ. Giá trị càng lớn thì mức độ ưu tiên càng cao. Phạm vi giá trị là từ -10 đến 10. Nếu để trống, giá trị được hiểu là 0. Giá trị ví dụ: 10 refName: PostTencentVodV1AigcVideoRequest x-apifox-orders: - enhance_prompt - ext_info - file_infos - last_frame_url - model_name - model_version - negative_prompt - output_config - prompt - scene_type - session_context - session_id - tasks_priority x-apidog-orders: - enhance_prompt - ext_info - file_infos - last_frame_url - model_name - model_version - negative_prompt - output_config - prompt - scene_type - session_context - session_id - tasks_priority examples: example_single: value: enhance_prompt: Đã bật model_name: Kling model_version: '1.6' negative_prompt: Mờ, rung output_config: aspect_ratio: '16:9' audio_generation: Đã bật duration: 8 enhance_switch: Đã bật input_compliance_check: Đã bật media_name: car-video output_compliance_check: Đã bật person_generation: AllowAdult resolution: 1080P storage_mode: Tạm thời prompt: Một chiếc ô tô đang chạy trên đường cao tốc, trời nắng đẹp. summary: example_single description: Tạo tác vụ responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: Response: RequestId: req-example TaskId: task-example 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/Tencent AIGC x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209081-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ tạo mẫu hiệu ứng đặc biệt" Nguồn: https://docs.openaihub.net/api-45209082/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /tencent-vod/v1/template-effect: post: summary: Tác vụ tạo mẫu hiệu ứng đặc biệt deprecated: false description: >- Tạo hiệu ứng đặc biệt từ mẫu. Tài liệu chính thức: https://cloud.tencent.com/document/product/266/126240 operationId: tencent_vod_template_effect tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Tencent AIGC - VOD của Tencent Cloud parameters: [] requestBody: content: application/json: schema: type: object required: - scene_type - ext_info properties: ext_info: type: object required: - AdditionalParameters properties: AdditionalParameters: type: object required: - template properties: template: type: string description: >- Tham số mẫu cảnh Các mẫu cảnh khác nhau có các tham số gọi khác nhau. Chúng tôi cung cấp hai phương thức xem: ●Trung tâm mẫu chính thức: https://platform.vidu.cn/docs/templates ●Tài liệu trực tuyến (hỗ trợ truy vấn theo thời gian đăng trực tuyến): https://shengshu.feishu.cn/wiki/L2Dbwi7QeilCAgkdJKjcrj2Lnrg?from=from_copylink Lưu ý: Các mẫu hiệu ứng đặc biệt hiện chỉ hỗ trợ những mẫu được tạo bằng loại video. description: Các tham số bổ sung x-apifox-orders: - template x-apidog-orders: - template description: Thông tin mở rộng x-apifox-orders: - AdditionalParameters x-apidog-orders: - AdditionalParameters file_infos: type: array items: type: object properties: category: type: string description: |- Phân loại tập tin. Các giá trị là: Image: hình ảnh; Video: video. Giá trị ví dụ: Image file_id: type: string description: >- ID tệp phương tiện của tệp hình ảnh, là mã định danh duy nhất toàn cầu của tệp trên dịch vụ đám mây theo yêu cầu, được hệ thống nền của dịch vụ đám mây theo yêu cầu cấp sau khi tải lên thành công. Có thể lấy trường này từ thông báo sự kiện hoàn tất tải video lên hoặc bảng điều khiển đám mây theo yêu cầu. Tham số này hợp lệ khi giá trị của Type là File. Mô tả: 1. Khuyến nghị sử dụng hình ảnh có kích thước nhỏ hơn 7M; 2. Các giá trị định dạng hình ảnh là: jpeg, jpg, png, webp. Giá trị ví dụ: 3704211***509819 type: type: string description: |- Loại tệp video đầu vào. Các giá trị gồm: File: tệp phương tiện theo yêu cầu; Url: URL có thể truy cập; Giá trị ví dụ: File url: type: string description: >- URL tệp có thể truy cập. Tham số này hợp lệ khi giá trị của Type là Url. Mô tả: 1. Nên sử dụng hình ảnh có kích thước nhỏ hơn 7M; 2. Các định dạng hình ảnh được hỗ trợ là: jpeg, jpg, png, webp. Giá trị ví dụ: https://test.com/1.png x-apifox-orders: - category - file_id - type - url x-apidog-orders: - category - file_id - type - url description: >- Danh sách gồm tối đa ba hình ảnh tài nguyên, mô tả các hình ảnh tài nguyên mà mô hình sẽ sử dụng khi tạo video. Lưu ý: 1. Kích thước hình ảnh không vượt quá 10M. 2. Các định dạng hình ảnh được hỗ trợ: jpeg, png. prompt: type: string description: từ trong lời nhắc scene_type: type: string description: Giá trị template_effect refName: PostTencentVodV1TemplateEffectRequest x-apifox-orders: - ext_info - file_infos - prompt - scene_type x-apidog-orders: - ext_info - file_infos - prompt - scene_type examples: example_single: value: ext_info: AdditionalParameters: template: morphlab file_infos: - category: Hình ảnh type: Url url: >- https://image01.vidu.zone/vidu/example/20241206-175531.jpeg prompt: >- Nội dung video\nKhi cảnh bắt đầu, các chủ thể đột ngột phát nổ, những hạt nhỏ li ti bắn tung ra\n# Yêu cầu\n1. Xác định số lượng chủ thể dựa trên hình ảnh do người dùng tải lên, mỗi chủ thể đều phải phát nổ\n2. Đặt Motion Level thành: Middle\n3. Lấy >nội dung video của tôi làm yếu tố ưu tiên hàng đầu; phần mô tả hậu cảnh phải thống nhất, hợp lý và không được mô tả hai lần. scene_type: template_effect summary: example_single description: Tác vụ tạo mẫu hiệu ứng đặc biệt responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: Response: RequestId: req-example TaskId: task-example 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/Tencent AIGC x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209082-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Lấy kết quả yêu cầu" Nguồn: https://docs.openaihub.net/api-45209083/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /tencent-vod/v1/query/{task_id}: get: summary: Lấy kết quả yêu cầu deprecated: false description: >- Truy vấn trạng thái/kết quả của một tác vụ bất đồng bộ được tạo qua `POST /tencent-vod/v1/aigc-image`, `/aigc-video` hoặc `/template-effect`. operationId: tencent_vod_query_task tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Tencent AIGC - VOD của Tencent Cloud parameters: - name: task_id in: path description: ID tác vụ bất đồng bộ required: true example: '' schema: type: string responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: Response: RequestId: req-example TaskId: task-example headers: {} x-apidog-name: thành công '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/Tencent AIGC x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209083-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Video" Nguồn: https://docs.openaihub.net/api-45209084/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/generations: post: summary: Video deprecated: false description: >- Video hợp nhất VEO · Tạo video bằng Veo 3.1 (`POST /v1/video/generations`); sau khi gửi yêu cầu, hãy thăm dò bằng `GET /v1/video/query`. operationId: veo_video_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/seedance-2-0 - Video hợp nhất · VEO parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer sk-1dnXVfVZKfyMCxwo9SPuT364kWSVlRO2EUna0Zfa3AmstOrE schema: type: string requestBody: content: application/json: schema: type: object required: - model - prompt properties: image: oneOf: - type: string - type: array items: type: string description: >- Hình ảnh tham chiếu cho chuyển đổi từ hình ảnh sang video (tùy chọn; URL hoặc base64) metadata: type: object properties: aspectRatio: type: string enum: - '16:9' - '9:16' description: |- Tỷ lệ khung hình. Kiểu liệt kê: 16:9 9:16 examples: - '16:9' durationSeconds: type: integer description: Thời lượng video tính bằng giây examples: - 6 generateAudio: type: boolean description: >- Có tạo âm thanh hay không (được một số mô hình Veo hỗ trợ) negativePrompt: type: string description: Lời nhắc phủ định resolution: type: string enum: - 720p - 1080p description: |- Độ phân giải. Kiểu liệt kê: 720p 1080p examples: - 720p description: >- Tham số tạo Veo (được chuyển tiếp tới các tham số thượng nguồn) x-apifox-orders: - aspectRatio - durationSeconds - generateAudio - negativePrompt - resolution x-apidog-orders: - aspectRatio - durationSeconds - generateAudio - negativePrompt - resolution model: type: string enum: - veo-3.1-generate-preview - veo-3.1-fast-generate-preview - veo-3.0-generate-001 - veo-3.0-fast-generate-001 description: |- Tên mô hình. Kiểu liệt kê: veo-3.1-generate-preview veo-3.1-fast-generate-preview veo-3.0-generate-001 veo-3.0-fast-generate-001 examples: - veo-3.1-generate-preview prompt: type: string description: Mô tả nội dung video (bắt buộc) examples: - >- Cảnh cận cảnh hai người đang nhìn chằm chằm vào một hình vẽ bí ẩn trên tường x-apifox-orders: - image - metadata - model - prompt x-apidog-orders: - image - metadata - model - prompt examples: veo_3_1_fast_generate_preview: value: metadata: aspectRatio: '16:9' durationSeconds: 6 model: veo-3.1-fast-generate-preview prompt: >- Cảnh cận cảnh hai người đang nhìn chằm chằm vào một hình vẽ bí ẩn trên tường summary: veo_3_1_fast_generate_preview description: Chuyển văn bản thành video veo-3.1-fast-generate-preview veo_3_1_generate_preview: value: metadata: aspectRatio: '16:9' durationSeconds: 6 model: veo-3.1-generate-preview prompt: >- Cảnh cận cảnh hai người đang nhìn chằm chằm vào một hình vẽ bí ẩn trên tường summary: veo_3_1_generate_preview description: Chuyển văn bản thành video veo-3.1-generate-preview veo_3_1_image2video: value: image: https://example.com/first.jpg metadata: aspectRatio: '16:9' durationSeconds: 6 model: veo-3.1-generate-preview prompt: Tạo chuyển động tự nhiên ngay từ khung hình đầu tiên summary: veo_3_1_image2video description: Chuyển ảnh thành video responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '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 security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/seedance-2-0 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209084-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Các tác vụ truy vấn" Nguồn: https://docs.openaihub.net/api-45209085/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/video/generations/{task_id}: get: summary: Các tác vụ truy vấn deprecated: false description: Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. operationId: get-v1-video-generations-task-id tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/seedance-2-0 - seedance parameters: - name: task_id in: path description: '' required: true example: '' schema: type: string responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: Được '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/seedance-2-0 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209085-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "trình tạo sơ đồ Vincentian" Nguồn: https://docs.openaihub.net/api-45209086/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/v3/contents/generations/tasks: post: summary: trình tạo sơ đồ Vincentian deprecated: false description: Gửi tác vụ tạo video Seedance/Doubao. operationId: seedance_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Cinema2.0 - Seedance 2.0 parameters: [] requestBody: content: application/json: schema: type: object required: - model - content properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất content: type: array items: type: object properties: image_url: type: object properties: url: type: string description: URL tài nguyên description: URL hình ảnh x-apifox-orders: - url x-apidog-orders: - url role: type: string enum: - first_frame - last_frame - reference_image description: >- Vai trò của tin nhắn, ví dụ: system / user / assistant / model text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. type: type: string enum: - text - image_url description: Kiểu x-apifox-orders: - image_url - role - text - type x-apidog-orders: - image_url - role - text - type description: Mảng nội dung văn bản/hình ảnh model: type: string description: Tên mô hình examples: - doubao-seedance-2-0-260128 refName: SeedanceSampleRequest x-apifox-orders: - callback_url - content - model x-apidog-orders: - callback_url - content - model examples: doubao_seedance_2_0_260128: value: content: - text: Một con mèo đang chạy trên đồng cỏ. type: text model: doubao-seedance-2-0-260128 summary: doubao_seedance_2_0_260128 description: Video Vincent doubao_seedance_2_0_260128_2: value: content: - image_url: url: https://example.com/frame.jpg role: first_frame type: image_url - text: Máy quay tiến gần type: text model: doubao-seedance-2-0-260128 summary: doubao_seedance_2_0_260128_2 description: video từ ảnh responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: Được '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/Cinema2.0 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209086-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn tác vụ" Nguồn: https://docs.openaihub.net/api-45209087/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /api/v3/contents/generations/tasks/{task_id}: get: summary: Truy vấn tác vụ deprecated: false description: Truy vấn một tác vụ tạo video Seedance bằng task_id. operationId: seedance_get_task tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Cinema2.0 - Seedance 2.0 parameters: - name: task_id in: path description: ID tác vụ bất đồng bộ required: true example: '' schema: type: string responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: status: succeed message: thành công headers: {} x-apidog-name: thành công '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/Cinema2.0 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209087-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tải lên âm thanh đã phân nhánh" Nguồn: https://docs.openaihub.net/api-45209088/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /minimax/v1/files: post: summary: Tải lên âm thanh đã phân nhánh deprecated: false description: '' operationId: minimax_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax - Các điểm cuối parameters: [] responses: '200': description: '' content: application/json: schema: type: object properties: {} headers: {} x-apidog-name: Success security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209088-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Nhân bản giọng nói nhanh" Nguồn: https://docs.openaihub.net/api-45209089/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /minimax/v1/voice_clone: post: summary: Nhân bản giọng nói nhanh deprecated: false description: '' operationId: minimax_voice_clone tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax - Các điểm cuối parameters: [] responses: '200': description: '' content: application/json: schema: type: object properties: {} headers: {} x-apidog-name: Success security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209089-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tác vụ tạo video Vincent Tusheng" Nguồn: https://docs.openaihub.net/api-45209090/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /minimax/v1/video_generation: post: summary: Tác vụ tạo video Vincent Tusheng deprecated: false description: '' operationId: minimax_video_generation tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax - Các điểm cuối parameters: [] responses: '200': description: '' content: application/json: schema: type: object properties: {} headers: {} x-apidog-name: Success security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209090-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy van trang thai tac vu tao video" Nguồn: https://docs.openaihub.net/api-45209091/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /minimax/v1/query/video_generation: get: summary: Truy van trang thai tac vu tao video deprecated: false description: '' operationId: minimax_query_video_generation tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax - Các điểm cuối parameters: [] responses: '200': description: '' content: application/json: schema: type: object properties: {} headers: {} x-apidog-name: Success security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209091-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy xuất (để tải video, tải âm thanh không đồng bộ)" Nguồn: https://docs.openaihub.net/api-45209092/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /minimax/v1/files/retrieve: get: summary: Truy xuất (để tải video, tải âm thanh không đồng bộ) deprecated: false description: '' operationId: minimax_files_retrieve tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax - Các điểm cuối parameters: [] responses: '200': description: '' content: application/json: schema: type: object properties: {} headers: {} x-apidog-name: Success security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209092-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "tổng hợp văn bản" Nguồn: https://docs.openaihub.net/api-45209093/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1/messages: post: summary: tổng hợp văn bản deprecated: false description: '' operationId: minimax_v1_messages tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax - Các điểm cuối parameters: [] responses: '200': description: '' content: application/json: schema: type: object properties: {} headers: {} x-apidog-name: Success security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209093-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tổng hợp giọng nói đồng bộ V2" Nguồn: https://docs.openaihub.net/api-45209094/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /minimax/v1/t2a_v2: post: summary: Tổng hợp giọng nói đồng bộ V2 deprecated: false description: '' operationId: textToAudioV2 tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax - Các điểm cuối parameters: [] responses: '200': description: '' content: application/json: schema: type: object properties: {} headers: {} x-apidog-name: Success security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209094-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "thiết kế âm thanh" Nguồn: https://docs.openaihub.net/api-45209095/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /minimax/v1/voice_design: post: summary: thiết kế âm thanh deprecated: false description: '' operationId: minimax_voice_design tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax - Các điểm cuối parameters: [] responses: '200': description: '' content: application/json: schema: type: object properties: {} headers: {} x-apidog-name: Success security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209095-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video" Nguồn: https://docs.openaihub.net/api-45209096/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /minimax/v2/video_generation: post: summary: Tạo video deprecated: false description: '' operationId: post-minimax-v2-video_generation tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax - Các điểm cuối parameters: [] responses: '200': description: '' content: application/json: schema: type: object properties: {} headers: {} x-apidog-name: Success security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209096-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn một tác vụ duy nhất" Nguồn: https://docs.openaihub.net/api-45209097/ > 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 ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /minimax/v2/query/video_generation/{task_id}: get: summary: Truy vấn một tác vụ duy nhất deprecated: false description: '' operationId: get-minimax-v2-query-video_generation-{task_id} tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax - Các điểm cuối parameters: - name: task_id in: path description: '' required: true example: '' schema: type: string responses: '200': description: '' content: application/json: schema: type: object properties: {} headers: {} x-apidog-name: Success security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/MiniMax x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209097-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ```