Hình ảnh
API origin:
https://api.openaihub.net. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn.
OpenAPI Specification
Phần tiêu đề “OpenAPI Specification”openapi: 3.0.1info: title: '' description: '' version: 1.0.0paths: /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-runcomponents: schemas: {} securitySchemes: {}servers: - url: https://api.openaihub.net description: Prod Envsecurity: []