> ## Documentation Index > Fetch the complete documentation index at: https://docs.aiid.edu.kg/llms.txt > Use this file to discover all available pages before exploring further. # Kling Tham khảo toàn diện > Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết [Định dạng tương thích với Sora tạo video](/api-reference/vi/tao-video-dinh-dang-tuong-thich-sora/tao-video)). Giao diện tác vụ gốc Kling 4.0. Sử dụng Bearer API Key của trang này để xác thực. Nội dung yêu cầu không cần `model`; `settings.resolution=720p` sử dụng `kling-4.0`, `1080p` sử dụng `kling-4.0-1080p`, mặc định là `1080p`. Sau khi tạo thành công, dùng `data.id` trả về để gọi `GET /tasks?task_ids=ID tác vụ`; nhiều ID được phân tách bằng dấu phẩy. `data` của kết quả truy vấn là một mảng, URL video kết quả nằm tại `data[].outputs[].url`. Hiện hỗ trợ các trường hợp tạo tương ứng với prompt, first_frame, last_frame, refer_image và feature_video. Không hỗ trợ middle_frame, base_video, element, voice, tham chiếu âm thanh, callback hoặc ID tác vụ bên ngoài tùy chỉnh; options.callback_url không rỗng, options.external_task_id không rỗng, contents.id không rỗng và các trường không được hỗ trợ khác sẽ trả về 400. Có thể bỏ qua options hoặc truyền một đối tượng rỗng, hoặc truyền watermark_info.enabled=false; hiện chưa hỗ trợ bật hình mờ. Thời lượng hiện được hỗ trợ từ 4 đến 30 giây, mặc định là 10 giây; chưa hỗ trợ 3 giây. Tỷ lệ khung hình mặc định cho các trường hợp văn bản tạo sinh và tham chiếu là 16:9; việc chỉ định rõ adaptive sẽ trả về 400. Trường hợp khung hình đầu-cuối không chấp nhận settings.aspect_ratio được chỉ định rõ; tỷ lệ khung hình được xác định theo kích thước của ảnh frame đầu tiên. `contents` cho tham chiếu đa năng phải bao gồm `prompt` không rỗng và ít nhất một nội dung đa phương tiện được hỗ trợ. Trong các trường hợp khung hình đầu/cuối trước đây, có thể truyền `first_frame`, `last_frame` hoặc cả hai, nhưng khả năng xử lý phụ thuộc vào các khả năng hiện có của mô hình; yêu cầu sẽ bị từ chối nếu khả năng không tương thích và hình khung sẽ không bị âm thầm chuyển thành hình tham chiếu thông thường. Đối với việc tích hợp mới khung hình đầu/cuối, bạn nên sử dụng điểm vào tạo video từ hình ảnh. Không thể dùng chung khung hình đầu/cuối với hình tham chiếu `refer_image` hoặc video tham chiếu `feature_video`; việc dùng chung sẽ trả về 400. Trong trường hợp tham chiếu, có thể kết hợp hình tham chiếu `refer_image` và video tham chiếu `feature_video`. Mỗi `first_frame`, `last_frame` và `refer_image` tối đa 1 mục; `feature_video` tối đa 5 mục. Hiện chưa hỗ trợ trường hợp nhiều hình tham chiếu dựa vào tham chiếu `id`. ## OpenAPI ````yaml api-reference/vi/openapi.json POST /omni-video/kling-4.0 openapi: 3.0.0 info: title: Tài liệu tham khảo API của 出海营 version: 1.0.0 description: Public AI Gateway API Reference servers: - url: https://api.aiid.edu.kg security: - BearerAuth: [] tags: - name: Định dạng OpenAI (Chat) - name: Định dạng OpenAI (Responses) - name: Định dạng Gemini cho tạo ảnh - name: Tạo hình ảnhOpenAI định dạng DALL-E - name: Lấy danh sách mô hình - name: Tạo video HappyHorse và Wan - name: Định dạngKling tạo video - name: Định dạng Video Generation Omni và Veo - name: Tạo video Seedance - name: Định dạng tương thích Sora cho tạo video - name: Tạo video Vidu - name: Định dạng tác vụ tạo nhạc paths: /omni-video/kling-4.0: post: tags: - Định dạngKling tạo video summary: Kling Tham khảo toàn diện description: >- Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết [Định dạng tương thích với Sora tạo video](/api-reference/vi/tao-video-dinh-dang-tuong-thich-sora/tao-video)). Giao diện tác vụ gốc Kling 4.0. Sử dụng Bearer API Key của trang này để xác thực. Nội dung yêu cầu không cần `model`; `settings.resolution=720p` sử dụng `kling-4.0`, `1080p` sử dụng `kling-4.0-1080p`, mặc định là `1080p`. Sau khi tạo thành công, dùng `data.id` trả về để gọi `GET /tasks?task_ids=ID tác vụ`; nhiều ID được phân tách bằng dấu phẩy. `data` của kết quả truy vấn là một mảng, URL video kết quả nằm tại `data[].outputs[].url`. Hiện hỗ trợ các trường hợp tạo tương ứng với prompt, first_frame, last_frame, refer_image và feature_video. Không hỗ trợ middle_frame, base_video, element, voice, tham chiếu âm thanh, callback hoặc ID tác vụ bên ngoài tùy chỉnh; options.callback_url không rỗng, options.external_task_id không rỗng, contents.id không rỗng và các trường không được hỗ trợ khác sẽ trả về 400. Có thể bỏ qua options hoặc truyền một đối tượng rỗng, hoặc truyền watermark_info.enabled=false; hiện chưa hỗ trợ bật hình mờ. Thời lượng hiện được hỗ trợ từ 4 đến 30 giây, mặc định là 10 giây; chưa hỗ trợ 3 giây. Tỷ lệ khung hình mặc định cho các trường hợp văn bản tạo sinh và tham chiếu là 16:9; việc chỉ định rõ adaptive sẽ trả về 400. Trường hợp khung hình đầu-cuối không chấp nhận settings.aspect_ratio được chỉ định rõ; tỷ lệ khung hình được xác định theo kích thước của ảnh frame đầu tiên. `contents` cho tham chiếu đa năng phải bao gồm `prompt` không rỗng và ít nhất một nội dung đa phương tiện được hỗ trợ. Trong các trường hợp khung hình đầu/cuối trước đây, có thể truyền `first_frame`, `last_frame` hoặc cả hai, nhưng khả năng xử lý phụ thuộc vào các khả năng hiện có của mô hình; yêu cầu sẽ bị từ chối nếu khả năng không tương thích và hình khung sẽ không bị âm thầm chuyển thành hình tham chiếu thông thường. Đối với việc tích hợp mới khung hình đầu/cuối, bạn nên sử dụng điểm vào tạo video từ hình ảnh. Không thể dùng chung khung hình đầu/cuối với hình tham chiếu `refer_image` hoặc video tham chiếu `feature_video`; việc dùng chung sẽ trả về 400. Trong trường hợp tham chiếu, có thể kết hợp hình tham chiếu `refer_image` và video tham chiếu `feature_video`. Mỗi `first_frame`, `last_frame` và `refer_image` tối đa 1 mục; `feature_video` tối đa 5 mục. Hiện chưa hỗ trợ trường hợp nhiều hình tham chiếu dựa vào tham chiếu `id`. operationId: create_kling4_native_omni_video requestBody: required: true content: application/json: schema: type: object additionalProperties: false required: - contents properties: settings: type: object additionalProperties: false properties: resolution: type: string enum: - 720p - 1080p default: 1080p duration: type: integer minimum: 4 maximum: 30 default: 10 aspect_ratio: type: string enum: - '21:9' - '16:9' - '9:16' - '1:1' options: type: object additionalProperties: false description: >- Có thể bỏ qua, truyền đối tượng rỗng hoặc tắt hình mờ một cách rõ ràng. properties: watermark_info: type: object additionalProperties: false required: - enabled properties: enabled: type: boolean enum: - false contents: type: array minItems: 2 description: >- Phải đồng thời bao gồm `prompt` không rỗng và nội dung đa phương tiện được hỗ trợ; tạo video từ ảnh phải bao gồm `first_frame`. Không thể dùng lẫn `first_frame`/`last_frame` với `refer_image`/`feature_video`, nếu không sẽ trả về 400. Giới hạn số lượng của từng loại nội dung đa phương tiện xem trong phần mô tả API. Các yêu cầu khung hình đầu-cuối trước đây được xác thực theo khả năng của mô hình hiện có; đối với tích hợp mới dùng khung hình đầu-cuối, bạn nên sử dụng điểm cuối tạo video từ ảnh. items: oneOf: - type: object additionalProperties: false required: - type - text properties: type: type: string enum: - prompt text: type: string minLength: 1 - type: object additionalProperties: false required: - type - url properties: type: type: string enum: - first_frame - last_frame - refer_image - feature_video url: type: string format: uri pattern: ^https?:// not: items: properties: type: enum: - prompt oneOf: - description: >- Các trường hợp tương thích khung hình đầu/cuối trước đây: first_frame, last_frame hoặc cả hai, tùy thuộc vào khả năng của các mô hình hiện có. Không dùng lẫn tài liệu tham chiếu; bỏ qua aspect_ratio, tỷ lệ khung hình theo frame đầu tiên. properties: contents: items: properties: type: enum: - prompt - first_frame - last_frame settings: not: required: - aspect_ratio - description: >- Kịch bản tham khảo: Có thể kết hợp refer_image và feature_video, tỷ lệ khung hình mặc định là 16:9. properties: contents: items: properties: type: enum: - prompt - refer_image - feature_video settings: properties: aspect_ratio: type: string enum: - '21:9' - '16:9' - '9:16' - '1:1' default: '16:9' examples: kling4_native_720p: summary: Kling 720p value: settings: resolution: 720p duration: 10 aspect_ratio: '16:9' options: {} contents: - type: prompt text: A cinematic product shot with natural motion - type: refer_image url: https://example.com/reference.jpg - type: feature_video url: https://example.com/motion.mp4 kling4_native_1080p: summary: Kling 1080p value: settings: resolution: 1080p duration: 10 aspect_ratio: '16:9' options: {} contents: - type: prompt text: A cinematic product shot with natural motion - type: refer_image url: https://example.com/reference.jpg - type: feature_video url: https://example.com/motion.mp4 responses: '200': description: Thành công content: application/json: schema: type: object required: - code - message - request_id - data properties: code: type: integer example: 0 message: type: string request_id: type: string data: type: object properties: id: type: string description: >- ID tác vụ của trang này, khi truy vấn hãy truyền nguyên văn. status: type: string enum: - submitted - processing - succeeded - failed create_time: type: integer format: int64 description: Thời gian tạo, tính bằng mili giây Unix. update_time: type: integer format: int64 description: Thời gian cập nhật, tính bằng mili giây Unix. external_id: type: string maxLength: 0 examples: success: summary: Thành công value: code: 0 message: SUCCEED request_id: request_example data: id: task_example status: submitted create_time: 1792710000000 update_time: 1792710000000 external_id: '' '400': description: Tham số yêu cầu không hợp lệ hoặc chứa trường không được hỗ trợ. components: securitySchemes: BearerAuth: type: http scheme: bearer description: |- Sử dụng xác thực Bearer Token. Định dạng: `Authorization: Bearer sk-xxxxxx` ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.