Bỏ qua để đến nội dung

Chủ đề (cũ)

Xem Markdownllms.txt

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: 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: []