# "Tạo cuộc trò chuyện" Nguồn: https://docs.openaihub.net/api-45208823/ > 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 cuộc trò chuyện 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/Trò chuyện/ChatGpt/Trò chuyện ChatGPT - 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/Trò chuyện/ChatGpt/Trò chuyện ChatGPT x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208823-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Liệt kê các mô hình" Nguồn: https://docs.openaihub.net/api-45208824/ > 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/models: get: summary: Liệt kê các mô hình deprecated: false description: Liệt kê các mô hình mà mã thông báo API hiện tại có thể truy cập. operationId: v1_models tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/ChatGpt/Trò chuyện ChatGPT - Mô hình 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: Authorization in: header description: mã thông báo hệ thống 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: id: resp_example object: phản hồi status: completed headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/ChatGpt/Trò chuyện ChatGPT x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208824-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Đã tạo xong" Nguồn: https://docs.openaihub.net/api-45208825/ > 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/completions: post: summary: Đã tạo xong deprecated: false description: >- Khi được cung cấp một gợi ý, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được dự đoán và cũng có thể trả về xác suất của dấu thay thế tại mỗi vị trí. Tạo phần hoàn thành cho các lời nhắc và tham số đã cung cấp https://platform.openai.com/docs/api-reference/completions operationId: v1_completions tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/ChatGpt/Các lượt hoàn tất của ChatGPT - Hoàn tất parameters: - 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 - user properties: best_of: type: integer description: >- Mặc định là 1. Tạo best_of phương án hoàn thành ở phía máy chủ và trả về phương án hoàn thành "tốt nhất" (phương án có xác suất log cao nhất cho từng token). Không thể truyền phát kết quả. Khi được dùng cùng với n, best_of kiểm soát số lượng phương án hoàn thành ứng viên, còn n chỉ định số lượng phương án được trả về – best_of phải lớn hơn n. Lưu ý: Vì tham số này tạo ra nhiều phương án hoàn thành, nó có thể nhanh chóng tiêu hao hạn mức token của bạn. Vui lòng thận trọng khi sử dụng và bảo đảm rằng bạn thiết lập các giá trị hợp lý cho max_tokens và stop. echo: type: boolean description: >- Giá trị mặc định là false. Ngoài phần hoàn thành, các lời nhắc cũng được hiển thị lại. frequency_penalty: type: number description: >- Mặc định là 0 - một số nằm trong khoảng từ 2.0 đến 2.0. Các giá trị dương phạt những token mới dựa trên tần suất hiện tại của chúng trong văn bản, làm giảm khả năng mô hình lặp lại nguyên văn cùng một dòng. logit_bias: type: object description: >- Mặc định là null Xác suất xuất hiện của token được chỉ định trong phần hoàn thành chỉnh sửa. Chấp nhận một đối tượng JSON ánh xạ một token (được chỉ định bằng ID token trong bộ tách token GPT) tới một giá trị độ lệch tương ứng, từ -100 đến 100. Bạn có thể dùng công cụ tách token này (có sẵn cho GPT-2 và GPT-3) để chuyển đổi văn bản thành các ID token. Về mặt toán học, độ lệch được cộng vào logit thu được trước khi mô hình được lấy mẫu. Tác động chính xác khác nhau tùy theo từng mô hình, nhưng các giá trị từ -1 đến 1 sẽ làm giảm hoặc tăng khả năng được chọn; các giá trị như -100 hoặc 100 sẽ khiến token liên quan bị cấm hoặc được chọn riêng biệt. Ví dụ, bạn có thể truyền {"50256": -100} để ngăn token <|endoftext|> được tạo. x-apidog-orders: [] logprobs: type: string description: >- Mặc định là null Bao gồm xác suất logarit của các token có khả năng cao nhất trong logprobs, cũng như token đã chọn. Ví dụ, nếu logprobs là 5, API sẽ trả về danh sách 5 token có khả năng cao nhất. API luôn trả về xác suất logarit của token được lấy mẫu, vì vậy phản hồi có thể có tối đa logprobs+1 phần tử. Giá trị tối đa của logprobs là 5. nullable: true max_tokens: type: integer description: >- Mặc định là 16 Số lượng token tối đa được tạo trong phần hoàn thành. Tổng số token của gợi ý và `max_tokens` không được vượt quá độ dài ngữ cảnh của mô hình. Ví dụ mã Python để đếm token. model: type: string description: >- ID của mô hình cần sử dụng. Bạn có thể dùng API Liệt kê mô hình để xem tất cả các mô hình hiện có, hoặc xem phần Tổng quan về mô hình để đọc mô tả của chúng. 'n': type: integer description: >- Mặc định là 1 Số lượng phương án hoàn thành được tạo cho mỗi lời nhắc. Lưu ý: Vì tham số này tạo ra nhiều phương án hoàn thành, nó có thể nhanh chóng làm cạn hạn mức token của bạn. Vui lòng sử dụng thận trọng và đảm bảo bạn đã thiết lập các giá trị hợp lý cho max_tokens và stop. presence_penalty: type: number description: >- Mặc định là 0 - một số nằm trong khoảng từ 2.0 đến 2.0. Các giá trị dương phạt các token mới dựa trên việc chúng có xuất hiện trong văn bản hiện tại hay không, làm tăng khả năng mô hình thảo luận các chủ đề mới. Để biết thêm thông tin về mức phạt tần suất và mức phạt hiện diện, hãy xem . prompt: type: string description: >- Tạo một lời nhắc hoàn chỉnh, được mã hóa dưới dạng một chuỗi, một mảng chuỗi, một mảng token hoặc một mảng các mảng token. Lưu ý rằng <|endoftext|> là dấu phân cách tài liệu mà mô hình nhìn thấy trong quá trình huấn luyện, vì vậy nếu không chỉ định gợi ý nào, mô hình sẽ tạo phần mở đầu của một tài liệu mới. seed: type: integer description: >- Nếu được chỉ định, hệ thống của chúng tôi sẽ cố gắng hết sức để lấy mẫu theo cách xác định, nhờ đó các yêu cầu lặp lại với cùng seed và các tham số sẽ trả về cùng kết quả. Tính xác định không được bảo đảm và bạn nên tham chiếu tham số phản hồi system_fingerprint để theo dõi các thay đổi ở backend của mình. stop: type: string description: >- Mặc định là null, với tối đa 4 chuỗi mà tại đó API sẽ ngừng tạo thêm token. Văn bản được trả về sẽ không chứa các chuỗi dừng. stream: type: boolean description: >- Mặc định là false, cho biết có truyền ngược lại một phần tiến trình hay không. Nếu được bật, token sẽ được gửi dưới dạng sự kiện do máy chủ gửi chỉ chứa dữ liệu khi có sẵn, và luồng sẽ kết thúc bằng thông báo data: [DONE]. Thông báo dạng đối tượng. Các ví dụ mã Python. suffix: type: string description: >- Mặc định là null. Hậu tố xuất hiện sau khi hoàn tất văn bản được chèn. temperature: type: integer description: >- Mặc định là 1. Nhiệt độ lấy mẫu được sử dụng, nằm trong khoảng từ 0 đến 2. Giá trị cao hơn (như 0.8) sẽ làm cho đầu ra ngẫu nhiên hơn, trong khi giá trị thấp hơn (như 0.2) sẽ làm cho đầu ra tập trung và có tính xác định cao hơn. Nhìn chung, chúng tôi khuyến nghị chỉ thay đổi tham số này hoặc top_p, không thay đổi cả hai. top_p: type: integer description: >- Đại diện cho một mã định danh duy nhất của người dùng cuối, có thể giúp OpenAI giám sát và phát hiện hành vi lạm dụng. Tìm hiểu thêm. user: type: string description: >- Mã định danh người dùng cuối (để kiểm soát rủi ro / thanh toán) refName: PostV1CompletionsRequest x-apifox-orders: - best_of - echo - frequency_penalty - logit_bias - logprobs - max_tokens - model - 'n' - presence_penalty - prompt - seed - stop - stream - suffix - temperature - top_p - user x-apidog-orders: - best_of - echo - frequency_penalty - logit_bias - logprobs - max_tokens - model - 'n' - presence_penalty - prompt - seed - stop - stream - suffix - temperature - top_p - user examples: gpt_3_5_turbo_instruct: value: max_tokens: 30 model: gpt-3.5-turbo-instruct prompt: Xin chào, temperature: 0 user: default-user summary: gpt_3_5_turbo_instruct description: Đã tạo xong responses: '200': description: '' content: application/json: schema: type: object required: - id - object - created - model - system_fingerprint - 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 logprobs: type: string description: Thông tin xác suất lôgarit (nếu được bật) nullable: true text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - finish_reason - index - logprobs - text x-apidog-orders: - finish_reason - index - logprobs - text 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' 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 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 refName: PostV1CompletionsResponse x-apifox-orders: - choices - created - id - model - object - system_fingerprint - usage x-apidog-orders: - choices - created - id - model - object - system_fingerprint - usage examples: example: summary: example value: choices: - finish_reason: độ dài index: 0 logprobs: '' text: >- Tôi là Tiểu Băng, rất vui được làm quen với bạn. Tôi là một trợ lý trí tuệ nhân tạo, có thể trả created: 1753859563 id: cmpl-ByvHP6AWeB1L5vWZSPNHsB12sU9db model: gpt-3.5-turbo-instruct object: text_completion system_fingerprint: fp_abc123 usage: completion_tokens: 30 prompt_tokens: 3 total_tokens: 33 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/Trò chuyện/ChatGpt/Các lượt hoàn tất của ChatGPT x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208825-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo các vectơ nhúng" Nguồn: https://docs.openaihub.net/api-45208826/ > 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/embeddings: post: summary: Tạo các vectơ nhúng deprecated: false description: >- Tạo các phần nhúng vectơ văn bản. Chọn dịch vụ nguồn thông qua `model` (chẳng hạn như `text-embedding-3-small` của OpenAI hoặc mô hình phần nhúng của Gemini). Tài liệu chính thức của OpenAI: https://platform.openai.com/docs/api-reference/embeddings operationId: v1_embeddings tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/ChatGpt/Nhúng ChatGPT - Nhúng parameters: [] requestBody: content: application/json: schema: type: object required: - model - input properties: dimensions: type: integer description: Số chiều của vectơ input: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. model: type: string description: Tên mô hình / mã định danh mô hình refName: V1EmbeddingsRequest x-apifox-orders: - dimensions - input - model x-apidog-orders: - dimensions - input - model examples: minimal: value: input: Món ăn rất ngon và nhân viên phục vụ rất thân thiện. model: text-embedding-3-small summary: minimal description: Mức tối thiểu khả dụng responses: '200': description: Được content: application/json: schema: type: object properties: data: type: array items: type: object x-apidog-orders: [] description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) 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' usage: type: object description: Thống kê mức sử dụng token x-apidog-orders: [] refName: V1EmbeddingsResponse x-apifox-orders: - data - model - object - usage x-apidog-orders: - data - model - object - usage examples: example: summary: example value: data: - {} model: chuỗi object: chuỗi usage: {} 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/Trò chuyện/ChatGpt/Nhúng ChatGPT x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208826-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tìm kiếm trên web" Nguồn: https://docs.openaihub.net/api-45208827/ > 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ìm kiếm trên web 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/Trò chuyện/ChatGpt/Tìm kiếm trên web - 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/Trò chuyện/ChatGpt/Tìm kiếm trên web x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208827-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo giọng nói gpt-4o-mini-tts" Nguồn: https://docs.openaihub.net/api-45208828/ > 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/audio/speech: post: summary: Tạo giọng nói gpt-4o-mini-tts deprecated: false description: >- Tài liệu chính thức: https://platform.openai.com/docs/guides/text-to-speech operationId: v1_audio_speech tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/ChatGpt/Âm thanh ChatGPT - Âm thanh parameters: [] requestBody: content: application/json: schema: type: object required: - model - input - voice properties: input: type: string description: Văn bản dùng để tạo âm thanh. Độ dài tối đa là 4096 ký tự. model: type: string description: 'Một trong các mô hình TTS có sẵn: tts-1 hoặc tts-1-hd' response_format: type: string description: >- Định dạng âm thanh mặc định là mp3. Các định dạng được hỗ trợ gồm: mp3, opus, aac và flac. speed: type: number description: >- Mặc định là 1. Tốc độ âm thanh được tạo. Chọn một giá trị từ 0.25 đến 4.0. Giá trị mặc định là 1.0. voice: type: string description: >- Giọng nói được sử dụng khi tạo âm thanh. Các giọng nói được hỗ trợ gồm: alloy, echo, fable, onyx, nova và shimmer. refName: V1AudioSpeechRequest x-apifox-orders: - input - model - response_format - speed - voice x-apidog-orders: - input - model - response_format - speed - voice examples: gpt_4o_mini_tts: value: input: Con cáo nâu nhanh nhẹn đã nhảy qua con chó lười biếng. model: gpt-4o-mini-tts voice: hợp kim summary: gpt_4o_mini_tts description: Tạo giọng nói gpt-4o-mini-tts responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/ChatGpt/Âm thanh ChatGPT x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208828-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Âm thanh thành văn bản gpt-4o-transcribe" Nguồn: https://docs.openaihub.net/api-45208829/ > 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/audio/transcriptions: post: summary: Âm thanh thành văn bản gpt-4o-transcribe deprecated: false description: >- Tai lieu chinh thuc: https://platform.openai.com/docs/guides/speech-to-text operationId: v1_audio_transcriptions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/ChatGpt/Âm thanh ChatGPT - Âm thanh parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: file: type: string format: binary description: >- Đối tượng tệp âm thanh (không phải tên tệp) cần được chuyển thành văn bản, ở định dạng: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav hoặc webm. example: '' language: type: string description: Mã ngôn ngữ ISO-639-1 để cải thiện độ chính xác. example: '' model: type: string description: >- Hiện tại whisper-1, gpt-4o-mini-transcribe, gpt-4o-transcribe, v.v. example: '' prompt: type: string description: Lời nhắc văn bản example: '' response_format: type: string description: json, văn bản, v.v. example: '' temperature: type: number description: >- Nhiệt độ lấy mẫu; giá trị càng cao thì kết quả càng ngẫu nhiên example: 0 required: - file - model examples: {} responses: '200': description: Được content: application/json: schema: type: object required: - text properties: text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - text x-apidog-orders: - text examples: success: summary: success value: text: một hai ba bốn năm sáu bảy tám chín mười 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/Trò chuyện/ChatGpt/Âm thanh ChatGPT x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208829-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo bản dịch (không được hỗ trợ)" Nguồn: https://docs.openaihub.net/api-45208830/ > 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/audio/translations: post: summary: Tạo bản dịch (không được hỗ trợ) deprecated: false description: >- Chuyển âm thanh thành văn bản tiếng Anh. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/audio/createTranslation operationId: v1_audio_translations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/ChatGpt/Âm thanh ChatGPT - Âm thanh parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: file: type: string format: binary description: >- Tệp âm thanh cần được dịch ở định dạng: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav hoặc webm. example: '' model: type: string description: Hiện tại whisper-1, v.v. example: '' prompt: type: string description: Lời nhắc văn bản example: '' response_format: type: string description: Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. example: '' temperature: type: number description: >- Nhiệt độ lấy mẫu; giá trị càng cao thì kết quả càng ngẫu nhiên example: 0 required: - file - model examples: {} responses: '200': description: Được content: application/json: schema: type: object required: - text properties: text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - text x-apidog-orders: - text examples: example: summary: example value: text: >- Xin chào, tôi tên là Wolfgang và tôi đến từ Đức. Hôm nay bạn đang đi đâu? 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/Trò chuyện/ChatGpt/Âm thanh ChatGPT x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208830-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "GPT-4o-audio" Nguồn: https://docs.openaihub.net/api-45208831/ > 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: GPT-4o-audio 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/Trò chuyện/ChatGpt/Âm thanh ChatGPT - 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/Trò chuyện/ChatGpt/Âm thanh ChatGPT x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208831-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo nội dung hoàn tất cuộc trò chuyện (truyền trực tuyến) [định dạng gốc]" Nguồn: https://docs.openaihub.net/api-45208832/ > 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ạo nội dung hoàn tất cuộc trò chuyện (truyền trực tuyến) [định dạng gốc] deprecated: false description: >- Điểm cuối trò chuyện văn bản MiniMax (đường dẫn xuất của Apifox là `/v1/messages`, không có tiền tố `/minimax/v1/`). https://platform.minimaxi.com/docs/api-reference/text-post operationId: minimax_v1_messages tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Claude/Định dạng gốc - MiniMax parameters: [] requestBody: content: application/json: schema: type: object required: - model - messages properties: max_completion_tokens: type: integer description: Số lượng token hoàn thành tối đa messages: type: array items: type: object required: - role - name - content properties: content: type: string description: Nội dung tin nhắn hoặc yêu cầu name: type: string description: Tên role: type: string description: >- Vai trò của tin nhắn, ví dụ: system / user / assistant / model x-apifox-orders: - content - name - role x-apidog-orders: - content - name - role description: Danh sách các tin nhắn trong cuộc trò chuyện model: type: string description: Tên mô hình / mã định danh mô hình stream: type: boolean description: Có truyền phát phản hồi hay không stream_options: type: object required: - include_usage properties: include_usage: type: boolean description: Có bao gồm thông tin sử dụng ở cuối luồng hay không description: Tùy chọn truyền luồng x-apifox-orders: - include_usage x-apidog-orders: - include_usage temperature: type: number description: >- Nhiệt độ lấy mẫu; giá trị càng cao thì kết quả càng ngẫu nhiên top_p: type: number description: Ngưỡng xác suất lấy mẫu nucleus refName: PostV1MessagesRequest x-apifox-orders: - max_completion_tokens - messages - model - stream - stream_options - temperature - top_p x-apidog-orders: - max_completion_tokens - messages - model - stream - stream_options - temperature - top_p examples: minimax_m2_1: value: max_completion_tokens: 2048 messages: - content: Bạn là một trợ lý AI chuyên nghiệp và thân thiện. name: Trợ lý AI role: Vui lòng cung cấp tài liệu kỹ thuật cần dịch. x-i18n: en-US: name: AI assistant - content: Hãy giúp tôi viết một bài thơ về mùa thu. name: Trương Tam role: user x-i18n: en-US: name: John Doe model: MiniMax-M2.1 stream: true stream_options: include_usage: true temperature: 0.9 top_p: 0.95 summary: minimax_m2_1 description: tổng hợp văn bản responses: '200': description: '' content: application/json: schema: type: object required: - id - choices - created - model - object - usage - input_sensitive - output_sensitive - input_sensitive_type - output_sensitive_type - output_sensitive_int - base_resp properties: base_resp: type: object required: - status_code - status_msg properties: status_code: type: integer description: Mã trạng thái status_msg: type: string description: Thông báo trạng thái description: >- Trình bao phản hồi của dịch vụ nền (mã trạng thái / thông báo) x-apifox-orders: - status_code - status_msg x-apidog-orders: - status_code - status_msg 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: - content - role - name - audio_content - reasoning_content properties: audio_content: type: string description: Nội dung âm thanh (thường ở dạng Base64) content: type: string description: Nội dung tin nhắn hoặc yêu cầu name: type: string description: Tên reasoning_content: type: string description: Văn bản về quá trình suy luận 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: - audio_content - content - name - reasoning_content - role x-apidog-orders: - audio_content - content - name - reasoning_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ụ input_sensitive: type: boolean description: >- Liệu đầu vào có kích hoạt cơ chế phát hiện nội dung nhạy cảm hay không input_sensitive_type: type: integer description: Loại nội dung nhạy cảm đầu vào 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' output_sensitive: type: boolean description: >- Liệu đầu ra có kích hoạt cơ chế phát hiện nội dung nhạy cảm hay không output_sensitive_int: type: integer description: Mức độ nội dung nhạy cảm của đầu ra output_sensitive_type: type: integer description: Loại nội dung nhạy cảm trong đầu ra usage: type: object required: - total_tokens - total_characters - prompt_tokens - completion_tokens - completion_tokens_details properties: completion_tokens: type: integer description: Số lượng token hoàn thành completion_tokens_details: type: object required: - reasoning_tokens properties: reasoning_tokens: type: integer description: Số token được sử dụng trong quá trình suy luận description: Phân tích chi tiết số token hoàn thành x-apifox-orders: - reasoning_tokens x-apidog-orders: - reasoning_tokens prompt_tokens: type: integer description: Số lượng token trong lời nhắc total_characters: type: integer description: Tổng số ký tự 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 - prompt_tokens - total_characters - total_tokens x-apidog-orders: - completion_tokens - completion_tokens_details - prompt_tokens - total_characters - total_tokens refName: PostV1MessagesResponse x-apifox-orders: - base_resp - choices - created - id - input_sensitive - input_sensitive_type - model - object - output_sensitive - output_sensitive_int - output_sensitive_type - usage x-apidog-orders: - base_resp - choices - created - id - input_sensitive - input_sensitive_type - model - object - output_sensitive - output_sensitive_int - output_sensitive_type - usage examples: example: summary: example value: base_resp: status_code: 0 status_msg: '' choices: - finish_reason: dừng index: 0 message: audio_content: '' content: Xin chào! Tôi có thể giúp gì cho bạn? name: MiniMax AI reasoning_content: ...đã lược bỏ role: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. created: 1755153113 id: 04ecb5d9b1921ae0fb0e8da9017a5474 input_sensitive: false input_sensitive_type: 0 model: MiniMax-M1 object: chat.completion output_sensitive: false output_sensitive_int: 0 output_sensitive_type: 0 usage: completion_tokens: 223 completion_tokens_details: reasoning_tokens: 214 prompt_tokens: 26 total_characters: 0 total_tokens: 249 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/Trò chuyện/Claude/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208832-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo cuộc trò chuyện tư duy" Nguồn: https://docs.openaihub.net/api-45208833/ > 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 cuộc trò chuyện tư duy 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/Trò chuyện/Claude/Định dạng tương thích - 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/Trò chuyện/Claude/Định dạng tương thích x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208833-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch." Nguồn: https://docs.openaihub.net/api-45208834/ > 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: Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. deprecated: false description: >- Điểm cuối trò chuyện văn bản MiniMax (đường dẫn xuất của Apifox là `/v1/messages`, không có tiền tố `/minimax/v1/`). https://platform.minimaxi.com/docs/api-reference/text-post operationId: minimax_v1_messages tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Claude/Định dạng gốc · có cấu trúc / tìm kiếm trên web - MiniMax parameters: [] requestBody: content: application/json: schema: type: object required: - model - messages properties: max_completion_tokens: type: integer description: Số lượng token hoàn thành tối đa messages: type: array items: type: object required: - role - name - content properties: content: type: string description: Nội dung tin nhắn hoặc yêu cầu name: type: string description: Tên role: type: string description: >- Vai trò của tin nhắn, ví dụ: system / user / assistant / model x-apifox-orders: - content - name - role x-apidog-orders: - content - name - role description: Danh sách các tin nhắn trong cuộc trò chuyện model: type: string description: Tên mô hình / mã định danh mô hình stream: type: boolean description: Có truyền phát phản hồi hay không stream_options: type: object required: - include_usage properties: include_usage: type: boolean description: Có bao gồm thông tin sử dụng ở cuối luồng hay không description: Tùy chọn truyền luồng x-apifox-orders: - include_usage x-apidog-orders: - include_usage temperature: type: number description: >- Nhiệt độ lấy mẫu; giá trị càng cao thì kết quả càng ngẫu nhiên top_p: type: number description: Ngưỡng xác suất lấy mẫu nucleus refName: PostV1MessagesRequest x-apifox-orders: - max_completion_tokens - messages - model - stream - stream_options - temperature - top_p x-apidog-orders: - max_completion_tokens - messages - model - stream - stream_options - temperature - top_p examples: minimax_m2_1: value: max_completion_tokens: 2048 messages: - content: Bạn là một trợ lý AI chuyên nghiệp và thân thiện. name: Trợ lý AI role: Vui lòng cung cấp tài liệu kỹ thuật cần dịch. x-i18n: en-US: name: AI assistant - content: Hãy giúp tôi viết một bài thơ về mùa thu. name: Trương Tam role: user x-i18n: en-US: name: John Doe model: MiniMax-M2.1 stream: true stream_options: include_usage: true temperature: 0.9 top_p: 0.95 summary: minimax_m2_1 description: tổng hợp văn bản responses: '200': description: '' content: application/json: schema: type: object required: - id - choices - created - model - object - usage - input_sensitive - output_sensitive - input_sensitive_type - output_sensitive_type - output_sensitive_int - base_resp properties: base_resp: type: object required: - status_code - status_msg properties: status_code: type: integer description: Mã trạng thái status_msg: type: string description: Thông báo trạng thái description: >- Trình bao phản hồi của dịch vụ nền (mã trạng thái / thông báo) x-apifox-orders: - status_code - status_msg x-apidog-orders: - status_code - status_msg 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: - content - role - name - audio_content - reasoning_content properties: audio_content: type: string description: Nội dung âm thanh (thường ở dạng Base64) content: type: string description: Nội dung tin nhắn hoặc yêu cầu name: type: string description: Tên reasoning_content: type: string description: Văn bản về quá trình suy luận 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: - audio_content - content - name - reasoning_content - role x-apidog-orders: - audio_content - content - name - reasoning_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ụ input_sensitive: type: boolean description: >- Liệu đầu vào có kích hoạt cơ chế phát hiện nội dung nhạy cảm hay không input_sensitive_type: type: integer description: Loại nội dung nhạy cảm đầu vào 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' output_sensitive: type: boolean description: >- Liệu đầu ra có kích hoạt cơ chế phát hiện nội dung nhạy cảm hay không output_sensitive_int: type: integer description: Mức độ nội dung nhạy cảm của đầu ra output_sensitive_type: type: integer description: Loại nội dung nhạy cảm trong đầu ra usage: type: object required: - total_tokens - total_characters - prompt_tokens - completion_tokens - completion_tokens_details properties: completion_tokens: type: integer description: Số lượng token hoàn thành completion_tokens_details: type: object required: - reasoning_tokens properties: reasoning_tokens: type: integer description: Số token được sử dụng trong quá trình suy luận description: Phân tích chi tiết số token hoàn thành x-apifox-orders: - reasoning_tokens x-apidog-orders: - reasoning_tokens prompt_tokens: type: integer description: Số lượng token trong lời nhắc total_characters: type: integer description: Tổng số ký tự 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 - prompt_tokens - total_characters - total_tokens x-apidog-orders: - completion_tokens - completion_tokens_details - prompt_tokens - total_characters - total_tokens refName: PostV1MessagesResponse x-apifox-orders: - base_resp - choices - created - id - input_sensitive - input_sensitive_type - model - object - output_sensitive - output_sensitive_int - output_sensitive_type - usage x-apidog-orders: - base_resp - choices - created - id - input_sensitive - input_sensitive_type - model - object - output_sensitive - output_sensitive_int - output_sensitive_type - usage examples: example: summary: example value: base_resp: status_code: 0 status_msg: '' choices: - finish_reason: dừng index: 0 message: audio_content: '' content: Xin chào! Tôi có thể giúp gì cho bạn? name: MiniMax AI reasoning_content: ...đã lược bỏ role: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. created: 1755153113 id: 04ecb5d9b1921ae0fb0e8da9017a5474 input_sensitive: false input_sensitive_type: 0 model: MiniMax-M1 object: chat.completion output_sensitive: false output_sensitive_int: 0 output_sensitive_type: 0 usage: completion_tokens: 223 completion_tokens_details: reasoning_tokens: 214 prompt_tokens: 26 total_characters: 0 total_tokens: 249 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/Trò chuyện/Claude/Định dạng gốc · có cấu trúc / tìm kiếm trên web x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208834-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "tạo văn bản" Nguồn: https://docs.openaihub.net/api-45208835/ > 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/gemini-2.5-pro:generateContent: post: summary: tạo văn bản deprecated: false description: >- Tài liệu chính thức: https://ai.google.dev/gemini-api/docs/video-understanding?hl=zh-cn operationId: gemini_v1beta_2_5_pro_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - contents properties: contents: type: array items: type: object properties: parts: type: array items: type: object properties: inline_data: type: object required: - mime_type - data properties: data: type: string description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) mime_type: type: string description: >- Loại MIME của phương tiện, ví dụ: image/png, audio/wav description: Dữ liệu phương tiện nội tuyến x-apifox-orders: - data - mime_type x-apidog-orders: - data - mime_type text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - inline_data - text x-apidog-orders: - inline_data - text description: Các phần nội dung (văn bản, hình ảnh, âm thanh, v.v.) x-apifox-orders: - parts x-apidog-orders: - parts description: Danh sách nội dung (nhiều lượt / đa phương thức) x-apifox-orders: - contents x-apidog-orders: - contents examples: _url_single: value: contents: - parts: - file_data: file_uri: >- Vui lòng dán nội dung tài liệu cần dịch; URL API này không thể được truy cập trực tiếp nếu không có thông tin xác thực. mime_type: video/mp4 - text: Vui lòng tóm tắt video trong 3 câu. role: user summary: _url_single description: Khả năng hiểu video-url [định dạng gốc] đang được phát triển responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208835-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Sinh văn bản (luồng)" Nguồn: https://docs.openaihub.net/api-45208836/ > 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/gemini-3-pro-preview:streamGenerateContent: post: summary: Sinh văn bản (luồng) deprecated: false description: >- Vui lòng cung cấp nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp. operationId: gemini_v1beta_3_pro_preview_stream_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: alt in: query description: Định dạng phản hồi; sse thường được dùng để truyền phát trực tuyến required: false example: sse schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - contents properties: contents: type: array items: type: object properties: parts: type: array items: type: object properties: text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - text x-apidog-orders: - text description: Các phần nội dung (văn bản, hình ảnh, âm thanh, v.v.) x-apifox-orders: - parts x-apidog-orders: - parts description: Danh sách nội dung (nhiều lượt / đa phương thức) x-apifox-orders: - contents x-apidog-orders: - contents examples: __single: value: contents: - parts: - text: Xin chào role: user generationConfig: temperature: 1 thinkingConfig: includeThoughts: true thinkingBudget: 26240 topP: 1 systemInstruction: parts: - text: Bạn là một con mèo. Tên của bạn là Neko. summary: __single description: luồng tạo văn bản responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208836-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo văn bản + suy luận (luồng)" Nguồn: https://docs.openaihub.net/api-45208837/ > 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/gemini-2.5-pro:streamGenerateContent: post: summary: Tạo văn bản + suy luận (luồng) deprecated: false description: >- Vui lòng cung cấp nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp. operationId: gemini_v1beta_2_5_pro_stream_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: alt in: query description: Định dạng phản hồi; sse thường được dùng để truyền phát trực tuyến required: false example: sse schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - contents properties: contents: type: array items: type: object properties: parts: type: array items: type: object properties: text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - text x-apidog-orders: - text description: Các phần nội dung (văn bản, hình ảnh, âm thanh, v.v.) x-apifox-orders: - parts x-apidog-orders: - parts description: Danh sách nội dung (nhiều lượt / đa phương thức) x-apifox-orders: - contents x-apidog-orders: - contents examples: __single: value: contents: - parts: - text: 1+2+3+4+5+....+999? role: user generationConfig: temperature: 1 thinkingConfig: includeThoughts: true thinkingBudget: 26240 topP: 1 safetySettings: - category: HARM_CATEGORY_HATE_SPEECH threshold: TẮT - category: HARM_CATEGORY_SEXUALLY_EXPLICIT threshold: TẮT - category: HẠNG_MỤC_GÂY_RỐI threshold: TẮT - category: HARM_CATEGORY_DANGEROUS_CONTENT threshold: TẮT - category: HARM_CATEGORY_CIVIC_INTEGRITY threshold: BLOCK_NONE systemInstruction: parts: - text: xin chào role: user tools: [] summary: __single description: Tạo văn bản + luồng suy nghĩ responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208837-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo hình ảnh" Nguồn: https://docs.openaihub.net/api-45208838/ > 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/{modeName}:generateContent: post: summary: Tạo hình ảnh deprecated: false description: >- Tài liệu chính thức: https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn operationId: gemini_v1beta_mode_name_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: modeName in: path description: |- Tên mô hình: gemini-2.5-flash-image gemini-2.5-flash-image-preview gemini-3-pro-image-preview gemini-3.1-flash-image-preview required: true example: gemini-2.5-flash-image-preview schema: type: string - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - contents properties: contents: type: array items: type: object required: - parts properties: parts: type: array items: type: object properties: inline_data: type: object required: - mime_type - data properties: data: type: string description: >- Base64 của hình ảnh hỗ trợ tối đa 14 hình ảnh đầu vào. mime_type: type: string description: Kiểu MIME của hình ảnh description: Dữ liệu được nhúng trong hình ảnh x-apifox-orders: - data - mime_type x-apidog-orders: - data - mime_type text: type: string description: từ trong lời nhắc x-apifox-orders: - inline_data - text x-apidog-orders: - inline_data - text description: >- Danh sách các phần nội dung; có thể bao gồm văn bản, inline_data / inlineData, v.v. x-apifox-orders: - parts x-apidog-orders: - parts description: >- Danh sách nội dung cuộc hội thoại; mỗi mục gồm các phần (văn bản/hình ảnh/v.v.) generationConfig: type: object properties: imageConfig: type: object properties: aspectRatio: type: string description: >- Tỷ lệ khung hình: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 hỗ trợ tất cả các mô hình 1:4, 1:8, 4:1 và 8:1 chỉ hỗ trợ các mô hình Gemini 3.1. imageSize: type: string description: >- Độ phân giải: 0.5K, 1K, 2K, 4K Mặc định: 1K Lưu ý: Gemini 2.5 chỉ hỗ trợ 1K, 0.5K chỉ hỗ trợ mô hình Gemini 3.1, giá trị phải được điền là "512" description: Cấu hình hình ảnh x-apifox-orders: - aspectRatio - imageSize x-apidog-orders: - aspectRatio - imageSize responseModalities: type: array items: type: string description: |- Chế độ phản hồi: Text, Image Mặc định: ["Text", "Image"] description: Tạo cấu hình x-apifox-orders: - imageConfig - responseModalities x-apidog-orders: - imageConfig - responseModalities response_format: type: string description: >- Điền vào url và trả về url; nếu không, hãy điền base64 mặc định. refName: PostV1betaModelsModeNameGenerateContentRequest x-apifox-orders: - contents - generationConfig - response_format x-apidog-orders: - contents - generationConfig - response_format examples: {} responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208838-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo hình ảnh gemini-2.5-flash-image" Nguồn: https://docs.openaihub.net/api-45208839/ > 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/gemini-2.5-flash-image:generateContent: post: summary: Tạo hình ảnh gemini-2.5-flash-image deprecated: false description: >- Tài liệu chính thức: https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#gemini-image-editing operationId: gemini_v1beta_2_5_flash_image_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - contents - generationConfig properties: contents: type: array items: type: object properties: parts: type: array items: type: object properties: inline_data: type: object required: - mime_type - data properties: data: type: string description: >- Dữ liệu phương tiện được mã hóa Base64 (không có tiền tố URI data:) mime_type: type: string description: >- Loại MIME của phương tiện, ví dụ: image/png, image/jpeg, audio/wav description: >- Dữ liệu phương tiện nội tuyến (hình ảnh/âm thanh/v.v.) x-apifox-orders: - data - mime_type x-apidog-orders: - data - mime_type text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - inline_data - text x-apidog-orders: - inline_data - text description: >- Danh sách các phần nội dung; có thể bao gồm văn bản, inline_data / inlineData, v.v. x-apifox-orders: - parts x-apidog-orders: - parts description: >- Danh sách nội dung cuộc hội thoại; mỗi mục gồm các phần (văn bản/hình ảnh/v.v.) generationConfig: type: object required: - responseModalities - imageConfig properties: imageConfig: type: object required: - aspectRatio properties: aspectRatio: type: string description: >- Tỷ lệ khung hình của ảnh đầu ra, ví dụ: 1:1, 16:9, 9:16 description: Cấu hình đầu ra hình ảnh x-apifox-orders: - aspectRatio x-apidog-orders: - aspectRatio responseModalities: type: array items: type: string description: >- Phương thức phản hồi, ví dụ: ["TEXT"], ["IMAGE"], ["AUDIO"] description: >- Cấu hình tạo sinh (phương thức, kích thước hình ảnh, giọng nói, v.v.) x-apifox-orders: - imageConfig - responseModalities x-apidog-orders: - imageConfig - responseModalities response_format: type: string description: >- Điền vào url và trả về url; nếu không, hãy điền base64 mặc định. refName: PostV1betaModelsGemini25FlashImageGenerateContentRequest x-apifox-orders: - contents - generationConfig - response_format x-apidog-orders: - contents - generationConfig - response_format examples: gemini_25_flash_image_single: value: contents: - parts: - text: >- 'Chào, đây là ảnh của tôi. Bạn có thể thêm một con lạc đà không bướu bên cạnh tôi không - inline_data: data: iVBORw0KGgoAAAANSUhEUgAABAAAAAKoCAIA... mime_type: image/jpeg role: user generationConfig: imageConfig: aspectRatio: '16:9' responseModalities: - Vui lòng cung cấp nội dung tài liệu cần dịch. - HÌNH ẢNH summary: gemini_25_flash_image_single description: >- Tính năng tạo ảnh gemini-2.5-flash-image kiểm soát tỷ lệ khung hình gemini_25_flash_image_single_2: value: contents: - parts: - text: >- 'Chào, đây là ảnh của tôi. Bạn có thể thêm một con lạc đà không bướu bên cạnh tôi không - inline_data: data: iVBORw0KGgoAAAANSUhEUgAABAAAAAKoCAIA... mime_type: image/jpeg role: user generationConfig: imageConfig: aspectRatio: '16:9' responseModalities: - Vui lòng cung cấp nội dung tài liệu cần dịch. - HÌNH ẢNH response_format: url summary: gemini_25_flash_image_single_2 description: >- Tính năng tạo ảnh gemini-2.5-flash-image kiểm soát tỷ lệ khung hình responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208839-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo ảnh bằng gemini-3-pro-image-preview, kiểm soát tỷ lệ khung hình + độ rõ nét" Nguồn: https://docs.openaihub.net/api-45208840/ > 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/gemini-3-pro-image-preview:generateContent: post: summary: >- Tạo ảnh bằng gemini-3-pro-image-preview, kiểm soát tỷ lệ khung hình + độ rõ nét deprecated: false description: >- Tài liệu chính thức: https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#gemini-image-editing operationId: gemini_v1beta_3_pro_image_preview_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - contents - generationConfig properties: contents: type: array items: type: object properties: parts: type: array items: type: object properties: inline_data: type: object required: - mime_type - data properties: data: type: string description: >- Dữ liệu phương tiện được mã hóa Base64 (không có tiền tố URI data:) mime_type: type: string description: >- Loại MIME của phương tiện, ví dụ: image/png, image/jpeg, audio/wav description: >- Dữ liệu phương tiện nội tuyến (hình ảnh/âm thanh/v.v.) x-apifox-orders: - data - mime_type x-apidog-orders: - data - mime_type text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - inline_data - text x-apidog-orders: - inline_data - text description: >- Danh sách các phần nội dung; có thể bao gồm văn bản, inline_data / inlineData, v.v. x-apifox-orders: - parts x-apidog-orders: - parts description: >- Danh sách nội dung cuộc hội thoại; mỗi mục gồm các phần (văn bản/hình ảnh/v.v.) generationConfig: type: object required: - responseModalities properties: responseModalities: type: array items: type: string description: >- Phương thức phản hồi, ví dụ: ["TEXT"], ["IMAGE"], ["AUDIO"] description: >- Cấu hình tạo sinh (phương thức, kích thước hình ảnh, giọng nói, v.v.) x-apifox-orders: - responseModalities x-apidog-orders: - responseModalities response_format: type: string description: >- Điền vào url và trả về url; nếu không, hãy điền base64 mặc định. refName: PostV1betaModelsGemini3ProImagePreviewGenerateContentRequest x-apifox-orders: - contents - generationConfig - response_format x-apidog-orders: - contents - generationConfig - response_format examples: example_single: value: contents: - parts: - text: >- 'Chào, đây là ảnh của tôi. Bạn có thể thêm một con lạc đà không bướu bên cạnh tôi không - inline_data: data: iVBORw0KGgoAAAANSUhEUgAABAAAAAKoCAIA... mime_type: image/jpeg role: user generationConfig: responseModalities: - Vui lòng cung cấp nội dung tài liệu cần dịch. - HÌNH ẢNH response_format: url summary: example_single description: Chỉnh sửa ảnh gemini_3_pro_image_preview_single: value: contents: - parts: - text: >- 'Chào, đây là ảnh của tôi. Bạn có thể thêm một con lạc đà không bướu bên cạnh tôi không - inline_data: data: iVBORw0KGgoAAAANSUhEUgAABAAAAAKoCAIA... mime_type: image/jpeg role: user generationConfig: imageConfig: aspectRatio: '9:16' imageSize: 1K responseModalities: - Vui lòng cung cấp nội dung tài liệu cần dịch. - HÌNH ẢNH summary: gemini_3_pro_image_preview_single description: >- Tạo ảnh bằng gemini-3-pro-image-preview, kiểm soát tỷ lệ khung hình + độ rõ nét responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208840-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "tìm kiếm trên Google" Nguồn: https://docs.openaihub.net/api-45208841/ > 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/gemini-2.5-flash:generateContent: post: summary: tìm kiếm trên Google deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch vào đây. Tôi không thể dịch toàn bộ nội dung chỉ từ liên kết, nhưng có thể dịch phần văn bản bạn cung cấp sang tiếng Việt và giữ nguyên Markdown, mã nguồn, định danh, URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON cùng định dạng. operationId: gemini_v1beta_2_5_flash_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - contents properties: contents: type: array items: type: object properties: parts: type: array items: type: object properties: inline_data: type: object required: - mime_type - data properties: data: type: string description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) mime_type: type: string description: >- Loại MIME của phương tiện, ví dụ: image/png, audio/wav description: Dữ liệu phương tiện nội tuyến x-apifox-orders: - data - mime_type x-apidog-orders: - data - mime_type text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - inline_data - text x-apidog-orders: - inline_data - text description: Các phần nội dung (văn bản, hình ảnh, âm thanh, v.v.) x-apifox-orders: - parts x-apidog-orders: - parts description: Danh sách nội dung (nhiều lượt / đa phương thức) x-apifox-orders: - contents x-apidog-orders: - contents examples: google_search_single: value: contents: - parts: - text: Hôm nay thời tiết ở Trùng Khánh thế nào? role: user tools: - googleSearch: {} summary: google_search_single description: tìm kiếm trên Google responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208841-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Imagen 4 đang được phát triển" Nguồn: https://docs.openaihub.net/api-45208842/ > 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/imagen-4.0-generate-001:predict: post: summary: Imagen 4 đang được phát triển deprecated: false description: >- Tài liệu chính thức: https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn operationId: gemini_v1beta_imagen_4_0_predict tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - instances - parameters properties: instances: type: array items: type: object properties: prompt: type: string description: Lời nhắc văn bản x-apifox-orders: - prompt x-apidog-orders: - prompt description: Cac doi tuong du doan cua Imagen parameters: type: object required: - sampleCount properties: sampleCount: type: integer description: Số lượng hình ảnh cần tạo description: Các tham số tạo ảnh của Imagen x-apifox-orders: - sampleCount x-apidog-orders: - sampleCount refName: PostV1betaModelsImagen40Generate001PredictRequest x-apifox-orders: - instances - parameters x-apidog-orders: - instances - parameters examples: imagen_4_single: value: instances: - prompt: Bé gái parameters: sampleCount: 4 summary: imagen_4_single description: Imagen 4 đang được phát triển responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208842-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo văn bản gemini-3-pro-preview:generateContent" Nguồn: https://docs.openaihub.net/api-45208843/ > 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/gemini-3-pro-preview:generateContent: post: summary: Tạo văn bản gemini-3-pro-preview:generateContent deprecated: false description: >- Vui lòng cung cấp nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp. operationId: gemini_v1beta_3_pro_preview_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - contents properties: contents: type: array items: type: object properties: parts: type: array items: type: object properties: text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - text x-apidog-orders: - text description: Các phần nội dung (văn bản, hình ảnh, âm thanh, v.v.) x-apifox-orders: - parts x-apidog-orders: - parts description: Danh sách nội dung (nhiều lượt / đa phương thức) x-apifox-orders: - contents x-apidog-orders: - contents examples: gemini_3_pro_previewgeneratecontent_single: value: contents: - parts: - text: Bạn là ai? role: user generationConfig: temperature: 1 thinkingConfig: includeThoughts: true thinkingBudget: 26240 topP: 1 systemInstruction: parts: - text: >- Bạn là một chú heo con. Bạn sẽ thêm 'ụt ịt' vào đầu câu trả lời. summary: gemini_3_pro_previewgeneratecontent_single description: Tạo văn bản gemini-3-pro-preview:generateContent responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208843-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "gemini-tts chuyển văn bản thành giọng nói" Nguồn: https://docs.openaihub.net/api-45208844/ > 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/gemini-2.5-pro-preview-tts:generateContent: post: summary: gemini-tts chuyển văn bản thành giọng nói deprecated: false description: >- Vui lòng cung cấp nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp. operationId: gemini_v1beta_2_5_pro_preview_tts_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - contents - generationConfig properties: contents: type: array items: type: object properties: parts: type: array items: type: object properties: text: type: string description: Nội dung văn bản để tổng hợp thành giọng nói description: Phần văn bản x-apifox-orders: - text x-apidog-orders: - text description: Các phần nội dung; TTS sử dụng văn bản description: Nội dung một lượt x-apifox-orders: - parts x-apidog-orders: - parts description: >- Nội dung cuộc trò chuyện; cung cấp văn bản để đọc trong parts.text generationConfig: type: object required: - responseModalities - speechConfig properties: responseModalities: type: array items: type: string description: Tên phương thức, thường là AUDIO description: >- Các phương thức phản hồi; đối với TTS, hãy sử dụng ["AUDIO"] speechConfig: type: object required: - voiceConfig properties: voiceConfig: type: object required: - prebuiltVoiceConfig properties: prebuiltVoiceConfig: type: object required: - voiceName properties: voiceName: type: string description: >- Tên giọng nói cài sẵn, ví dụ: Kore, Puck, Charon, Fenrir, Aoede description: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. x-apifox-orders: - voiceName x-apidog-orders: - voiceName description: Cấu hình giọng nói; chỉ định tên giọng nói định sẵn x-apifox-orders: - prebuiltVoiceConfig x-apidog-orders: - prebuiltVoiceConfig description: Cấu hình tổng hợp giọng nói x-apifox-orders: - voiceConfig x-apidog-orders: - voiceConfig description: >- Cấu hình tạo; phải bao gồm phương thức AUDIO và cấu hình giọng nói x-apifox-orders: - responseModalities - speechConfig x-apidog-orders: - responseModalities - speechConfig refName: PostV1betaModelsGemini25ProPreviewTtsGenerateContentRequest description: >- Nội dung yêu cầu chuyển văn bản thành giọng nói của Gemini 2.5 Pro Preview TTS x-apifox-orders: - contents - generationConfig x-apidog-orders: - contents - generationConfig examples: gemini_tts_single: value: contents: - parts: - text: Chúc bạn một ngày thật tuyệt vời! generationConfig: responseModalities: - ÂM THANH speechConfig: voiceConfig: prebuiltVoiceConfig: voiceName: Kore summary: gemini_tts_single description: gemini-tts chuyển văn bản thành giọng nói responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: candidates: - content: parts: - inlineData: data: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA... mimeType: audio/L16;codec=pcm;rate=24000 role: mô hình finishReason: DỪNG LẠI index: 0 safetyRatings: [] modelVersion: gemini-2.5-pro-preview-tts promptFeedback: safetyRatings: [] responseId: nXxoaf7mPM6j_uMPyICzkQo usageMetadata: candidatesTokenCount: 51 promptTokenCount: 9 promptTokensDetails: - modality: Vui lòng cung cấp nội dung tài liệu cần dịch. tokenCount: 9 thoughtsTokenCount: 0 totalTokenCount: 60 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208844-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Nhúng" Nguồn: https://docs.openaihub.net/api-45208845/ > 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/gemini-embedding-001:embedContent: post: summary: Nhúng deprecated: false description: >- https://ai.google.dev/gemini-api/docs/embeddings?hl=zh-cn#rest_3 Tài liệu chính thức operationId: gemini_v1beta_embedding_001_embed_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: Content-Type in: header description: Loại nội dung của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string requestBody: content: application/json: schema: type: object required: - content properties: content: type: object properties: parts: type: array items: type: object properties: text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. x-apifox-orders: - text x-apidog-orders: - text description: >- Danh sách các phần nội dung; có thể bao gồm văn bản, inline_data / inlineData, v.v. description: Nội dung cần nhúng. x-apifox-orders: - parts x-apidog-orders: - parts output_dimensionality: type: integer description: Tùy chọn giảm số chiều của biểu diễn nhúng đầu ra. taskType: type: string description: Loại tác vụ tùy chọn mà embedding sẽ được sử dụng cho. refName: PostV1betaModelsGeminiEmbedding001EmbedContentRequest x-apifox-orders: - content - output_dimensionality - taskType x-apidog-orders: - content - output_dimensionality - taskType examples: example_single: value: content: parts: - text: Ý nghĩa của cuộc sống là gì? output_dimensionality: 768 taskType: SEMANTIC_SIMILARITY summary: example_single description: nhúng văn bản responses: '200': description: '' content: application/json: schema: type: object properties: embeddings: type: object description: Danh sách các vectơ nhúng x-apidog-orders: [] x-apifox-orders: - embeddings x-apidog-orders: - embeddings examples: example: summary: example value: embedding: values: - -0.0296398 - -0.010636787 - 0.012426536 - -0.043735605 - -0.012861362 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208845-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "gemini-3.1-flash-lite-image" Nguồn: https://docs.openaihub.net/api-45208846/ > 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/gemini-3.1-flash-lite-image:generateContent: post: summary: gemini-3.1-flash-lite-image deprecated: false description: >- Tài liệu chính thức: https://ai.google.dev/gemini-api/docs/image-generation — Gemini 3.1 Flash-Lite Image (Nano Banana 2 Lite) hỗ trợ chuyển văn bản thành hình ảnh, hình ảnh thành hình ảnh, video thành hình ảnh và chỉnh sửa hình ảnh. operationId: gemini_v1beta_3_1_flash_lite_image_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - 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: - contents properties: contents: type: array items: type: object required: - parts properties: parts: type: array items: type: object properties: fileData: type: object required: - mimeType - fileUri properties: fileUri: type: string description: >- URI của tệp phương tiện, chẳng hạn như gs://bucket/object hoặc URI tệp do API Tệp của Google trả về. Ràng buộc từ hệ thống đầu nguồn: Mô hình phải có khả năng truy cập tệp. mimeType: type: string enum: - image/png - image/jpeg - image/webp - video/mp4 enumDetails: - value: image/png displayName: PNG description: Hình ảnh tham chiếu / nguồn để chỉnh sửa - value: image/jpeg displayName: JPEG description: Hình ảnh tham chiếu / nguồn để chỉnh sửa - value: image/webp displayName: WebP description: Hình ảnh tham khảo - value: video/mp4 displayName: MP4 description: Đầu vào video thành hình ảnh description: Loại MIME của tệp. description: >- Các tệp phương tiện được tham chiếu bằng URI, thường được dùng cho các hình ảnh tham khảo được tải lên bằng GCS/File API. x-apifox-orders: - fileUri - mimeType x-apidog-orders: - fileUri - mimeType inlineData: type: object required: - mimeType - data properties: data: type: string description: >- Nội dung phương tiện được mã hóa Base64 không có tiền tố URI dữ liệu. Các giới hạn từ hệ thống nguồn: Tổng kích thước của một tệp đơn lẻ là ≤500MB. mimeType: type: string enum: - image/png - image/jpeg - image/webp - image/gif - video/mp4 - video/quicktime - video/webm enumDetails: - value: image/png displayName: Hình ảnh PNG description: >- Phù hợp cho các trường hợp chỉnh sửa và nền trong suốt - value: image/jpeg displayName: Hình ảnh JPEG description: >- Phù hợp với hình ảnh tham chiếu giống ảnh chụp - value: image/webp displayName: Hình ảnh WebP description: Tham chiếu hình ảnh đã nén - value: image/gif displayName: Hình ảnh GIF description: >- Tham chiếu động; được xử lý như một khung hình tĩnh - value: video/mp4 displayName: Video MP4 description: >- Đầu vào từ video sang hình ảnh; được lấy mẫu ở tốc độ 1 khung hình/giây - value: video/quicktime displayName: Video MOV description: Đầu vào video thành hình ảnh - value: video/webm displayName: Video WebM description: Đầu vào video thành hình ảnh description: >- Loại MIME của phương tiện. image/png, image/jpeg thường được dùng cho hình ảnh; video/mp4 thường được dùng cho video. Ràng buộc từ hệ thống nguồn: Trả về 400 khi định dạng không hợp lệ. description: >- Dữ liệu phương tiện nội tuyến, thường được dùng để tải ảnh/video cục bộ lên bằng Base64. Các giới hạn từ dịch vụ nguồn: Mỗi ảnh được tính phí tương đương 1120 token đầu vào; video được lấy mẫu ở tốc độ 1 khung hình/giây, với 70 token cho mỗi khung hình, và rãnh âm thanh bị bỏ qua. x-apifox-orders: - data - mimeType x-apidog-orders: - data - mimeType text: type: string description: >- Các từ trong lời nhắc văn bản hoặc hướng dẫn chỉnh sửa. Bắt buộc khi tạo ảnh từ văn bản; được sử dụng kết hợp với phần ảnh khi tạo hoặc chỉnh sửa ảnh. anyOf: - type: string - type: string - type: string description: >- Một phần nội dung đơn lẻ bị phân mảnh. Thông thường, chỉ một loại nội dung chính được sử dụng cho cùng một phần. x-apifox-orders: - fileData - inlineData - text x-apidog-orders: - fileData - inlineData - text description: >- Danh sách các đoạn tin nhắn. Mỗi phần chứa ít nhất một trong các trường text, inlineData và fileData. Số lượng ảnh tham chiếu tối đa là 14, và khuyến nghị chính thức là ≤3 để đạt độ nhất quán tốt nhất. role: type: string enum: - user - model enumDetails: - value: user displayName: Người dùng description: >- Dữ liệu đầu vào của người dùng bao gồm văn bản, hình ảnh, video, v.v. - value: mô hình displayName: Mô hình description: >- Phản hồi lịch sử mô hình cho ngữ cảnh chỉnh sửa hình ảnh nhiều lượt description: >- Vai trò của tin nhắn. Mục đầu tiên thường là `user`; bạn có thể luân phiên giữa `user`/`model` trong nhiều vòng chỉnh sửa. x-apifox-orders: - parts - role x-apidog-orders: - parts - role description: >- Danh sách nội dung hội thoại là bắt buộc. Phải bao gồm ít nhất 1 tin nhắn của người dùng khi tạo sơ đồ; phải đính kèm inlineData hoặc fileData vào parts khi tạo/chỉnh sửa sơ đồ; trong nhiều vòng chỉnh sửa, các tin nhắn trước đó phải được thêm vào theo thứ tự thời gian. Các giới hạn của hệ thống thượng nguồn: Tổng số token đầu vào không vượt quá 65536; dữ liệu đầu vào của mỗi tệp không vượt quá 500MB. generationConfig: type: object properties: candidateCount: type: integer description: >- Số lượng kết quả ứng viên. Mô hình này được cố định là 1; các giá trị khác được truyền vào có thể bị bỏ qua hoặc gây ra lỗi. imageConfig: type: object properties: aspectRatio: type: string enum: - '1:1' - '3:2' - '2:3' - '3:4' - '4:3' - '1:4' - '4:1' - '4:5' - '5:4' - '1:8' - '8:1' - '9:16' - '16:9' - '21:9' enumDetails: - value: '1:1' displayName: Hình vuông 1:1 description: >- Mặc định; phù hợp cho bài đăng trên mạng xã hội và ảnh đại diện - value: '3:2' displayName: 3:2 nằm ngang description: Tỷ lệ ảnh ngang tiêu chuẩn - value: '2:3' displayName: Chân dung 2:3 description: Tỷ lệ ảnh chân dung tiêu chuẩn - value: '3:4' displayName: Chân dung 3:4 description: Áp phích khổ dọc - value: '4:3' displayName: Khung ngang 4:3 description: Tỷ lệ khung hình ngang cổ điển - value: '1:4' displayName: Chân dung siêu hẹp 1:4 description: Dải dọc siêu cao - value: '4:1' displayName: khổ ngang siêu rộng 4:1 description: Dải ngang siêu rộng - value: '4:5' displayName: Chân dung 4:5 description: Tỷ lệ ảnh chân dung Instagram phổ biến - value: '5:4' displayName: 5:4 chiều ngang description: Khổ ngang gần vuông - value: '1:8' displayName: 1:8 dọc siêu hẹp description: Hình ảnh cực cao - value: '8:1' displayName: 8:1 khung hình ngang siêu rộng description: Hình ảnh cực rộng - value: '9:16' displayName: 9:16 dọc description: >- Ảnh bìa video ngắn và ảnh chân dung chụp bằng điện thoại - value: '16:9' displayName: 16:9 ngang description: Biểu ngữ, hình thu nhỏ, bài thuyết trình - value: '21:9' displayName: Màn hình siêu rộng 21:9 description: Diện mạo màn ảnh rộng đậm chất điện ảnh description: >- Tỷ lệ khung hình của ảnh đầu ra. Mặc định là 1:1. Chỉ tỷ lệ được thay đổi, không thay đổi độ lớn 1K pixel. imageSize: type: string description: >- Độ phân giải đầu ra. Mô hình này chỉ hỗ trợ 1K (xấp xỉ 1024×1024 pixel). Đầu vào 512, 2K, 4K sẽ bị từ chối hoặc bỏ qua. Bắt buộc phải dùng chữ K viết hoa. outputMimeType: type: string enum: - image/png - image/jpeg - image/webp enumDetails: - value: image/png displayName: PNG description: >- Khuyến nghị mặc định; phù hợp khi cần tính minh bạch - value: image/jpeg displayName: JPEG description: Kích thước nhỏ hơn; phù hợp với đầu ra kiểu ảnh - value: image/webp displayName: WebP description: Định dạng hình ảnh nén cao description: >- Kiểu MIME của ảnh đầu ra. Nếu không được truyền vào, kiểu này sẽ do dịch vụ nguồn quyết định. description: >- Cấu hình tạo ảnh. Mô hình này chỉ hỗ trợ đầu ra 1K; không hỗ trợ 512px / 2K / 4K. x-apifox-orders: - aspectRatio - imageSize - outputMimeType x-apidog-orders: - aspectRatio - imageSize - outputMimeType maxOutputTokens: type: integer description: >- Số lượng token đầu ra tối đa. Đầu ra của mô hình bị giới hạn ở 4096. Đầu ra hình ảnh được tính phí ở mức 1120 token/hình ảnh. responseModalities: type: array items: type: string enum: - IMAGE - TEXT enumDetails: - value: HÌNH ẢNH displayName: Hình ảnh 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, chỗ dành sẵn, cấu trúc JSON và định dạng. Chỉ trả về văn bản đã dịch và không còn ký tự Hán nào. Trả về các hình ảnh đã tạo; bắt buộc đối với việc tạo hình ảnh - value: Vui lòng cung cấp nội dung tài liệu cần dịch. displayName: Vui lòng cung cấp nội dung tài liệu cần dịch. description: >- Cũng có thể trả về ghi chú dạng văn bản; chỉ văn bản sẽ không tạo ra hình ảnh description: >- Danh sách phương thức đầu ra. Phải bao gồm IMAGE khi tạo hình ảnh; nếu cũng cần mô tả bằng văn bản, có thể truyền ["IMAGE", "TEXT"]. Sẽ không trả về hình ảnh khi chỉ truyền TEXT. temperature: type: number description: >- Nhiệt độ lấy mẫu. Giá trị càng cao thì kết quả càng đa dạng. Giá trị mặc định của dịch vụ nguồn là 1.0. thinkingConfig: type: object properties: includeThoughts: type: boolean description: >- Có trả về quá trình suy luận trong phản hồi hay không. Mặc định là false. Phần suy luận được trả về không được hiển thị trong hình ảnh cuối cùng. thinkingLevel: type: string enum: - MINIMAL - HIGH enumDetails: - value: TỐI THIỂU displayName: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. description: >- Giảm thiểu số token dùng cho suy luận; phù hợp với việc tạo hình ảnh đơn giản và độ trễ thấp - value: CAO displayName: >- Vui lòng gửi nội dung tài liệu kỹ thuật cần dịch. description: >- Suy luận nội bộ nhiều hơn; phù hợp với việc soạn nội dung phức tạp và các lời nhắc chi tiết description: >- Cường độ suy luận. Không thể sử dụng cùng với thinkingBudget. description: >- Cấu hình chế độ suy luận, không bắt buộc. Thực hiện suy luận nội bộ trước khi sử dụng chế độ này trong các tác vụ soạn thảo phức tạp. MINIMAL phù hợp khi cần độ trễ thấp; HIGH phù hợp với các lời nhắc phức tạp. Token suy luận được tính vào chi phí đầu ra. x-apifox-orders: - includeThoughts - thinkingLevel x-apidog-orders: - includeThoughts - thinkingLevel topP: type: number description: >- Ngưỡng lấy mẫu kernel. Giá trị mặc định từ nguồn thượng nguồn là 0.95. description: >- Tạo cấu hình. Trong các trường hợp ảnh thô, responseModalities phải chứa IMAGE; imageConfig kiểm soát tỷ lệ khung hình và định dạng đầu ra; thinkingConfig là tùy chọn. x-apifox-orders: - candidateCount - imageConfig - maxOutputTokens - responseModalities - temperature - thinkingConfig - topP x-apidog-orders: - candidateCount - imageConfig - maxOutputTokens - responseModalities - temperature - thinkingConfig - topP response_format: type: string description: >- Điền vào url và trả về url; nếu không, hãy điền base64 mặc định. safetySettings: type: array items: type: object required: - category - threshold properties: category: type: string enum: - HARM_CATEGORY_HARASSMENT - HARM_CATEGORY_HATE_SPEECH - HARM_CATEGORY_SEXUALLY_EXPLICIT - HARM_CATEGORY_DANGEROUS_CONTENT description: Danh mục bảo mật. threshold: type: string enum: - BLOCK_NONE - BLOCK_ONLY_HIGH - BLOCK_MEDIUM_AND_ABOVE - BLOCK_LOW_AND_ABOVE description: Ngưỡng chặn. x-apifox-orders: - category - threshold x-apidog-orders: - category - threshold description: >- Cài đặt bảo mật, không bắt buộc. Kiểm soát các ngưỡng lọc đối với nhiều loại nội dung có hại. systemInstruction: type: object required: - parts properties: parts: type: array items: type: object required: - text properties: text: type: string description: Văn bản lệnh hệ thống. x-apifox-orders: - text x-apidog-orders: - text description: >- Danh sách các phần nội dung; có thể bao gồm văn bản, inline_data / inlineData, v.v. description: >- Lệnh hệ thống, không bắt buộc. Được dùng để giới hạn phong cách, ngôn ngữ, định dạng đầu ra, v.v. Khi tạo hình ảnh, bắt buộc phải "chỉ xuất các mô tả liên quan đến hình ảnh" hoặc giới hạn nội dung đầu ra trong các tình huống dịch thuật. x-apifox-orders: - parts x-apidog-orders: - parts refName: PostV1betaModelsGemini31FlashLiteImageGenerateContentRequest description: >- Phần thân yêu cầu tạo ảnh phía nguồn của Gemini 3.1 Flash-Lite Image (gemini-3.1-flash-lite-image / Nano Banana 2 Lite). Hỗ trợ chuyển văn bản thành ảnh, chuyển ảnh thành ảnh, chuyển video thành ảnh và chỉnh sửa ảnh trong một hoặc nhiều lượt. Mô hình này chỉ hỗ trợ đầu ra 1K và không hỗ trợ Google Search Grounding, Function Calling hay Live API. x-apifox-orders: - contents - generationConfig - response_format - safetySettings - systemInstruction x-apidog-orders: - contents - generationConfig - response_format - safetySettings - systemInstruction examples: '1': value: contents: - parts: - text: >- Một chú mèo dễ thương đang ngồi trên một chiếc bàn gỗ, theo phong cách màu nước. role: user generationConfig: imageConfig: aspectRatio: '1:1' responseModalities: - HÌNH ẢNH response_format: url summary: '1' description: Được đề xuất cho người mới bắt đầu · Hình ảnh Vincentian · 1:1 '2': value: contents: - parts: - text: >- Một áp phích tối giản cho quán cà phê, tông màu ấm, khoảng trống phía trên dành cho kiểu chữ gọn gàng. role: user generationConfig: imageConfig: aspectRatio: '9:16' responseModalities: - HÌNH ẢNH summary: '2' description: >- Khuyến nghị cho người mới · Hình ảnh Vincentian · Màn hình dọc 9:16 '3': value: contents: - parts: - text: >- Logo thể thao chuyên nghiệp cho một đội bóng rổ hư cấu ở Seattle có tên là Seattle Sasquatch. Phong cách nhận diện thể thao hiện đại, đường viền đậm và gọn gàng. Bảng màu: xanh rêu, nâu tuyết tùng và màu đồng. Phong cách đồ họa vector, tách biệt trên nền đen đồng nhất. role: user generationConfig: imageConfig: aspectRatio: '3:2' outputMimeType: image/png responseModalities: - HÌNH ẢNH thinkingConfig: includeThoughts: false thinkingLevel: CAO summary: '3' description: Đề xuất nâng cao · Biểu đồ Vincentian · Suy luận + đầu ra PNG '4': value: contents: - parts: - inlineData: data: '{{test_image_base64}}' mimeType: image/png - text: >- Tạo một phiên bản theo phong cách vẽ nguệch ngoạc của bông hoa màu đỏ trong hình ảnh này. role: user generationConfig: responseModalities: - HÌNH ẢNH summary: '4' description: Khuyến nghị nâng cao · Chỉnh sửa hình ảnh trong một lượt '5': value: contents: - parts: - inlineData: data: '{{ref_image_1_base64}}' mimeType: image/jpeg - inlineData: data: '{{ref_image_2_base64}}' mimeType: image/png - text: >- Hình kết xuất nhân vật 3D cách điệu về một người phụ nữ vui vẻ và chú chó dễ thương của cô ấy. Màu sắc sống động, đôi mắt biểu cảm, nền màu trơn gọn gàng, bố cục ảnh đại diện cân giữa. role: user generationConfig: imageConfig: aspectRatio: '4:3' responseModalities: - HÌNH ẢNH summary: '5' description: >- Đề xuất nâng cao · Tổng hợp hình ảnh đa tham chiếu (≤3 hình ảnh) '6': value: contents: - parts: - inlineData: data: '{{test_video_base64}}' mimeType: video/mp4 - text: Tạo một tấm bưu thiếp về khung cảnh trong video này. role: user generationConfig: responseModalities: - HÌNH ẢNH summary: '6' description: Đề xuất nâng cao · Chuyển đổi video thành hình ảnh responses: '200': description: '' content: application/json: schema: type: object required: - candidates - usageMetadata - modelVersion - createTime - responseId properties: candidates: type: array items: type: object properties: content: type: object required: - role - parts properties: parts: type: array items: type: object properties: inlineData: type: object required: - mimeType - data properties: data: type: string description: >- Dữ liệu phương tiện được mã hóa Base64 (không có tiền tố URI data:) mimeType: type: string description: >- Loại MIME của phương tiện, ví dụ: image/png, image/jpeg description: >- Dữ liệu phương tiện nội tuyến (hình ảnh/âm thanh/v.v.) x-apifox-orders: - data - mimeType x-apidog-orders: - data - mimeType thoughtSignature: type: string description: Chữ ký suy luận (nếu được mô hình trả về) x-apifox-orders: - inlineData - thoughtSignature x-apidog-orders: - inlineData - thoughtSignature description: >- Danh sách các phần nội dung; có thể bao gồm văn bản, inline_data / inlineData, v.v. role: type: string description: >- Vai trò của thông điệp, ví dụ: mô hình, người dùng description: Vui lòng cung cấp đối tượng nội dung cần dịch. x-apifox-orders: - parts - role x-apidog-orders: - parts - role finishReason: type: string description: 'Ly do ket thuc, vi du: STOP, MAX_TOKENS, SAFETY' x-apifox-orders: - content - finishReason x-apidog-orders: - content - finishReason description: Các câu trả lời ứng viên của mô hình createTime: type: string description: Thời gian tạo phản hồi modelVersion: type: string description: Phiên bản mô hình thực tế được sử dụng responseId: type: string description: ID duy nhất cho phản hồi này usageMetadata: type: object required: - promptTokenCount - candidatesTokenCount - totalTokenCount - trafficType - promptTokensDetails - candidatesTokensDetails properties: candidatesTokenCount: type: integer 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, chỗ 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 bất kỳ chữ Hán nào. Số token được các câu trả lời ứng viên sử dụng candidatesTokensDetails: type: array items: type: object properties: modality: type: string description: 'Loại phương thức, ví dụ: TEXT, IMAGE, AUDIO' tokenCount: type: integer description: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. x-apifox-orders: - modality - tokenCount x-apidog-orders: - modality - tokenCount description: Phân tích chi tiết token ứng viên theo từng dạng thức promptTokenCount: type: integer description: Số token được lời nhắc sử dụng promptTokensDetails: type: array items: type: object properties: modality: type: string description: 'Loại phương thức, ví dụ: TEXT, IMAGE, AUDIO' tokenCount: type: integer description: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. x-apifox-orders: - modality - tokenCount x-apidog-orders: - modality - tokenCount description: Phân tích token trong lời nhắc theo từng phương thức totalTokenCount: type: integer description: Tổng số token trafficType: type: string description: Loại lưu lượng (liên quan đến thanh toán/hạn mức) description: Siêu dữ liệu về mức sử dụng token x-apifox-orders: - candidatesTokenCount - candidatesTokensDetails - promptTokenCount - promptTokensDetails - totalTokenCount - trafficType x-apidog-orders: - candidatesTokenCount - candidatesTokensDetails - promptTokenCount - promptTokensDetails - totalTokenCount - trafficType refName: PostV1betaModelsGemini31FlashLiteImageGenerateContentResponse x-apifox-orders: - candidates - createTime - modelVersion - responseId - usageMetadata x-apidog-orders: - candidates - createTime - modelVersion - responseId - usageMetadata examples: example: summary: example value: candidates: - content: parts: - inlineData: data: chuỗi mimeType: chuỗi thoughtSignature: chuỗi role: chuỗi finishReason: chuỗi createTime: chuỗi modelVersion: chuỗi responseId: chuỗi usageMetadata: candidatesTokenCount: 0 candidatesTokensDetails: - modality: chuỗi tokenCount: 0 promptTokenCount: 0 promptTokensDetails: - modality: chuỗi tokenCount: 0 totalTokenCount: 0 trafficType: 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208846-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "TTS chuyển văn bản thành giọng nói" Nguồn: https://docs.openaihub.net/api-45208847/ > 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/gemini-2.5-flash-preview-tts:generateContent: post: summary: TTS chuyển văn bản thành giọng nói deprecated: false description: >- Tài liệu chính thức: https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn#gemini-image-editing operationId: gemini_v1beta_2_5_flash_preview_tts_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: Content-Type in: header description: >- Kiểu nội dung của phần thân yêu cầu, được cố định là application/json required: true example: application/json schema: type: string requestBody: content: application/json: schema: type: object required: - contents - generationConfig properties: contents: type: array items: type: object properties: parts: type: array items: type: object properties: inline_data: type: object required: - mime_type - data properties: data: type: string description: >- Dữ liệu phương tiện được mã hóa Base64 (không có tiền tố data:) mime_type: type: string description: >- Loại MIME của phương tiện, ví dụ: audio/wav, audio/mpeg description: >- Dữ liệu nhị phân nội tuyến (ví dụ: âm thanh tham chiếu); không bắt buộc đối với TTS thuần túy x-apifox-orders: - data - mime_type x-apidog-orders: - data - mime_type text: type: string description: Nội dung văn bản để tổng hợp thành giọng nói 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 bất kỳ ký tự Hán nào. Một phần duy nhất; sử dụng văn bản và/hoặc inline_data x-apifox-orders: - inline_data - text x-apidog-orders: - inline_data - text description: >- Các phần nội dung; TTS chủ yếu sử dụng văn bản; có thể bao gồm âm thanh tham chiếu `inline_data` nếu hệ thống nguồn hỗ trợ description: Nội dung một lượt (vai trò mặc định là người dùng) x-apifox-orders: - parts x-apidog-orders: - parts description: >- Nội dung cuộc trò chuyện; TTS thường cần một tin nhắn của người dùng chứa văn bản để đọc thành từng phần generationConfig: type: object required: - responseModalities properties: responseModalities: type: array items: type: string description: >- Tên phương thức, thường là AUDIO; có thể kết hợp với TEXT, v.v. tùy theo mô hình description: >- Các phương thức phản hồi; đối với TTS, hãy sử dụng ["AUDIO"] speechConfig: type: object required: - voiceConfig properties: voiceConfig: type: object required: - prebuiltVoiceConfig properties: prebuiltVoiceConfig: type: object required: - voiceName properties: voiceName: type: string description: >- Tên giọng nói cài sẵn, ví dụ: Kore, Puck, Charon, Fenrir, Aoede description: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. x-apifox-orders: - voiceName x-apidog-orders: - voiceName description: Cấu hình giọng nói x-apifox-orders: - prebuiltVoiceConfig x-apidog-orders: - prebuiltVoiceConfig description: >- Cấu hình tổng hợp giọng nói; các tùy chọn về giọng đọc và cách phát âm x-apifox-orders: - voiceConfig x-apidog-orders: - voiceConfig description: >- Cấu hình tạo sinh; TTS phải khai báo phương thức AUDIO và cấu hình giọng nói x-apifox-orders: - responseModalities - speechConfig x-apidog-orders: - responseModalities - speechConfig refName: PostV1betaModelsGemini25FlashPreviewTtsGenerateContentRequest description: >- Nội dung yêu cầu chuyển văn bản thành giọng nói của Gemini 2.5 Flash Preview TTS x-apifox-orders: - contents - generationConfig x-apidog-orders: - contents - generationConfig examples: gemini_2_5_flash_preview_tts: value: contents: - parts: - text: Nói ra,tôi là ai,ai là tôi generationConfig: responseModalities: - ÂM THANH speechConfig: voiceConfig: prebuiltVoiceConfig: voiceName: Kore model: gemini-2.5-flash-preview-tts summary: gemini_2_5_flash_preview_tts description: TTS chuyển văn bản thành giọng nói responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208847-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Imagen tạo ra hình ảnh" Nguồn: https://docs.openaihub.net/api-45208848/ > 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/imagen-4.0-ultra-generate-001:predict: post: summary: Imagen tạo ra hình ảnh deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch vào đây. Tôi không thể dịch toàn bộ nội dung chỉ từ liên kết, nhưng có thể dịch phần văn bản bạn cung cấp sang tiếng Việt và giữ nguyên Markdown, mã nguồn, định danh, URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON cùng định dạng. operationId: gemini_v1beta_imagen_4_0_ultra_predict tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: key in: query description: 'Khóa API (cũng hỗ trợ Authorization: Bearer)' required: true example: '{{YOUR_API_KEY}}' schema: type: string - name: Content-Type in: header description: Loại nội dung 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: - instances - parameters properties: instances: type: array items: type: object properties: prompt: type: string description: Lời nhắc văn bản x-apifox-orders: - prompt x-apidog-orders: - prompt description: Cac doi tuong du doan cua Imagen parameters: type: object required: - sampleCount properties: sampleCount: type: integer description: Số lượng hình ảnh cần tạo description: Các tham số tạo ảnh của Imagen x-apifox-orders: - sampleCount x-apidog-orders: - sampleCount refName: PostV1betaModelsImagen40UltraGenerate001PredictRequest x-apifox-orders: - instances - parameters x-apidog-orders: - instances - parameters examples: imagen_single: value: instances: - prompt: Robot cầm một chiếc ván trượt màu đỏ parameters: sampleCount: 4 summary: imagen_single description: Imagen tạo ra hình ảnh responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: id: resp_example object: phản hồi status: completed 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/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208848-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tao anh bang gemini-nano-banana-2.1" Nguồn: https://docs.openaihub.net/api-45208849/ > 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/gemini-nano-banana-2.1:generateContent: post: summary: Tao anh bang gemini-nano-banana-2.1 deprecated: false description: >- ## Mô tả mô hình `gemini-nano-banana-2.1` là mô hình tạo/chỉnh sửa hình ảnh thuộc dòng Gemini, hỗ trợ chuyển văn bản thành hình ảnh và chỉnh sửa dựa trên nhiều hình ảnh tham chiếu (hoán đổi khuôn mặt, thay đổi trang phục, chuyển đổi phong cách, v.v.). - Định dạng yêu cầu: `generateContent` gốc của Gemini - Đầu ra: `inlineData` (base64) trong `candidates[0].content.parts[]`; trả về URL hình ảnh khi truyền `response_format: "url"` (chỉ khi không phát trực tuyến) - Độ phân giải: `imageConfig.imageSize` chỉ hỗ trợ `1K` / `2K` / `4K`, mặc định là `1K`, không hỗ trợ `512` - Tỉ lệ khung hình: `imageConfig.aspectRatio` hỗ trợ `1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 4:5, 5:4, 1:4, 4:1, 1:8, 8:1, 21:9` - Suy luận: `thinkingConfig.thinkingLevel` chỉ hỗ trợ `minimal` / `high`, không hỗ trợ `thinkingBudget`; cũng có thể dùng hậu tố tên mô hình `-thinking` / `-nothinking` - Tính phí: Dựa trên các mức độ phân giải, 1K ×1.0, 2K ×1.5, 4K ×3.375 (dựa trên giá mô hình trong bảng điều khiển) Tài liệu chính thức: https://ai.google.dev/gemini-api/docs/image-generation?hl=en#gemini-image-editing operationId: post-v1beta-models-gemini-nano-banana-2.1:generateContent tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Google Gemini/định dạng gốc parameters: - name: Content-Type in: header description: '' required: true example: application/json schema: type: string requestBody: content: application/json: schema: type: object required: - contents properties: contents: type: array items: type: object required: - parts properties: parts: type: array items: type: object properties: inline_data: type: object required: - mime_type - data properties: data: type: string description: >- Chuỗi Base64 của hình ảnh, không bao gồm tiền tố data:image/...;base64, mime_type: type: string enum: - image/jpeg - image/png - image/webp description: Kiểu MIME của hình ảnh description: >- Hình ảnh tham chiếu (base64). Cũng tương thích với cách viết camelCase `inlineData` / `mimeType`. x-apifox-orders: - data - mime_type x-apidog-orders: - data - mime_type text: type: string description: >- Lời nhắc văn bản. Mô tả cảnh bạn muốn tạo/chỉnh sửa; không đưa kích thước hoặc tỷ lệ khung hình vào lời nhắc, hãy kiểm soát chúng bằng imageConfig. x-apifox-orders: - inline_data - text x-apidog-orders: - inline_data - text description: >- Mảng các đoạn nội dung, mỗi phần tử chỉ được điền vào một trong hai trường `text` hoặc `inline_data`. role: type: string enum: - user description: Vai trò, phải được đặt thành `user` x-apifox-orders: - parts - role x-apidog-orders: - parts - role description: >- Nội dung hội thoại. Đối với chuyển văn bản thành hình ảnh, chỉ nên đặt một văn bản; đối với chỉnh sửa hình ảnh/tham chiếu nhiều hình ảnh, hãy đặt một văn bản + nhiều `inline_data` trong cùng một `parts`. generationConfig: type: object properties: imageConfig: type: object properties: aspectRatio: type: string enum: - '1:1' - '16:9' - '9:16' - '4:3' - '3:4' - '2:3' - '3:2' - '4:5' - '5:4' - '1:4' - '4:1' - '1:8' - '8:1' - '21:9' description: >- Tỷ lệ khung hình của ảnh đầu ra, mặc định là 1:1 nếu không được cung cấp (sử dụng tỷ lệ của ảnh tham chiếu nếu có) imageSize: type: string enum: - 1K - 2K - 4K description: >- Cấp độ phân giải đầu ra, mặc định là 1K nếu không được cung cấp. Không hỗ trợ 512. Hệ số tính phí: 1K ×1.0, 2K ×1.5, 4K ×3.375. description: Cấu hình đầu ra hình ảnh x-apifox-orders: - aspectRatio - imageSize x-apidog-orders: - aspectRatio - imageSize responseModalities: type: array items: type: string enum: - TEXT - IMAGE description: >- Phương thức đầu ra. Nên truyền rõ ràng ["TEXT","IMAGE"] khi tạo hình ảnh; nếu chỉ truyền ["IMAGE"] thì sẽ không trả về phần mô tả bằng văn bản. thinkingConfig: type: object properties: thinkingLevel: type: string enum: - minimal - high description: >- Muc do suy luan. `minimal` nhanh hon, `high` cho chat luong tot hon nhung cham hon. Cung co the su dung hau to ten mo hinh `gemini-nano-banana-2.1-thinking` / `-nothinking`. description: >- Cấu hình suy luận (tùy chọn). Không hỗ trợ thinkingBudget, chỉ hỗ trợ thinkingLevel. x-apifox-orders: - thinkingLevel x-apidog-orders: - thinkingLevel description: >- Cấu hình tạo nội dung. Lưu ý: aspectRatio / imageSize phải được đặt bên trong imageConfig; nếu đặt chúng ở cấp cao nhất của generationConfig thì chúng sẽ bị bỏ qua; các trường negativePrompt và resolution không được hỗ trợ. x-apifox-orders: - imageConfig - responseModalities - thinkingConfig x-apidog-orders: - imageConfig - responseModalities - thinkingConfig response_format: type: string enum: - base64 - url description: >- Định dạng trả về của hình ảnh (trường mở rộng của nền tảng, không phải là tham số Gemini chính thức). base64: hình ảnh được trả về trong parts[].inlineData.data (mặc định); url: hình ảnh trả về một liên kết tạm thời trong parts[].fileData.fileUri, chỉ được hỗ trợ cho các yêu cầu không truyền trực tuyến; việc truyền url trong chế độ truyền trực tuyến sẽ dẫn đến lỗi 400. x-apifox-orders: - contents - generationConfig - response_format x-apidog-orders: - contents - generationConfig - response_format examples: example: value: contents: - parts: - text: >- Thay thế hoàn toàn khuôn mặt và tóc của nhân vật trong Hình 1 vào nhân vật trong Hình 2: các đường nét và chi tiết khuôn mặt phải hoàn toàn lấy từ Hình 1, không giữ lại đặc điểm khuôn mặt của Hình 2; điều chỉnh góc khuôn mặt theo tư thế đầu trong Hình 2; giữ nguyên trang phục, phần cơ thể không bao gồm phụ kiện tóc và phông nền của Hình 2; màu da, ánh sáng và bóng đổ hòa quyện tự nhiên, không xuất hiện đường nối ghép rõ ràng; phong cách chân thực ở cấp độ nhiếp ảnh. - text: 'Hình tham khảo 1 ("Hình 1" trong câu lệnh):' - inlineData: data: >- mimeType: image/jpeg - text: 'Tham khảo Hình 2 ("Hình 2" trong lời nhắc):' - inlineData: data: >- mimeType: image/jpeg role: user generationConfig: imageConfig: aspectRatio: '3:4' imageSize: 2K responseModalities: - Vui lòng cung cấp nội dung tài liệu cần dịch. - HÌNH ẢNH response_format: base64 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - candidates properties: candidates: type: array items: type: object required: - content - finishReason properties: content: type: object required: - parts properties: parts: type: array items: type: object properties: fileData: type: object required: - mimeType - fileUri properties: fileUri: type: string description: >- Liên kết tải xuống tạm thời cho hình ảnh có giới hạn thời gian, vui lòng tải xuống và lưu lại ngay. mimeType: type: string description: >- Được trả về khi `response_format` là `url`. x-apifox-orders: - fileUri - mimeType x-apidog-orders: - fileUri - mimeType inlineData: type: object required: - mimeType - data properties: data: type: string description: >- Chuỗi Base64 của hình ảnh, không bao gồm tiền tố data:; khi giải mã, chuỗi này cho ra dữ liệu nhị phân của hình ảnh. mimeType: type: string description: Kiểu MIME của hình ảnh description: >- Được trả về khi response_format là base64 (mặc định). x-apifox-orders: - data - mimeType x-apidog-orders: - data - mimeType text: type: string description: >- Phần mô tả văn bản do mô hình cung cấp, có thể không xuất hiện. x-apifox-orders: - fileData - inlineData - text x-apidog-orders: - fileData - inlineData - text description: >- Mảng các phân đoạn được trả về. Phần mô tả bằng văn bản nằm trong text, hình ảnh nằm trong inlineData (base64) hoặc fileData (url); chỉ cần lấy phần tử đầu tiên có chứa hình ảnh. role: type: string description: Đã cố định theo mô hình x-apifox-orders: - parts - role x-apidog-orders: - parts - role finishReason: type: string enum: - STOP - MAX_TOKENS - SAFETY - RECITATION - PROHIBITED_CONTENT - OTHER description: >- Lý do kết thúc. STOP cho biết quá trình hoàn tất bình thường; SAFETY / PROHIBITED_CONTENT cho biết yêu cầu đã bị chính sách an toàn chặn lại, trong trường hợp này không có hình ảnh nào được trả về. index: type: integer x-apifox-orders: - content - finishReason - index x-apidog-orders: - content - finishReason - index description: Mảng kết quả tạo sinh, thường chỉ chứa 1 phần tử modelVersion: type: string description: Phiên bản mô hình thực sự đã xử lý yêu cầu. responseId: type: string description: >- ID yêu cầu cho phiên làm việc này, vui lòng cung cấp khi xử lý sự cố. usageMetadata: type: object properties: candidatesTokenCount: type: integer description: Số lượng token đầu ra (bao gồm cả hình ảnh được tạo). promptTokenCount: type: integer description: >- Số lượng token đầu vào (bao gồm cả hình ảnh tham chiếu). totalTokenCount: type: integer description: Tổng số token. description: Thống kê mức sử dụng token, tính phí dựa trên console. x-apifox-orders: - candidatesTokenCount - promptTokenCount - totalTokenCount x-apidog-orders: - candidatesTokenCount - promptTokenCount - totalTokenCount x-apifox-orders: - candidates - modelVersion - responseId - usageMetadata x-apidog-orders: - candidates - modelVersion - responseId - usageMetadata examples: example: summary: example value: candidates: - content: parts: - text: >- Đã thay khuôn mặt trong Hình 1 vào Hình 2, đồng thời giữ nguyên trang phục và phông nền của Hình 2. - inlineData: data: >- /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/...(da cat ngan) mimeType: image/jpeg role: mô hình finishReason: DỪNG LẠI index: 0 modelVersion: gemini-nano-banana-2.1 responseId: abc123xyz usageMetadata: candidatesTokenCount: 1290 promptTokenCount: 1083 totalTokenCount: 2373 headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208849-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "giao diện tạo hình ảnh gemini [định dạng tương thích với trò chuyện]" Nguồn: https://docs.openaihub.net/api-45208850/ > 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: giao diện tạo hình ảnh gemini [định dạng tương thích với trò chuyện] 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/Trò chuyện/Gemini/Định dạng tương thích với 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/Trò chuyện/Gemini/Định dạng tương thích với trò chuyện x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208850-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Nhúng văn bản [định dạng tương thích với trò chuyện]" Nguồn: https://docs.openaihub.net/api-45208851/ > 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/embeddings: post: summary: Nhúng văn bản [định dạng tương thích với trò chuyện] deprecated: false description: >- Tạo các phần nhúng vectơ văn bản. Chọn dịch vụ nguồn thông qua `model` (chẳng hạn như `text-embedding-3-small` của OpenAI hoặc mô hình phần nhúng của Gemini). Tài liệu chính thức của OpenAI: https://platform.openai.com/docs/api-reference/embeddings operationId: v1_embeddings tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng tương thích với trò chuyện - Nhúng parameters: [] requestBody: content: application/json: schema: type: object required: - model - input properties: dimensions: type: integer description: Số chiều của vectơ input: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. model: type: string description: Tên mô hình / mã định danh mô hình refName: V1EmbeddingsRequest x-apifox-orders: - dimensions - input - model x-apidog-orders: - dimensions - input - model examples: minimal: value: input: Món ăn rất ngon và nhân viên phục vụ rất thân thiện. model: text-embedding-3-small summary: minimal description: Mức tối thiểu khả dụng responses: '200': description: Được content: application/json: schema: type: object properties: data: type: array items: type: object x-apidog-orders: [] description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) 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' usage: type: object description: Thống kê mức sử dụng token x-apidog-orders: [] refName: V1EmbeddingsResponse x-apifox-orders: - data - model - object - usage x-apidog-orders: - data - model - object - usage examples: example: summary: example value: data: - {} model: chuỗi object: chuỗi usage: {} 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/Trò chuyện/Gemini/Định dạng tương thích với trò chuyện x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208851-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo phản hồi của mô hình" Nguồn: https://docs.openaihub.net/api-45208852/ > 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/responses: post: summary: Tạo phản hồi của mô hình deprecated: false description: >- https://platform.openai.com/docs/api-reference/responses/create Một số mô hình OpenAI chỉ hỗ trợ định dạng Response, chẳng hạn như o3-pro, codex-mini-latest operationId: v1_responses tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Trò chuyện (Phản hồi) - Phản hồi 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 properties: input: type: array items: type: object 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 x-apifox-orders: - content - role x-apidog-orders: - content - role description: Vui lòng cung cấp nội dung tài liệu cần dịch. model: type: string description: >- Mã định danh của mô hình cần sử dụng. Để biết thêm thông tin về những mô hình có thể được sử dụng với Chat API, hãy xem bảng tương thích điểm cuối của mô hình. refName: PostV1ResponsesRequest x-apifox-orders: - input - model x-apidog-orders: - input - model examples: gpt_4_1: value: '[long payload omitted: 3,821 units]' summary: gpt_4_1 description: Tạo lệnh gọi hàm Sao chép 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 refName: PostV1ResponsesResponse x-apifox-orders: - choices - created - id - object - usage x-apidog-orders: - choices - created - id - object - usage examples: example: summary: example value: '[long payload omitted: 1,698 units]' 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/Trò chuyện/Trò chuyện (Phản hồi) x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208852-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "nén ngữ cảnh gpt" Nguồn: https://docs.openaihub.net/api-45208853/ > 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/responses/compact: post: summary: nén ngữ cảnh gpt deprecated: false description: Nén ngữ cảnh trò chuyện GPT để giảm số lượng token cho các yêu cầu sau. operationId: v1_responses_compact tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Trò chuyện (Phản hồi) - Phản hồi parameters: [] requestBody: content: application/json: schema: type: object required: - model - input properties: input: type: array items: type: object required: - type - role - content properties: content: type: string description: Nội dung thông điệp role: type: string description: >- Vai trò của tin nhắn, các giá trị tùy chọn: user/assistant/system type: type: string description: Loại thông điệp, giá trị cố định là message x-apifox-orders: - content - role - type x-apidog-orders: - content - role - type description: Danh sách các tin nhắn trong lịch sử cần được nén model: type: string description: Tên mô hình, chẳng hạn như gpt-5-codex refName: PostV1ResponsesCompactRequest x-apifox-orders: - input - model x-apidog-orders: - input - model examples: gpt_5_4: value: input: - content: Xin chào, đây là một bài kiểm tra ngắn gọn. role: user type: message model: gpt-5.4 summary: gpt_5_4 description: nén ngữ cảnh gpt responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: '[long payload omitted: 1,684 units]' 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/Trò chuyện/Trò chuyện (Phản hồi) x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208853-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tải ảnh lên" Nguồn: https://docs.openaihub.net/api-45208854/ > 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: /mj/submit/upload-discord-images: post: summary: Tải ảnh lên deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch vào đây. Tôi không thể truy cập trực tiếp nội dung từ đường dẫn, nhưng tôi sẽ dịch sang tiếng Việt và giữ nguyên Markdown, mã, định danh, URL, đường dẫn, phần giữ chỗ, cấu trúc JSON cùng định dạng. operationId: mj_submit_upload_discord_images tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney - Midjourney 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: 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: - base64Array properties: base64Array: type: array items: type: string description: Mảng các chuỗi Base64 của hình ảnh đầu vào x-apifox-orders: - base64Array x-apidog-orders: - base64Array examples: example_single: value: base64Array: - data:image/png;base64,iVBORw0KGgo... summary: example_single description: Tải ảnh lên responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 1 description: thành công result: '1720000000000000' 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/Hình ảnh/Midjourney x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208854-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Gửi tác vụ rút gọn" Nguồn: https://docs.openaihub.net/api-45208855/ > 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: /mj/submit/shorten: get: summary: Gửi tác vụ rút gọn deprecated: false description: '' operationId: get-mj-submit-shorten tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney - mj parameters: [] requestBody: content: application/json: schema: type: object required: - prompt properties: botType: type: string enum: - MID_JOURNEY - NIJI_JOURNEY enumDetails: - value: MID_JOURNEY - value: NIJI_JOURNEY description: 'loại bot: mj (mặc định) hoặc niji' notifyHook: type: string description: URL callback; dùng notifyHook toàn cục khi để trống prompt: type: string description: lời nhắc để phân tích / cô đọng state: type: string description: >- Chất lượng của hình ảnh sẽ được tạo. `hd` tạo ra hình ảnh có chi tiết sắc nét hơn và tính nhất quán cao hơn. Tham số này chỉ hỗ trợ `dall-e-3`. x-apifox-orders: - botType - notifyHook - prompt - state x-apidog-orders: - botType - notifyHook - prompt - state examples: {} responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 1 description: thành công result: '1720000000000000' 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/Hình ảnh/Midjourney x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208855-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Gửi tác vụ Imagine" Nguồn: https://docs.openaihub.net/api-45208856/ > 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: /mj/submit/imagine: post: summary: Gửi tác vụ Imagine deprecated: false description: >- Tài liệu chính thức: https://docs.midjourney.com/hc/en-us/articles/32023408776205-Prompt-Basics Tạo hình ảnh từ lời nhắc văn bản; hỗ trợ hình ảnh tham chiếu (base64Array) và nhiều loại bot. operationId: mj_submit_imagine tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney - Midjourney parameters: - 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: - prompt properties: accountFilter: type: object properties: channelId: type: string description: ID kênh description: Tiêu chí lọc tài khoản (tùy chọn) x-apifox-orders: - channelId x-apidog-orders: - channelId base64Array: type: array items: type: string description: >- Danh sách chuỗi Base64 của hình ảnh tham chiếu, có định dạng `data:image/png;base64,...`, tối đa 5 hình ảnh botType: type: string enum: - MID_JOURNEY - NIJI_JOURNEY description: Loại bot; NIJI phù hợp với phong cách anime notifyHook: type: string description: URL gọi lại khi tác vụ hoàn tất (Webhook) prompt: type: string description: >- Câu lệnh mô tả hình ảnh; hỗ trợ các tham số Midjourney gốc (ví dụ: `--ar 16:9 --v 6.1`) examples: - >- một chú mèo dễ thương đang ngồi trên bệ cửa sổ --ar 1:1 --v 6.1 state: type: string description: >- Trường trạng thái được truyền nguyên vẹn và trả về không thay đổi trong hàm gọi lại refName: PostMjSubmitImagineRequest x-apifox-orders: - accountFilter - base64Array - botType - notifyHook - prompt - state x-apidog-orders: - accountFilter - base64Array - botType - notifyHook - prompt - state examples: imagine_single: value: base64Array: [] botType: MID_JOURNEY notifyHook: '' prompt: cat state: '' summary: imagine_single description: Gửi tác vụ Imagine imagine_single_2: value: base64Array: [] botType: MID_JOURNEY notifyHook: '' prompt: >- một chú ngựa trắng oai vệ đang chạy trong khu rừng phủ sương --ar 16:9 --v 6.1 state: '' summary: imagine_single_2 description: Nộp bài tập Imagine responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 1 description: Gửi thành công properties: discordChannelId: '1300842676874379336' discordInstanceId: '1572398367386955776' result: '1730621718151844' 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/Hình ảnh/Midjourney x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208856-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Lấy trạng thái tác vụ theo ID" Nguồn: https://docs.openaihub.net/api-45208857/ > 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: /mj/task/{id}/fetch: get: summary: Lấy trạng thái tác vụ theo ID deprecated: false description: >- Truy vấn trạng thái/kết quả hiện tại của một tác vụ được gửi qua `POST /mj/submit/imagine`, `/mj/submit/action`, v.v. Khi `status` là `SUCCESS`, `imageUrl` hợp lệ và `buttons` liệt kê các thao tác tiếp theo khả dụng (`customId`). operationId: mj_task_fetch tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney - Midjourney parameters: - name: id in: path description: Mã tác vụ required: true example: '1743326750223591' schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: {} examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - action - customId - botType - prompt - promptEn - description - state - submitTime - startTime - finishTime - imageUrl - status - progress - failReason - buttons - maskBase64 - properties properties: action: type: string description: Loại hành động botType: type: string description: Loại bot buttons: type: array items: type: object required: - customId - emoji - label - type - style properties: customId: type: string description: Mã định danh chuyển tiếp tùy chỉnh emoji: type: string description: Định danh biểu tượng cảm xúc label: type: string description: Nhãn hiển thị style: type: integer description: Tham số phong cách type: type: integer description: Kiểu x-apifox-orders: - customId - emoji - label - style - type x-apidog-orders: - customId - emoji - label - style - type description: Danh sách các nút / hành động có thể thực hiện tiếp theo customId: type: string description: Mã định danh chuyển tiếp tùy chỉnh description: type: string description: Mô tả failReason: type: string description: Ly do that bai finishTime: type: integer description: Thời gian hoàn thành id: type: string description: ID tài nguyên hoặc tác vụ imageUrl: type: string description: URL hình ảnh kết quả maskBase64: type: string description: Base64 của ảnh mặt nạ progress: type: string description: Tiến trình (0-100 hoặc 0-1, tùy thuộc vào nền tảng) prompt: type: string description: Lời nhắc văn bản promptEn: type: string description: Lời nhắc bằng tiếng Anh properties: type: object required: - finalPrompt - finalZhPrompt properties: finalPrompt: type: string description: Lời nhắc cuối cùng thực sự được sử dụng finalZhPrompt: type: string description: Lời nhắc cuối cùng bằng tiếng Trung description: Thuộc tính mở rộng x-apifox-orders: - finalPrompt - finalZhPrompt x-apidog-orders: - finalPrompt - finalZhPrompt startTime: type: integer description: Thời gian bắt đầu state: type: string description: Trạng thái chuyển tiếp tùy chỉnh status: type: string description: Trạng thái submitTime: type: integer description: Thời gian gửi refName: GetMjTaskFetchResponse x-apifox-orders: - action - botType - buttons - customId - description - failReason - finishTime - id - imageUrl - maskBase64 - progress - prompt - promptEn - properties - startTime - state - status - submitTime x-apidog-orders: - action - botType - buttons - customId - description - failReason - finishTime - id - imageUrl - maskBase64 - progress - prompt - promptEn - properties - startTime - state - status - submitTime examples: '1': summary: '1' value: '[long payload omitted: 2,247 units]' 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/Hình ảnh/Midjourney x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208857-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn các tác vụ dựa trên danh sách ID" Nguồn: https://docs.openaihub.net/api-45208858/ > 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: /mj/task/list-by-condition: post: summary: Truy vấn các tác vụ dựa trên danh sách ID deprecated: false description: Truy vấn hàng loạt nhiều tác vụ theo danh sách ID. operationId: mj_task_list_by_condition tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney - Midjourney parameters: - 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: - ids properties: ids: type: array items: type: string description: Danh sách ID x-apifox-orders: - ids x-apidog-orders: - ids examples: example_single: value: ids: - '1743326750223591' - '1743326750223592' summary: example_single description: Danh sách tác vụ truy vấn theo lô id_single: value: ids: - '1743326750223591' summary: id_single description: Truy vấn các tác vụ dựa trên danh sách ID 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: array items: type: object properties: action: type: string description: >- Loại hành động (TƯỞNG TƯỢNG / NÂNG ĐỘ PHÂN GIẢI / BIẾN THỂ, v.v.) buttons: type: array items: type: object properties: customId: type: string description: Mã định danh chuyển tiếp tùy chỉnh emoji: type: string description: Định danh biểu tượng cảm xúc label: type: string description: Nhãn hiển thị style: type: integer description: Tham số phong cách type: type: integer description: Kiểu x-apifox-orders: - customId - emoji - label - style - type x-apidog-orders: - customId - emoji - label - style - type description: >- Danh sách các nút thao tác (cho các hành động tiếp theo) description: type: string description: Mô tả tác vụ failReason: type: string description: Ly do that bai finishTime: type: integer description: Dấu thời gian hoàn tất (ms) id: type: string description: Mã tác vụ imageUrl: type: string description: URL ảnh được tạo progress: type: string description: 'Phần trăm tiến độ (ví dụ: `25%`, `50%`)' prompt: type: string description: Lời nhắc đã dùng promptEn: type: string description: Lời nhắc bằng tiếng Anh (do MJ dịch) startTime: type: integer description: Mốc thời gian bắt đầu (ms) state: type: string description: Trường trạng thái được truyền nguyên vẹn status: type: string enum: - NOT_START - SUBMITTED - IN_PROGRESS - FAILURE - SUCCESS description: Trạng thái tác vụ submitTime: type: integer description: Gửi dấu thời gian (ms) refName: MjTask x-apifox-orders: - action - buttons - description - failReason - finishTime - id - imageUrl - progress - prompt - promptEn - startTime - state - status - submitTime x-apidog-orders: - action - buttons - description - failReason - finishTime - id - imageUrl - progress - prompt - promptEn - startTime - state - status - submitTime description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) refName: PostMjTaskListByConditionResponse x-apifox-orders: - code - data x-apidog-orders: - code - data examples: example: summary: example value: code: 0 data: - action: chuỗi buttons: - customId: chuỗi emoji: chuỗi label: chuỗi style: 0 type: 0 description: chuỗi failReason: chuỗi finishTime: 0 id: string imageUrl: chuỗi progress: chuỗi prompt: chuỗi promptEn: chuỗi startTime: 0 state: chuỗi status: NOT_START submitTime: 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/Hình ảnh/Midjourney x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208858-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Lấy hạt giống hình ảnh" Nguồn: https://docs.openaihub.net/api-45208859/ > 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: /mj/task/{id}/image-seed: get: summary: Lấy hạt giống hình ảnh deprecated: false description: >- Lấy hạt giống (hạt giống ngẫu nhiên) của hình ảnh được tạo bởi tác vụ được chỉ định; có thể dùng để tái tạo hoặc tinh chỉnh quá trình tạo với cùng hạt giống. operationId: mj_task_image_seed tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney - Midjourney 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: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: ids: type: array items: type: string description: Danh sách ID examples: - - '1231234123' - '456456456' example: - '1231234123' - '456456456' examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - action - customId - botType - prompt - promptEn - description - state - submitTime - startTime - finishTime - imageUrl - status - progress - failReason - buttons - maskBase64 - properties properties: action: type: string description: Loại hành động botType: type: string description: Loại bot buttons: type: array items: type: object required: - customId - emoji - label - type - style properties: customId: type: string description: Mã định danh chuyển tiếp tùy chỉnh emoji: type: string description: Định danh biểu tượng cảm xúc label: type: string description: Nhãn hiển thị style: type: integer description: Tham số phong cách type: type: integer description: Kiểu x-apifox-orders: - customId - emoji - label - style - type x-apidog-orders: - customId - emoji - label - style - type description: Danh sách các nút / hành động có thể thực hiện tiếp theo customId: type: string description: Mã định danh chuyển tiếp tùy chỉnh description: type: string description: Mô tả failReason: type: string description: Ly do that bai finishTime: type: integer description: Thời gian hoàn thành id: type: string description: ID tài nguyên hoặc tác vụ imageUrl: type: string description: URL hình ảnh kết quả maskBase64: type: string description: Base64 của ảnh mặt nạ progress: type: string description: Tiến trình (0-100 hoặc 0-1, tùy thuộc vào nền tảng) prompt: type: string description: Lời nhắc văn bản promptEn: type: string description: Lời nhắc bằng tiếng Anh properties: type: object required: - finalPrompt - finalZhPrompt properties: finalPrompt: type: string description: Lời nhắc cuối cùng thực sự được sử dụng finalZhPrompt: type: string description: Lời nhắc cuối cùng bằng tiếng Trung description: Thuộc tính mở rộng x-apifox-orders: - finalPrompt - finalZhPrompt x-apidog-orders: - finalPrompt - finalZhPrompt startTime: type: integer description: Thời gian bắt đầu state: type: string description: Trạng thái chuyển tiếp tùy chỉnh status: type: string description: Trạng thái submitTime: type: integer description: Thời gian gửi refName: GetMjTaskIdImageSeedResponse x-apifox-orders: - action - botType - buttons - customId - description - failReason - finishTime - id - imageUrl - maskBase64 - progress - prompt - promptEn - properties - startTime - state - status - submitTime x-apidog-orders: - action - botType - buttons - customId - description - failReason - finishTime - id - imageUrl - maskBase64 - progress - prompt - promptEn - properties - startTime - state - status - submitTime examples: example: summary: example value: '[long payload omitted: 2,247 units]' 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/Hình ảnh/Midjourney x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208859-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Thực thi hành động" Nguồn: https://docs.openaihub.net/api-45208860/ > 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: /mj/submit/action: post: summary: Thực thi hành động deprecated: false description: >- Thực hiện các thao tác Tăng độ phân giải, Biến thể, Tạo lại, Dịch chuyển khung hình và các thao tác khác trên một tác vụ hiện có. operationId: mj_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney - Midjourney parameters: [] requestBody: content: application/json: schema: type: object required: - customId - taskId properties: chooseSameChannel: type: boolean description: >- Có chọn một tài khoản từ cùng kênh Discord hay không; theo mặc định, chỉ tài khoản được liên kết với tác vụ mới được sử dụng customId: type: string description: Mã định danh hành động notifyHook: type: string description: URL callback; dùng notifyHook toàn cục khi để trống state: type: string description: Tham số chuyển tiếp tùy chỉnh taskId: type: string description: Mã tác vụ refName: MjSampleRequest x-apifox-orders: - chooseSameChannel - customId - notifyHook - state - taskId x-apidog-orders: - chooseSameChannel - customId - notifyHook - state - taskId examples: action_single: value: botType: MID_JOURNEY customId: MJ::JOB::upsample::1::xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx taskId: '1743326750223591' summary: action_single description: Thực thi hành động action action_single_2: value: chooseSameChannel: true customId: MJ::JOB::upsample::2::3dbbd469-36af-4a0f-8f02-df6c579e7011 notifyHook: '' state: '' taskId: '14001934816969359' summary: action_single_2 description: Thực thi hành động responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer description: Thời gian tạo (dấu thời gian Unix) data: type: array items: type: object required: - url properties: url: type: string description: URL tài nguyên x-apifox-orders: - url x-apidog-orders: - url description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) refName: MjSampleResponse x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1589478378 data: - url: https://... - url: https://... 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/Hình ảnh/Midjourney x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208860-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Gửi tác vụ Blend" Nguồn: https://docs.openaihub.net/api-45208861/ > 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: /mj/submit/blend: post: summary: Gửi tác vụ Blend deprecated: false description: >- Tài liệu chính thức: https://docs.midjourney.com/hc/en-us/articles/32635189884557-Blend-Images-on-Discord Trộn 2–5 hình ảnh thành một hình ảnh mới; cung cấp dữ liệu Base64 cho từng hình ảnh. operationId: mj_submit_blend tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney - Midjourney parameters: - 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: - botType properties: base64Array: type: array items: type: string description: Mảng các chuỗi Base64 của hình ảnh; yêu cầu 2-5 hình ảnh botType: type: string enum: - NIJI_JOURNEY - MID_JOURNEY enumDetails: - value: NIJI_JOURNEY - value: MID_JOURNEY description: Loại bot, mj (mặc định) hoặc niji dimensions: type: string enum: - PORTRAIT - SQUARE - LANDSCAPE enumDetails: - value: CHÂN DUNG - value: HÌNH VUÔNG - value: KHỔ NGANG description: 'Tỷ lệ khung hình: DỌC (2:3); VUÔNG (1:1); NGANG (3:2)' notifyHook: type: string description: URL callback; dùng notifyHook toàn cục khi để trống quality: type: string description: >- Chất lượng của hình ảnh sẽ được tạo. `hd` tạo ra hình ảnh có chi tiết sắc nét hơn và tính nhất quán cao hơn. Tham số này chỉ hỗ trợ `dall-e-3`. state: type: string description: Tham số chuyển tiếp tùy chỉnh refName: PostMjSubmitBlendRequest x-apifox-orders: - base64Array - botType - dimensions - notifyHook - quality - state x-apidog-orders: - base64Array - botType - dimensions - notifyHook - quality - state examples: blend_single: value: base64Array: - data:image/png;base64,xxx1 - data:image/png;base64,xxx2 botType: MID_JOURNEY dimensions: HÌNH VUÔNG notifyHook: '' state: '' summary: blend_single description: Gửi tác vụ Blend responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer description: Thời gian tạo (dấu thời gian Unix) data: type: array items: type: object required: - url properties: url: type: string description: URL tài nguyên x-apifox-orders: - url x-apidog-orders: - url description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) refName: PostMjSubmitBlendResponse x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1589478378 data: - url: https://... - url: https://... 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/Hình ảnh/Midjourney x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208861-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Gửi tác vụ Mô tả" Nguồn: https://docs.openaihub.net/api-45208862/ > 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: /mj/submit/describe: post: summary: Gửi tác vụ Mô tả deprecated: false description: >- Tài liệu chính thức: https://docs.midjourney.com/hc/en-us/articles/32497889043981-Describe Phân tích một hình ảnh và trả về bốn mô tả dạng văn bản (prompt ngược) để dùng với imagine sau này. operationId: mj_submit_describe tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney - Midjourney parameters: - 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: - botType properties: base64: type: string description: >- Dữ liệu ảnh Base64 được dùng cho tác vụ Describe, theo định dạng `data:image/png;base64,`. botType: type: string enum: - MID_JOURNEY - NIJI_JOURNEY enumDetails: - value: MID_JOURNEY - value: NIJI_JOURNEY description: Loại bot, mj (mặc định) hoặc niji notifyHook: type: string description: URL callback; dùng notifyHook toàn cục khi để trống state: type: string description: >- Chất lượng của hình ảnh sẽ được tạo. `hd` tạo ra hình ảnh có chi tiết sắc nét hơn và tính nhất quán cao hơn. Tham số này chỉ hỗ trợ `dall-e-3`. refName: PostMjSubmitDescribeRequest x-apifox-orders: - base64 - botType - notifyHook - state x-apidog-orders: - base64 - botType - notifyHook - state examples: describe_single: value: base64: data:image/png;base64,iVBORw0KGgo... botType: MID_JOURNEY notifyHook: '' state: '' summary: describe_single description: Gửi tác vụ Mô tả describe_single_2: value: base64: data:image/png;base64,iVBORw0KGgo... botType: MID_JOURNEY summary: describe_single_2 description: Gửi tác vụ Mô tả responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer description: Thời gian tạo (dấu thời gian Unix) data: type: array items: type: object required: - url properties: url: type: string description: URL tài nguyên x-apifox-orders: - url x-apidog-orders: - url description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) refName: PostMjSubmitDescribeResponse x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1589478378 data: - url: https://... - url: https://... 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/Hình ảnh/Midjourney x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208862-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Hộp thoại gửi" Nguồn: https://docs.openaihub.net/api-45208863/ > 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: /mj/submit/modal: post: summary: Hộp thoại gửi deprecated: false description: >- Thực hiện tô bù cục bộ trên một vùng cụ thể (Biến đổi vùng / Tô bù); bắt buộc phải có mặt nạ. operationId: mj_submit_modal tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney - Midjourney parameters: - 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: - taskId properties: botType: type: string enum: - MID_JOURNEY - NIJI_JOURNEY description: Loại bot maskBase64: type: string description: Ảnh mặt nạ Base64 (các vùng màu trắng là vùng được vẽ lại) notifyHook: type: string description: URL gọi lại prompt: type: string description: >- Lời nhắc mới để vẽ lại cục bộ (không bắt buộc; để trống để giữ nguyên lời nhắc ban đầu) state: type: string description: Trạng thái chuyển tiếp tùy chỉnh taskId: type: string description: ID tác vụ gốc refName: PostMjSubmitModalRequest x-apifox-orders: - botType - maskBase64 - notifyHook - prompt - state - taskId x-apidog-orders: - botType - maskBase64 - notifyHook - prompt - state - taskId examples: modal_single: value: maskBase64: '' prompt: '' taskId: '14001934816969359' summary: modal_single description: Hộp thoại gửi responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer description: Thời gian tạo (dấu thời gian Unix) data: type: array items: type: object required: - url properties: url: type: string description: URL tài nguyên x-apifox-orders: - url x-apidog-orders: - url description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) refName: PostMjSubmitModalResponse x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1589478378 data: - url: https://... - url: https://... 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/Hình ảnh/Midjourney x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208863-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Vẽ (wenshengtu/tushetu)" Nguồn: https://docs.openaihub.net/api-45208864/ > 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: /mj/submit/imagine: post: summary: Vẽ (wenshengtu/tushetu) deprecated: false description: >- Tài liệu chính thức: https://docs.midjourney.com/hc/en-us/articles/32023408776205-Prompt-Basics Tạo hình ảnh từ lời nhắc văn bản; hỗ trợ hình ảnh tham chiếu (base64Array) và nhiều loại bot. operationId: mj_submit_imagine tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - Midjourney parameters: - 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: - prompt properties: accountFilter: type: object properties: channelId: type: string description: ID kênh description: Tiêu chí lọc tài khoản (tùy chọn) x-apifox-orders: - channelId x-apidog-orders: - channelId base64Array: type: array items: type: string description: >- Danh sách chuỗi Base64 của hình ảnh tham chiếu, có định dạng `data:image/png;base64,...`, tối đa 5 hình ảnh botType: type: string enum: - MID_JOURNEY - NIJI_JOURNEY description: Loại bot; NIJI phù hợp với phong cách anime notifyHook: type: string description: URL gọi lại khi tác vụ hoàn tất (Webhook) prompt: type: string description: >- Câu lệnh mô tả hình ảnh; hỗ trợ các tham số Midjourney gốc (ví dụ: `--ar 16:9 --v 6.1`) examples: - >- một chú mèo dễ thương đang ngồi trên bệ cửa sổ --ar 1:1 --v 6.1 state: type: string description: >- Trường trạng thái được truyền nguyên vẹn và trả về không thay đổi trong hàm gọi lại refName: PostMjSubmitImagineRequest x-apifox-orders: - accountFilter - base64Array - botType - notifyHook - prompt - state x-apidog-orders: - accountFilter - base64Array - botType - notifyHook - prompt - state examples: imagine_single: value: base64Array: [] botType: MID_JOURNEY notifyHook: '' prompt: cat state: '' summary: imagine_single description: Gửi tác vụ Imagine imagine_single_2: value: base64Array: [] botType: MID_JOURNEY notifyHook: '' prompt: >- một chú ngựa trắng oai vệ đang chạy trong khu rừng phủ sương --ar 16:9 --v 6.1 state: '' summary: imagine_single_2 description: Nộp bài tập Imagine responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 1 description: Gửi thành công properties: discordChannelId: '1300842676874379336' discordInstanceId: '1572398367386955776' result: '1730621718151844' 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208864-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Thực hiện các thao tác (thu phóng/biến thể/di chuyển/vẽ lại, v.v.)" Nguồn: https://docs.openaihub.net/api-45208865/ > 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: /mj/submit/action: post: summary: Thực hiện các thao tác (thu phóng/biến thể/di chuyển/vẽ lại, v.v.) deprecated: false description: >- Thực hiện các thao tác Tăng độ phân giải, Biến thể, Tạo lại, Dịch chuyển khung hình và các thao tác khác trên một tác vụ hiện có. operationId: mj_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - Midjourney parameters: [] requestBody: content: application/json: schema: type: object required: - customId - taskId properties: chooseSameChannel: type: boolean description: >- Có chọn một tài khoản từ cùng kênh Discord hay không; theo mặc định, chỉ tài khoản được liên kết với tác vụ mới được sử dụng customId: type: string description: Mã định danh hành động notifyHook: type: string description: URL callback; dùng notifyHook toàn cục khi để trống state: type: string description: Tham số chuyển tiếp tùy chỉnh taskId: type: string description: Mã tác vụ refName: MjSampleRequest x-apifox-orders: - chooseSameChannel - customId - notifyHook - state - taskId x-apidog-orders: - chooseSameChannel - customId - notifyHook - state - taskId examples: action_single: value: botType: MID_JOURNEY customId: MJ::JOB::upsample::1::xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx taskId: '1743326750223591' summary: action_single description: Thực thi hành động action action_single_2: value: chooseSameChannel: true customId: MJ::JOB::upsample::2::3dbbd469-36af-4a0f-8f02-df6c579e7011 notifyHook: '' state: '' taskId: '14001934816969359' summary: action_single_2 description: Thực thi hành động responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer description: Thời gian tạo (dấu thời gian Unix) data: type: array items: type: object required: - url properties: url: type: string description: URL tài nguyên x-apifox-orders: - url x-apidog-orders: - url description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) refName: MjSampleResponse x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1589478378 data: - url: https://... - url: https://... 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208865-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Xác nhận cửa sổ (bước thứ hai sau khi thao tác trả về mã:21)" Nguồn: https://docs.openaihub.net/api-45208866/ > 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: /mj/submit/modal: post: summary: Xác nhận cửa sổ (bước thứ hai sau khi thao tác trả về mã:21) deprecated: false description: >- Thực hiện tô bù cục bộ trên một vùng cụ thể (Biến đổi vùng / Tô bù); bắt buộc phải có mặt nạ. operationId: mj_submit_modal tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - Midjourney parameters: - 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: - taskId properties: botType: type: string enum: - MID_JOURNEY - NIJI_JOURNEY description: Loại bot maskBase64: type: string description: Ảnh mặt nạ Base64 (các vùng màu trắng là vùng được vẽ lại) notifyHook: type: string description: URL gọi lại prompt: type: string description: >- Lời nhắc mới để vẽ lại cục bộ (không bắt buộc; để trống để giữ nguyên lời nhắc ban đầu) state: type: string description: Trạng thái chuyển tiếp tùy chỉnh taskId: type: string description: ID tác vụ gốc refName: PostMjSubmitModalRequest x-apifox-orders: - botType - maskBase64 - notifyHook - prompt - state - taskId x-apidog-orders: - botType - maskBase64 - notifyHook - prompt - state - taskId examples: modal_single: value: maskBase64: '' prompt: '' taskId: '14001934816969359' summary: modal_single description: Hộp thoại gửi responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer description: Thời gian tạo (dấu thời gian Unix) data: type: array items: type: object required: - url properties: url: type: string description: URL tài nguyên x-apifox-orders: - url x-apidog-orders: - url description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) refName: PostMjSubmitModalResponse x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1589478378 data: - url: https://... - url: https://... 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208866-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Trộn hình ảnh" Nguồn: https://docs.openaihub.net/api-45208867/ > 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: /mj/submit/blend: post: summary: Trộn hình ảnh deprecated: false description: >- Tài liệu chính thức: https://docs.midjourney.com/hc/en-us/articles/32635189884557-Blend-Images-on-Discord Trộn 2–5 hình ảnh thành một hình ảnh mới; cung cấp dữ liệu Base64 cho từng hình ảnh. operationId: mj_submit_blend tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - Midjourney parameters: - 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: - botType properties: base64Array: type: array items: type: string description: Mảng các chuỗi Base64 của hình ảnh; yêu cầu 2-5 hình ảnh botType: type: string enum: - NIJI_JOURNEY - MID_JOURNEY enumDetails: - value: NIJI_JOURNEY - value: MID_JOURNEY description: Loại bot, mj (mặc định) hoặc niji dimensions: type: string enum: - PORTRAIT - SQUARE - LANDSCAPE enumDetails: - value: CHÂN DUNG - value: HÌNH VUÔNG - value: KHỔ NGANG description: 'Tỷ lệ khung hình: DỌC (2:3); VUÔNG (1:1); NGANG (3:2)' notifyHook: type: string description: URL callback; dùng notifyHook toàn cục khi để trống quality: type: string description: >- Chất lượng của hình ảnh sẽ được tạo. `hd` tạo ra hình ảnh có chi tiết sắc nét hơn và tính nhất quán cao hơn. Tham số này chỉ hỗ trợ `dall-e-3`. state: type: string description: Tham số chuyển tiếp tùy chỉnh refName: PostMjSubmitBlendRequest x-apifox-orders: - base64Array - botType - dimensions - notifyHook - quality - state x-apidog-orders: - base64Array - botType - dimensions - notifyHook - quality - state examples: blend_single: value: base64Array: - data:image/png;base64,xxx1 - data:image/png;base64,xxx2 botType: MID_JOURNEY dimensions: HÌNH VUÔNG notifyHook: '' state: '' summary: blend_single description: Gửi tác vụ Blend responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer description: Thời gian tạo (dấu thời gian Unix) data: type: array items: type: object required: - url properties: url: type: string description: URL tài nguyên x-apifox-orders: - url x-apidog-orders: - url description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) refName: PostMjSubmitBlendResponse x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1589478378 data: - url: https://... - url: https://... 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208867-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Hình ảnh và văn bản (các từ gợi ý được suy ngược)" Nguồn: https://docs.openaihub.net/api-45208868/ > 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: /mj/submit/describe: post: summary: Hình ảnh và văn bản (các từ gợi ý được suy ngược) deprecated: false description: >- Tài liệu chính thức: https://docs.midjourney.com/hc/en-us/articles/32497889043981-Describe Phân tích một hình ảnh và trả về bốn mô tả dạng văn bản (prompt ngược) để dùng với imagine sau này. operationId: mj_submit_describe tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - Midjourney parameters: - 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: - botType properties: base64: type: string description: >- Dữ liệu ảnh Base64 được dùng cho tác vụ Describe, theo định dạng `data:image/png;base64,`. botType: type: string enum: - MID_JOURNEY - NIJI_JOURNEY enumDetails: - value: MID_JOURNEY - value: NIJI_JOURNEY description: Loại bot, mj (mặc định) hoặc niji notifyHook: type: string description: URL callback; dùng notifyHook toàn cục khi để trống state: type: string description: >- Chất lượng của hình ảnh sẽ được tạo. `hd` tạo ra hình ảnh có chi tiết sắc nét hơn và tính nhất quán cao hơn. Tham số này chỉ hỗ trợ `dall-e-3`. refName: PostMjSubmitDescribeRequest x-apifox-orders: - base64 - botType - notifyHook - state x-apidog-orders: - base64 - botType - notifyHook - state examples: describe_single: value: base64: data:image/png;base64,iVBORw0KGgo... botType: MID_JOURNEY notifyHook: '' state: '' summary: describe_single description: Gửi tác vụ Mô tả describe_single_2: value: base64: data:image/png;base64,iVBORw0KGgo... botType: MID_JOURNEY summary: describe_single_2 description: Gửi tác vụ Mô tả responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer description: Thời gian tạo (dấu thời gian Unix) data: type: array items: type: object required: - url properties: url: type: string description: URL tài nguyên x-apifox-orders: - url x-apidog-orders: - url description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) refName: PostMjSubmitDescribeResponse x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1589478378 data: - url: https://... - url: https://... 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208868-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Phân tích từ ngữ trong lời nhắc (không có kênh)" Nguồn: https://docs.openaihub.net/api-45208869/ > 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: /mj/submit/shorten: post: summary: Phân tích từ ngữ trong lời nhắc (không có kênh) deprecated: false description: >- Phân tích một lời nhắc và trả về phiên bản rút gọn để tối ưu hóa các lời nhắc dài. operationId: mj_submit_shorten tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - Midjourney parameters: [] requestBody: content: application/json: schema: type: object required: - prompt properties: botType: type: string enum: - MID_JOURNEY - NIJI_JOURNEY description: Loại bot notifyHook: type: string description: URL gọi lại prompt: type: string description: Lời nhắc cần rút gọn state: type: string description: Trạng thái chuyển tiếp tùy chỉnh refName: PostMjSubmitShortenRequest x-apifox-orders: - botType - notifyHook - prompt - state x-apidog-orders: - botType - notifyHook - prompt - state examples: shorten_single: value: botType: MID_JOURNEY prompt: >- một chú ngựa trắng vô cùng xinh đẹp và oai vệ với bờm dài tung bay, đang phi nước đại xuyên qua một khu rừng huyền bí đầy mê hoặc, nơi những tia nắng vàng xuyên qua các cây cổ thụ cao vút summary: shorten_single description: Gửi tác vụ Shorten responses: '200': description: thành công content: application/json: schema: type: object properties: code: type: integer description: >- Mã trạng thái: 1=đã gửi, 21=đang chờ, 22=đã tồn tại, 24=tham số không hợp lệ examples: - 1 description: type: string description: Mô tả trạng thái examples: - Gửi thành công properties: type: object description: Thuộc tính mở rộng x-apidog-orders: [] result: type: string description: Mã tác vụ examples: - '1743326750223591' refName: MjSubmitResponse x-apifox-orders: - code - description - properties - result x-apidog-orders: - code - description - properties - result examples: example: summary: example value: code: 1 description: Gửi thành công properties: {} result: '1743326750223591' 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208869-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Thay đổi khuôn mặt (chức năng phiên bản nâng cao) (không có kênh)" Nguồn: https://docs.openaihub.net/api-45208870/ > 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: /mj/insight-face/swap: post: summary: Thay đổi khuôn mặt (chức năng phiên bản nâng cao) (không có kênh) deprecated: false description: Thay khuôn mặt trong ảnh đích bằng khuôn mặt từ ảnh nguồn. operationId: mj_insight_face_swap tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - Midjourney parameters: [] requestBody: content: application/json: schema: type: object required: - sourceBase64 - targetBase64 properties: notifyHook: type: string description: URL gọi lại sourceBase64: type: string description: >- Hình ảnh khuôn mặt nguồn dạng Base64 (hình ảnh cung cấp khuôn mặt) state: type: string description: Trạng thái chuyển tiếp tùy chỉnh targetBase64: type: string description: Ảnh đích dạng Base64 (ảnh có khuôn mặt sẽ được thay thế) refName: PostMjInsightFaceSwapRequest x-apifox-orders: - notifyHook - sourceBase64 - state - targetBase64 x-apidog-orders: - notifyHook - sourceBase64 - state - targetBase64 examples: {} responses: '200': description: thành công content: application/json: schema: type: object properties: code: type: integer description: >- Mã trạng thái: 1=đã gửi, 21=đang chờ, 22=đã tồn tại, 24=tham số không hợp lệ examples: - 1 description: type: string description: Mô tả trạng thái examples: - Gửi thành công properties: type: object description: Thuộc tính mở rộng x-apidog-orders: [] result: type: string description: Mã tác vụ examples: - '1743326750223591' refName: MjSubmitResponse x-apifox-orders: - code - description - properties - result x-apidog-orders: - code - description - properties - result examples: example: summary: example value: code: 1 description: Gửi thành công properties: {} result: '1743326750223591' 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208870-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Chỉnh sửa hình ảnh (phiên bản nâng cao)" Nguồn: https://docs.openaihub.net/api-45208871/ > 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: /mj/submit/edits: post: summary: Chỉnh sửa hình ảnh (phiên bản nâng cao) deprecated: false description: >- Chỉnh sửa một vùng được che trên hình ảnh hiện có; có thể tùy chọn hướng dẫn bằng lời nhắc. operationId: mj_submit_edits tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - Midjourney parameters: [] requestBody: content: application/json: schema: type: object required: - taskId - prompt properties: maskBase64: type: string description: Base64 của ảnh mặt nạ (các vùng màu trắng là vùng chỉnh sửa) notifyHook: type: string description: URL gọi lại prompt: type: string description: Lời nhắc mới cho vùng đã chỉnh sửa state: type: string description: Trạng thái chuyển tiếp tùy chỉnh taskId: type: string description: ID tác vụ gốc refName: PostMjSubmitEditsRequest x-apifox-orders: - maskBase64 - notifyHook - prompt - state - taskId x-apidog-orders: - maskBase64 - notifyHook - prompt - state - taskId examples: {} responses: '200': description: thành công content: application/json: schema: type: object properties: code: type: integer description: >- Mã trạng thái: 1=đã gửi, 21=đang chờ, 22=đã tồn tại, 24=tham số không hợp lệ examples: - 1 description: type: string description: Mô tả trạng thái examples: - Gửi thành công properties: type: object description: Thuộc tính mở rộng x-apidog-orders: [] result: type: string description: Mã tác vụ examples: - '1743326750223591' refName: MjSubmitResponse x-apifox-orders: - code - description - properties - result x-apidog-orders: - code - description - properties - result examples: example: summary: example value: code: 1 description: Gửi thành công properties: {} result: '1743326750223591' 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208871-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Video sinh từ hình ảnh (chức năng phiên bản nâng cao)" Nguồn: https://docs.openaihub.net/api-45208872/ > 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: /mj/submit/video: post: summary: Video sinh từ hình ảnh (chức năng phiên bản nâng cao) deprecated: false description: '' operationId: post-mj-submit-video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - mj parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image properties: base64: type: string description: >- base64 của ảnh gốc; cùng giá trị với ảnh trên máy khách; chuyển tiếp nguyên trạng image: type: string description: >- Ảnh gốc ở dạng base64 (tiền tố data URL). Ảnh cơ sở I2V; được truyền nguyên trạng; không được khai báo trong struct backend mode: type: string enum: - FAST - RELAX - TURBO enumDetails: - value: NHANH description: mặc định - value: NỚI LỎNG - value: TURBO description: Che do tao (truyen thang). FAST(mac dinh)/RELAX/TURBO motion: type: string enum: - low - high enumDetails: - value: thấp description: mặc định - value: cao description: >- Cường độ chuyển động (truyền nguyên trạng). thấp (mặc định)/cao notifyHook: type: string description: URL callback; dùng notifyHook toàn cục khi để trống prompt: type: string description: nội dung video / mô tả chuyển động state: type: string description: >- Chất lượng của hình ảnh sẽ được tạo. `hd` tạo ra hình ảnh có chi tiết sắc nét hơn và tính nhất quán cao hơn. Tham số này chỉ hỗ trợ `dall-e-3`. taskId: type: string description: >- Tùy chọn. Đối với video từ một tác vụ MJ hiện có, hãy truyền ID của tác vụ đó (relay-mj.go:690 cần taskId); không cần cho I2V có hình ảnh x-apifox-orders: - base64 - image - mode - motion - notifyHook - prompt - state - taskId x-apidog-orders: - base64 - image - mode - motion - notifyHook - prompt - state - taskId examples: {} responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 1 description: thành công result: '1720000000000000' 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208872-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Phóng to/biến thể bản gốc, nhấn chỉ mục" Nguồn: https://docs.openaihub.net/api-45208873/ > 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: /mj/submit/change: post: summary: Phóng to/biến thể bản gốc, nhấn chỉ mục deprecated: false description: >- Dịch chuyển (mở rộng theo hướng) hoặc Thu nhỏ (mở rộng khung vẽ) trên một hình ảnh hiện có. operationId: mj_submit_change tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - Midjourney parameters: [] requestBody: content: application/json: schema: type: object required: - taskId - action properties: action: type: string enum: - PAN_LEFT - PAN_RIGHT - PAN_UP - PAN_DOWN - ZOOM_OUT_2X - ZOOM_OUT_1_5X description: Loại hành động notifyHook: type: string description: URL gọi lại state: type: string description: Trạng thái chuyển tiếp tùy chỉnh taskId: type: string description: ID tác vụ gốc refName: PostMjSubmitChangeRequest x-apifox-orders: - action - notifyHook - state - taskId x-apidog-orders: - action - notifyHook - state - taskId examples: changepan_zoom_single: value: action: PAN_RIGHT taskId: '1743326750223591' summary: changepan_zoom_single description: Gửi tác vụ Thay đổi (Di chuyển/Thu phóng) responses: '200': description: thành công content: application/json: schema: type: object properties: code: type: integer description: >- Mã trạng thái: 1=đã gửi, 21=đang chờ, 22=đã tồn tại, 24=tham số không hợp lệ examples: - 1 description: type: string description: Mô tả trạng thái examples: - Gửi thành công properties: type: object description: Thuộc tính mở rộng x-apidog-orders: [] result: type: string description: Mã tác vụ examples: - '1743326750223591' refName: MjSubmitResponse x-apifox-orders: - code - description - properties - result x-apidog-orders: - code - description - properties - result examples: example: summary: example value: code: 1 description: Gửi thành công properties: {} result: '1743326750223591' 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208873-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Chuyển đổi lệnh văn bản (nội dung)" Nguồn: https://docs.openaihub.net/api-45208874/ > 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: /mj/submit/simple-change: post: summary: Chuyển đổi lệnh văn bản (nội dung) deprecated: false description: '' operationId: post-mj-submit-simple-change tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - mj parameters: [] requestBody: content: application/json: schema: type: object required: - content properties: content: type: string description: >- Chuyển đổi văn bản lệnh như "taskId action", ví dụ: "1719999999999000 U1" notifyHook: type: string description: URL callback; dùng notifyHook toàn cục khi để trống state: type: string description: >- Chất lượng của hình ảnh sẽ được tạo. `hd` tạo ra hình ảnh có chi tiết sắc nét hơn và tính nhất quán cao hơn. Tham số này chỉ hỗ trợ `dall-e-3`. x-apifox-orders: - content - notifyHook - state x-apidog-orders: - content - notifyHook - state examples: {} responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 1 description: thành công result: '1720000000000000' 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208874-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Kiểm tra các tác vụ theo từng lô dựa trên các điều kiện" Nguồn: https://docs.openaihub.net/api-45208875/ > 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: /: post: summary: Kiểm tra các tác vụ theo từng lô dựa trên các điều kiện deprecated: false description: '' operationId: post tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208875-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tải lên hình ảnh tham chiếu (trả về mảng URL" Nguồn: https://docs.openaihub.net/api-45208876/ > 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: /mj/submit/upload-discord-images: post: summary: Tải lên hình ảnh tham chiếu (trả về mảng URL deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch vào đây. Tôi không thể truy cập trực tiếp nội dung từ đường dẫn, nhưng tôi sẽ dịch sang tiếng Việt và giữ nguyên Markdown, mã, định danh, URL, đường dẫn, phần giữ chỗ, cấu trúc JSON cùng định dạng. operationId: mj_submit_upload_discord_images tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Gửi tác vụ - Midjourney 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: 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: - base64Array properties: base64Array: type: array items: type: string description: Mảng các chuỗi Base64 của hình ảnh đầu vào x-apifox-orders: - base64Array x-apidog-orders: - base64Array examples: example_single: value: base64Array: - data:image/png;base64,iVBORw0KGgo... summary: example_single description: Tải ảnh lên responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 1 description: thành công result: '1720000000000000' 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/Hình ảnh/Midjourney/Gửi tác vụ x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208876-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Truy vấn chi tiết tác vụ" Nguồn: https://docs.openaihub.net/api-45208877/ > 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: /mj/task/{id}/fetch: get: summary: Truy vấn chi tiết tác vụ deprecated: false description: >- Truy vấn trạng thái/kết quả hiện tại của một tác vụ được gửi qua `POST /mj/submit/imagine`, `/mj/submit/action`, v.v. Khi `status` là `SUCCESS`, `imageUrl` hợp lệ và `buttons` liệt kê các thao tác tiếp theo khả dụng (`customId`). operationId: mj_task_fetch tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Các tác vụ truy vấn - Midjourney parameters: - name: id in: path description: Mã tác vụ required: true example: '1743326750223591' schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: {} examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - action - customId - botType - prompt - promptEn - description - state - submitTime - startTime - finishTime - imageUrl - status - progress - failReason - buttons - maskBase64 - properties properties: action: type: string description: Loại hành động botType: type: string description: Loại bot buttons: type: array items: type: object required: - customId - emoji - label - type - style properties: customId: type: string description: Mã định danh chuyển tiếp tùy chỉnh emoji: type: string description: Định danh biểu tượng cảm xúc label: type: string description: Nhãn hiển thị style: type: integer description: Tham số phong cách type: type: integer description: Kiểu x-apifox-orders: - customId - emoji - label - style - type x-apidog-orders: - customId - emoji - label - style - type description: Danh sách các nút / hành động có thể thực hiện tiếp theo customId: type: string description: Mã định danh chuyển tiếp tùy chỉnh description: type: string description: Mô tả failReason: type: string description: Ly do that bai finishTime: type: integer description: Thời gian hoàn thành id: type: string description: ID tài nguyên hoặc tác vụ imageUrl: type: string description: URL hình ảnh kết quả maskBase64: type: string description: Base64 của ảnh mặt nạ progress: type: string description: Tiến trình (0-100 hoặc 0-1, tùy thuộc vào nền tảng) prompt: type: string description: Lời nhắc văn bản promptEn: type: string description: Lời nhắc bằng tiếng Anh properties: type: object required: - finalPrompt - finalZhPrompt properties: finalPrompt: type: string description: Lời nhắc cuối cùng thực sự được sử dụng finalZhPrompt: type: string description: Lời nhắc cuối cùng bằng tiếng Trung description: Thuộc tính mở rộng x-apifox-orders: - finalPrompt - finalZhPrompt x-apidog-orders: - finalPrompt - finalZhPrompt startTime: type: integer description: Thời gian bắt đầu state: type: string description: Trạng thái chuyển tiếp tùy chỉnh status: type: string description: Trạng thái submitTime: type: integer description: Thời gian gửi refName: GetMjTaskFetchResponse x-apifox-orders: - action - botType - buttons - customId - description - failReason - finishTime - id - imageUrl - maskBase64 - progress - prompt - promptEn - properties - startTime - state - status - submitTime x-apidog-orders: - action - botType - buttons - customId - description - failReason - finishTime - id - imageUrl - maskBase64 - progress - prompt - promptEn - properties - startTime - state - status - submitTime examples: '1': summary: '1' value: '[long payload omitted: 2,247 units]' 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/Hình ảnh/Midjourney/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-45208877-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Kiểm tra seed" Nguồn: https://docs.openaihub.net/api-45208878/ > 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: /mj/task/{id}/image-seed: get: summary: Kiểm tra seed deprecated: false description: >- Lấy hạt giống (hạt giống ngẫu nhiên) của hình ảnh được tạo bởi tác vụ được chỉ định; có thể dùng để tái tạo hoặc tinh chỉnh quá trình tạo với cùng hạt giống. operationId: mj_task_image_seed tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Midjourney/Các tác vụ truy vấn - Midjourney 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: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: ids: type: array items: type: string description: Danh sách ID examples: - - '1231234123' - '456456456' example: - '1231234123' - '456456456' examples: {} responses: '200': description: '' content: application/json: schema: type: object required: - id - action - customId - botType - prompt - promptEn - description - state - submitTime - startTime - finishTime - imageUrl - status - progress - failReason - buttons - maskBase64 - properties properties: action: type: string description: Loại hành động botType: type: string description: Loại bot buttons: type: array items: type: object required: - customId - emoji - label - type - style properties: customId: type: string description: Mã định danh chuyển tiếp tùy chỉnh emoji: type: string description: Định danh biểu tượng cảm xúc label: type: string description: Nhãn hiển thị style: type: integer description: Tham số phong cách type: type: integer description: Kiểu x-apifox-orders: - customId - emoji - label - style - type x-apidog-orders: - customId - emoji - label - style - type description: Danh sách các nút / hành động có thể thực hiện tiếp theo customId: type: string description: Mã định danh chuyển tiếp tùy chỉnh description: type: string description: Mô tả failReason: type: string description: Ly do that bai finishTime: type: integer description: Thời gian hoàn thành id: type: string description: ID tài nguyên hoặc tác vụ imageUrl: type: string description: URL hình ảnh kết quả maskBase64: type: string description: Base64 của ảnh mặt nạ progress: type: string description: Tiến trình (0-100 hoặc 0-1, tùy thuộc vào nền tảng) prompt: type: string description: Lời nhắc văn bản promptEn: type: string description: Lời nhắc bằng tiếng Anh properties: type: object required: - finalPrompt - finalZhPrompt properties: finalPrompt: type: string description: Lời nhắc cuối cùng thực sự được sử dụng finalZhPrompt: type: string description: Lời nhắc cuối cùng bằng tiếng Trung description: Thuộc tính mở rộng x-apifox-orders: - finalPrompt - finalZhPrompt x-apidog-orders: - finalPrompt - finalZhPrompt startTime: type: integer description: Thời gian bắt đầu state: type: string description: Trạng thái chuyển tiếp tùy chỉnh status: type: string description: Trạng thái submitTime: type: integer description: Thời gian gửi refName: GetMjTaskIdImageSeedResponse x-apifox-orders: - action - botType - buttons - customId - description - failReason - finishTime - id - imageUrl - maskBase64 - progress - prompt - promptEn - properties - startTime - state - status - submitTime x-apidog-orders: - action - botType - buttons - customId - description - failReason - finishTime - id - imageUrl - maskBase64 - progress - prompt - promptEn - properties - startTime - state - status - submitTime examples: example: summary: example value: '[long payload omitted: 2,247 units]' 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/Hình ảnh/Midjourney/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-45208878-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo gpt-image-1" Nguồn: https://docs.openaihub.net/api-45208879/ > 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/images/generations: post: summary: Tạo gpt-image-1 deprecated: false description: >- Với một lời nhắc, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được dự đoán, đồng thời cũng có thể trả về xác suất của các mã từ thay thế tại mỗi vị trí. Tạo các phần hoàn thành cho lời nhắc và các tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/create operationId: v1_images_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Content-Type in: header description: '' required: true example: application/json schema: type: string - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - prompt - model - 'n' properties: background: type: string enum: - auto - opaque - transparent description: |- Nền Các tùy chọn: auto (mặc định), opaque, transparent Khi transparent, định dạng phải là png hoặc webp format: type: string description: >- Định dạng hình ảnh Các tùy chọn: png, jpeg, webp Sử dụng png hoặc webp cho nền trong suốt. (Tên trường chính thức là output_format, nhưng cổng này dùng nhất quán format như trong bảng điều khiển gỡ lỗi gpt-image-2.) model: type: string enum: - gpt-image-2.5-flare - gpt-image-2.5-sunburst enumDetails: - value: gpt-image-2.5-flare displayName: Flare - value: gpt-image-2.5-sunburst displayName: Biểu đồ tia nắng description: >- Tên mô hình gpt-image-2.5-flare Nhanh hơn, phù hợp cho việc tạo nội dung hằng ngày hoặc với mức độ đồng thời cao gpt-image-2.5-sunburst Độ chính xác cao hơn, phù hợp cho việc tinh chỉnh và sản xuất nội dung sáng tạo moderation: type: string enum: - auto - low description: |- Mức độ nghiêm ngặt của kiểm duyệt nội dung Các tùy chọn: auto (mặc định), low 'n': type: integer description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. Mặc định là 1 nếu không được cung cấp. prompt: type: string description: >- Mô tả bằng văn bản về hình ảnh mong muốn. Độ dài tối đa là 1000 ký tự. quality: type: string description: >- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) So với gpt-image-2, xhigh và max là các tùy chọn mới. low phù hợp với bản nháp; xhigh / max cung cấp nhiều chi tiết hơn nhưng có độ trễ và chi phí cao hơn. response_format: type: string enum: - url - b64_json enumDetails: - value: url - value: b64_json size: type: string description: >- Kích thước hình ảnh 1024x1024 Vuông 1536x1024 Ngang 1024x1536 Dọc 2048x2048 Vuông 2K 2048x1152 Ngang 2K 3840x2160 Ngang 4K 2160x3840 Dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 Các độ phân giải trên 2560x1440 được xem là các khả năng thử nghiệm. x-apifox-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size x-apidog-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size examples: example: value: format: webp model: gpt-image-2.5-flare 'n': 1 prompt: >- Ảnh tĩnh sản phẩm: bàn phím cơ màu đen nhám, ánh sáng trường quay, không có chữ quality: trung bình response_format: url size: 1536x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.webp headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208879-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "chỉnh sửa hình ảnh" Nguồn: https://docs.openaihub.net/api-45208880/ > 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/images/edits: post: summary: chỉnh sửa hình ảnh deprecated: false description: >- Với một lời nhắc, mô hình này sẽ trả về một hoặc nhiều phần hoàn chỉnh được dự đoán, đồng thời cũng có thể trả về xác suất của các token thay thế tại mỗi vị trí. Tạo các phần hoàn chỉnh cho lời nhắc và tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/createEdit operationId: v1_images_edits tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: background: type: string description: >- Cho phép thiết lập độ trong suốt của nền cho hình ảnh được tạo. Các tùy chọn: opaque, transparent, auto (mặc định). Khi sử dụng auto, mô hình sẽ tự động xác định nền phù hợp nhất cho hình ảnh. Nên sử dụng định dạng png hoặc webp khi chọn transparent. examples: - tự động example: tự động image: type: string format: binary description: >- Hình ảnh cần chỉnh sửa. Phải là một tệp hình ảnh được hỗ trợ hoặc một mảng hình ảnh. Số lượng hình ảnh phải ít hơn 16 và tổng dung lượng không vượt quá 50MB. Hình ảnh đầu vào cho API chỉnh sửa. Tải lên bằng multipart/form-data. examples: - '' example: '' mask: type: string description: >- Một hình ảnh bổ sung có các vùng hoàn toàn trong suốt (ví dụ: giá trị alpha bằng không) cho biết vị trí cần chỉnh sửa hình ảnh. Nếu cung cấp nhiều hình ảnh, mặt nạ sẽ được áp dụng cho hình ảnh đầu tiên. Tệp phải là PNG hợp lệ, có dung lượng nhỏ hơn 4MB và có cùng kích thước với hình ảnh. examples: - '' example: '' model: type: string description: >- Mô hình được dùng để tạo hình ảnh. Chỉ hỗ trợ gpt-image-2.5-flare và gpt-image-2.5-sunburst. examples: - gpt-image-2.5-flare example: gpt-image-2.5-flare moderation: type: string description: >- Kiểm soát mức độ kiểm duyệt nội dung. Có thể đặt thành `low` để lọc ít hạn chế hơn hoặc `auto` (mặc định). examples: - tự động example: tự động 'n': type: string description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. examples: - '1' example: '1' prompt: type: string description: Mô tả bằng văn bản về hình ảnh mong muốn. examples: - '' example: '' quality: type: string description: |- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) examples: - tự động example: tự động size: type: string description: >- Kích thước hình ảnh 1024x1024 Hình vuông 1536x1024 Hình ngang 1024x1536 Hình dọc 2048x2048 Hình vuông 2K 2048x1152 Hình ngang 2K 3840x2160 Hình ngang 4K 2160x3840 Hình dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 examples: - 1024x1536 example: 1024x1536 required: - image - prompt examples: example: value: model: gpt-image-1 'n': 1 prompt: Một chú heo con luôn đáng yêu size: 1024x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.png headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208880-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Mặt nạ gpt-image-1" Nguồn: https://docs.openaihub.net/api-45208881/ > 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/images/edits: post: summary: Mặt nạ gpt-image-1 deprecated: false description: >- Với một lời nhắc, mô hình này sẽ trả về một hoặc nhiều phần hoàn chỉnh được dự đoán, đồng thời cũng có thể trả về xác suất của các token thay thế tại mỗi vị trí. Tạo các phần hoàn chỉnh cho lời nhắc và tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/createEdit operationId: post-v1-images-edits tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: background: type: string description: >- Cho phép thiết lập độ trong suốt của nền cho hình ảnh được tạo. Các tùy chọn: opaque, transparent, auto (mặc định). Khi sử dụng auto, mô hình sẽ tự động xác định nền phù hợp nhất cho hình ảnh. Nên sử dụng định dạng png hoặc webp khi chọn transparent. examples: - tự động example: tự động image: type: string format: binary description: >- Hình ảnh cần chỉnh sửa. Phải là một tệp hình ảnh được hỗ trợ hoặc một mảng hình ảnh. Số lượng hình ảnh phải ít hơn 16 và tổng dung lượng không vượt quá 50MB. Hình ảnh đầu vào cho API chỉnh sửa. Tải lên bằng multipart/form-data. examples: - '' example: '' mask: type: string description: >- Một hình ảnh bổ sung có các vùng hoàn toàn trong suốt (ví dụ: giá trị alpha bằng không) cho biết vị trí cần chỉnh sửa hình ảnh. Nếu cung cấp nhiều hình ảnh, mặt nạ sẽ được áp dụng cho hình ảnh đầu tiên. Tệp phải là PNG hợp lệ, có dung lượng nhỏ hơn 4MB và có cùng kích thước với hình ảnh. examples: - '' example: '' model: type: string description: >- Mô hình được dùng để tạo hình ảnh. Chỉ hỗ trợ gpt-image-2.5-flare và gpt-image-2.5-sunburst. examples: - gpt-image-2.5-flare example: gpt-image-2.5-flare moderation: type: string description: >- Kiểm soát mức độ kiểm duyệt nội dung. Có thể đặt thành `low` để lọc ít hạn chế hơn hoặc `auto` (mặc định). examples: - tự động example: tự động 'n': type: string description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. examples: - '1' example: '1' prompt: type: string description: Mô tả bằng văn bản về hình ảnh mong muốn. examples: - '' example: '' quality: type: string description: |- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) examples: - tự động example: tự động size: type: string description: >- Kích thước hình ảnh 1024x1024 Hình vuông 1536x1024 Hình ngang 1024x1536 Hình dọc 2048x2048 Hình vuông 2K 2048x1152 Hình ngang 2K 3840x2160 Hình ngang 4K 2160x3840 Hình dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 examples: - 1024x1536 example: 1024x1536 required: - image - prompt examples: example: value: model: gpt-image-1 'n': 1 prompt: Một chú heo con luôn đáng yêu size: 1024x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.png headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208881-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Chỉnh sửa gpt-image-1.5" Nguồn: https://docs.openaihub.net/api-45208882/ > 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/images/edits: post: summary: Chỉnh sửa gpt-image-1.5 deprecated: false description: >- Với một lời nhắc, mô hình này sẽ trả về một hoặc nhiều phần hoàn chỉnh được dự đoán, đồng thời cũng có thể trả về xác suất của các token thay thế tại mỗi vị trí. Tạo các phần hoàn chỉnh cho lời nhắc và tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/createEdit operationId: post-v1-images-edits tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: background: type: string description: >- Cho phép thiết lập độ trong suốt của nền cho hình ảnh được tạo. Các tùy chọn: opaque, transparent, auto (mặc định). Khi sử dụng auto, mô hình sẽ tự động xác định nền phù hợp nhất cho hình ảnh. Nên sử dụng định dạng png hoặc webp khi chọn transparent. examples: - tự động example: tự động image: type: string format: binary description: >- Hình ảnh cần chỉnh sửa. Phải là một tệp hình ảnh được hỗ trợ hoặc một mảng hình ảnh. Số lượng hình ảnh phải ít hơn 16 và tổng dung lượng không vượt quá 50MB. Hình ảnh đầu vào cho API chỉnh sửa. Tải lên bằng multipart/form-data. examples: - '' example: '' mask: type: string description: >- Một hình ảnh bổ sung có các vùng hoàn toàn trong suốt (ví dụ: giá trị alpha bằng không) cho biết vị trí cần chỉnh sửa hình ảnh. Nếu cung cấp nhiều hình ảnh, mặt nạ sẽ được áp dụng cho hình ảnh đầu tiên. Tệp phải là PNG hợp lệ, có dung lượng nhỏ hơn 4MB và có cùng kích thước với hình ảnh. examples: - '' example: '' model: type: string description: >- Mô hình được dùng để tạo hình ảnh. Chỉ hỗ trợ gpt-image-2.5-flare và gpt-image-2.5-sunburst. examples: - gpt-image-2.5-flare example: gpt-image-2.5-flare moderation: type: string description: >- Kiểm soát mức độ kiểm duyệt nội dung. Có thể đặt thành `low` để lọc ít hạn chế hơn hoặc `auto` (mặc định). examples: - tự động example: tự động 'n': type: string description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. examples: - '1' example: '1' prompt: type: string description: Mô tả bằng văn bản về hình ảnh mong muốn. examples: - '' example: '' quality: type: string description: |- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) examples: - tự động example: tự động size: type: string description: >- Kích thước hình ảnh 1024x1024 Hình vuông 1536x1024 Hình ngang 1024x1536 Hình dọc 2048x2048 Hình vuông 2K 2048x1152 Hình ngang 2K 3840x2160 Hình ngang 4K 2160x3840 Hình dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 examples: - 1024x1536 example: 1024x1536 required: - image - prompt examples: example: value: model: gpt-image-1 'n': 1 prompt: Một chú heo con luôn đáng yêu size: 1024x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.png headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208882-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo gpt-image-2" Nguồn: https://docs.openaihub.net/api-45208883/ > 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/images/generations: post: summary: Tạo gpt-image-2 deprecated: false description: >- Với một lời nhắc, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được dự đoán, đồng thời cũng có thể trả về xác suất của các mã từ thay thế tại mỗi vị trí. Tạo các phần hoàn thành cho lời nhắc và các tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/create operationId: post-v1-images-generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Content-Type in: header description: '' required: true example: application/json schema: type: string - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - prompt - model - 'n' properties: background: type: string enum: - auto - opaque - transparent description: |- Nền Các tùy chọn: auto (mặc định), opaque, transparent Khi transparent, định dạng phải là png hoặc webp format: type: string description: >- Định dạng hình ảnh Các tùy chọn: png, jpeg, webp Sử dụng png hoặc webp cho nền trong suốt. (Tên trường chính thức là output_format, nhưng cổng này dùng nhất quán format như trong bảng điều khiển gỡ lỗi gpt-image-2.) model: type: string enum: - gpt-image-2.5-flare - gpt-image-2.5-sunburst enumDetails: - value: gpt-image-2.5-flare displayName: Flare - value: gpt-image-2.5-sunburst displayName: Biểu đồ tia nắng description: >- Tên mô hình gpt-image-2.5-flare Nhanh hơn, phù hợp cho việc tạo nội dung hằng ngày hoặc với mức độ đồng thời cao gpt-image-2.5-sunburst Độ chính xác cao hơn, phù hợp cho việc tinh chỉnh và sản xuất nội dung sáng tạo moderation: type: string enum: - auto - low description: |- Mức độ nghiêm ngặt của kiểm duyệt nội dung Các tùy chọn: auto (mặc định), low 'n': type: integer description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. Mặc định là 1 nếu không được cung cấp. prompt: type: string description: >- Mô tả bằng văn bản về hình ảnh mong muốn. Độ dài tối đa là 1000 ký tự. quality: type: string description: >- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) So với gpt-image-2, xhigh và max là các tùy chọn mới. low phù hợp với bản nháp; xhigh / max cung cấp nhiều chi tiết hơn nhưng có độ trễ và chi phí cao hơn. response_format: type: string enum: - url - b64_json enumDetails: - value: url - value: b64_json size: type: string description: >- Kích thước hình ảnh 1024x1024 Vuông 1536x1024 Ngang 1024x1536 Dọc 2048x2048 Vuông 2K 2048x1152 Ngang 2K 3840x2160 Ngang 4K 2160x3840 Dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 Các độ phân giải trên 2560x1440 được xem là các khả năng thử nghiệm. x-apifox-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size x-apidog-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size examples: example: value: format: webp model: gpt-image-2.5-flare 'n': 1 prompt: >- Ảnh tĩnh sản phẩm: bàn phím cơ màu đen nhám, ánh sáng trường quay, không có chữ quality: trung bình response_format: url size: 1536x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.webp headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208883-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Chỉnh sửa gpt-image-2" Nguồn: https://docs.openaihub.net/api-45208884/ > 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/images/edits: post: summary: Chỉnh sửa gpt-image-2 deprecated: false description: >- Với một lời nhắc, mô hình này sẽ trả về một hoặc nhiều phần hoàn chỉnh được dự đoán, đồng thời cũng có thể trả về xác suất của các token thay thế tại mỗi vị trí. Tạo các phần hoàn chỉnh cho lời nhắc và tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/createEdit operationId: post-v1-images-edits tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: background: type: string description: >- Cho phép thiết lập độ trong suốt của nền cho hình ảnh được tạo. Các tùy chọn: opaque, transparent, auto (mặc định). Khi sử dụng auto, mô hình sẽ tự động xác định nền phù hợp nhất cho hình ảnh. Nên sử dụng định dạng png hoặc webp khi chọn transparent. examples: - tự động example: tự động image: type: string format: binary description: >- Hình ảnh cần chỉnh sửa. Phải là một tệp hình ảnh được hỗ trợ hoặc một mảng hình ảnh. Số lượng hình ảnh phải ít hơn 16 và tổng dung lượng không vượt quá 50MB. Hình ảnh đầu vào cho API chỉnh sửa. Tải lên bằng multipart/form-data. examples: - '' example: '' mask: type: string description: >- Một hình ảnh bổ sung có các vùng hoàn toàn trong suốt (ví dụ: giá trị alpha bằng không) cho biết vị trí cần chỉnh sửa hình ảnh. Nếu cung cấp nhiều hình ảnh, mặt nạ sẽ được áp dụng cho hình ảnh đầu tiên. Tệp phải là PNG hợp lệ, có dung lượng nhỏ hơn 4MB và có cùng kích thước với hình ảnh. examples: - '' example: '' model: type: string description: >- Mô hình được dùng để tạo hình ảnh. Chỉ hỗ trợ gpt-image-2.5-flare và gpt-image-2.5-sunburst. examples: - gpt-image-2.5-flare example: gpt-image-2.5-flare moderation: type: string description: >- Kiểm soát mức độ kiểm duyệt nội dung. Có thể đặt thành `low` để lọc ít hạn chế hơn hoặc `auto` (mặc định). examples: - tự động example: tự động 'n': type: string description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. examples: - '1' example: '1' prompt: type: string description: Mô tả bằng văn bản về hình ảnh mong muốn. examples: - '' example: '' quality: type: string description: |- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) examples: - tự động example: tự động size: type: string description: >- Kích thước hình ảnh 1024x1024 Hình vuông 1536x1024 Hình ngang 1024x1536 Hình dọc 2048x2048 Hình vuông 2K 2048x1152 Hình ngang 2K 3840x2160 Hình ngang 4K 2160x3840 Hình dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 examples: - 1024x1536 example: 1024x1536 required: - image - prompt examples: example: value: model: gpt-image-1 'n': 1 prompt: Một chú heo con luôn đáng yêu size: 1024x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.png headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208884-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo gpt-image-2.5" Nguồn: https://docs.openaihub.net/api-45208885/ > 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/images/generations: post: summary: Tạo gpt-image-2.5 deprecated: false description: >- Với một lời nhắc, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được dự đoán, đồng thời cũng có thể trả về xác suất của các mã từ thay thế tại mỗi vị trí. Tạo các phần hoàn thành cho lời nhắc và các tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/create operationId: post-v1-images-generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Content-Type in: header description: '' required: true example: application/json schema: type: string - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - prompt - model - 'n' properties: background: type: string enum: - auto - opaque - transparent description: |- Nền Các tùy chọn: auto (mặc định), opaque, transparent Khi transparent, định dạng phải là png hoặc webp format: type: string description: >- Định dạng hình ảnh Các tùy chọn: png, jpeg, webp Sử dụng png hoặc webp cho nền trong suốt. (Tên trường chính thức là output_format, nhưng cổng này dùng nhất quán format như trong bảng điều khiển gỡ lỗi gpt-image-2.) model: type: string enum: - gpt-image-2.5-flare - gpt-image-2.5-sunburst enumDetails: - value: gpt-image-2.5-flare displayName: Flare - value: gpt-image-2.5-sunburst displayName: Biểu đồ tia nắng description: >- Tên mô hình gpt-image-2.5-flare Nhanh hơn, phù hợp cho việc tạo nội dung hằng ngày hoặc với mức độ đồng thời cao gpt-image-2.5-sunburst Độ chính xác cao hơn, phù hợp cho việc tinh chỉnh và sản xuất nội dung sáng tạo moderation: type: string enum: - auto - low description: |- Mức độ nghiêm ngặt của kiểm duyệt nội dung Các tùy chọn: auto (mặc định), low 'n': type: integer description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. Mặc định là 1 nếu không được cung cấp. prompt: type: string description: >- Mô tả bằng văn bản về hình ảnh mong muốn. Độ dài tối đa là 1000 ký tự. quality: type: string description: >- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) So với gpt-image-2, xhigh và max là các tùy chọn mới. low phù hợp với bản nháp; xhigh / max cung cấp nhiều chi tiết hơn nhưng có độ trễ và chi phí cao hơn. response_format: type: string enum: - url - b64_json enumDetails: - value: url - value: b64_json size: type: string description: >- Kích thước hình ảnh 1024x1024 Vuông 1536x1024 Ngang 1024x1536 Dọc 2048x2048 Vuông 2K 2048x1152 Ngang 2K 3840x2160 Ngang 4K 2160x3840 Dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 Các độ phân giải trên 2560x1440 được xem là các khả năng thử nghiệm. x-apifox-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size x-apidog-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size examples: example: value: format: webp model: gpt-image-2.5-flare 'n': 1 prompt: >- Ảnh tĩnh sản phẩm: bàn phím cơ màu đen nhám, ánh sáng trường quay, không có chữ quality: trung bình response_format: url size: 1536x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.webp headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208885-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Chỉnh sửa gpt-image-2.5" Nguồn: https://docs.openaihub.net/api-45208886/ > 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/images/edits: post: summary: Chỉnh sửa gpt-image-2.5 deprecated: false description: >- Với một lời nhắc, mô hình này sẽ trả về một hoặc nhiều phần hoàn chỉnh được dự đoán, đồng thời cũng có thể trả về xác suất của các token thay thế tại mỗi vị trí. Tạo các phần hoàn chỉnh cho lời nhắc và tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/createEdit operationId: post-v1-images-edits tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: background: type: string description: >- Cho phép thiết lập độ trong suốt của nền cho hình ảnh được tạo. Các tùy chọn: opaque, transparent, auto (mặc định). Khi sử dụng auto, mô hình sẽ tự động xác định nền phù hợp nhất cho hình ảnh. Nên sử dụng định dạng png hoặc webp khi chọn transparent. examples: - tự động example: tự động image: type: string format: binary description: >- Hình ảnh cần chỉnh sửa. Phải là một tệp hình ảnh được hỗ trợ hoặc một mảng hình ảnh. Số lượng hình ảnh phải ít hơn 16 và tổng dung lượng không vượt quá 50MB. Hình ảnh đầu vào cho API chỉnh sửa. Tải lên bằng multipart/form-data. examples: - '' example: '' mask: type: string description: >- Một hình ảnh bổ sung có các vùng hoàn toàn trong suốt (ví dụ: giá trị alpha bằng không) cho biết vị trí cần chỉnh sửa hình ảnh. Nếu cung cấp nhiều hình ảnh, mặt nạ sẽ được áp dụng cho hình ảnh đầu tiên. Tệp phải là PNG hợp lệ, có dung lượng nhỏ hơn 4MB và có cùng kích thước với hình ảnh. examples: - '' example: '' model: type: string description: >- Mô hình được dùng để tạo hình ảnh. Chỉ hỗ trợ gpt-image-2.5-flare và gpt-image-2.5-sunburst. examples: - gpt-image-2.5-flare example: gpt-image-2.5-flare moderation: type: string description: >- Kiểm soát mức độ kiểm duyệt nội dung. Có thể đặt thành `low` để lọc ít hạn chế hơn hoặc `auto` (mặc định). examples: - tự động example: tự động 'n': type: string description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. examples: - '1' example: '1' prompt: type: string description: Mô tả bằng văn bản về hình ảnh mong muốn. examples: - '' example: '' quality: type: string description: |- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) examples: - tự động example: tự động size: type: string description: >- Kích thước hình ảnh 1024x1024 Hình vuông 1536x1024 Hình ngang 1024x1536 Hình dọc 2048x2048 Hình vuông 2K 2048x1152 Hình ngang 2K 3840x2160 Hình ngang 4K 2160x3840 Hình dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 examples: - 1024x1536 example: 1024x1536 required: - image - prompt examples: example: value: model: gpt-image-1 'n': 1 prompt: Một chú heo con luôn đáng yêu size: 1024x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.png headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/GPT Image-1 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208886-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo hình ảnh" Nguồn: https://docs.openaihub.net/api-45208887/ > 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/images/generations: post: summary: Tạo hình ảnh deprecated: false description: >- Với một lời nhắc, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được dự đoán, đồng thời cũng có thể trả về xác suất của các mã từ thay thế tại mỗi vị trí. Tạo các phần hoàn thành cho lời nhắc và các tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/create operationId: v1_images_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Grok - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Content-Type in: header description: '' required: true example: application/json schema: type: string - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - prompt - model - 'n' properties: background: type: string enum: - auto - opaque - transparent description: |- Nền Các tùy chọn: auto (mặc định), opaque, transparent Khi transparent, định dạng phải là png hoặc webp format: type: string description: >- Định dạng hình ảnh Các tùy chọn: png, jpeg, webp Sử dụng png hoặc webp cho nền trong suốt. (Tên trường chính thức là output_format, nhưng cổng này dùng nhất quán format như trong bảng điều khiển gỡ lỗi gpt-image-2.) model: type: string enum: - gpt-image-2.5-flare - gpt-image-2.5-sunburst enumDetails: - value: gpt-image-2.5-flare displayName: Flare - value: gpt-image-2.5-sunburst displayName: Biểu đồ tia nắng description: >- Tên mô hình gpt-image-2.5-flare Nhanh hơn, phù hợp cho việc tạo nội dung hằng ngày hoặc với mức độ đồng thời cao gpt-image-2.5-sunburst Độ chính xác cao hơn, phù hợp cho việc tinh chỉnh và sản xuất nội dung sáng tạo moderation: type: string enum: - auto - low description: |- Mức độ nghiêm ngặt của kiểm duyệt nội dung Các tùy chọn: auto (mặc định), low 'n': type: integer description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. Mặc định là 1 nếu không được cung cấp. prompt: type: string description: >- Mô tả bằng văn bản về hình ảnh mong muốn. Độ dài tối đa là 1000 ký tự. quality: type: string description: >- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) So với gpt-image-2, xhigh và max là các tùy chọn mới. low phù hợp với bản nháp; xhigh / max cung cấp nhiều chi tiết hơn nhưng có độ trễ và chi phí cao hơn. response_format: type: string enum: - url - b64_json enumDetails: - value: url - value: b64_json size: type: string description: >- Kích thước hình ảnh 1024x1024 Vuông 1536x1024 Ngang 1024x1536 Dọc 2048x2048 Vuông 2K 2048x1152 Ngang 2K 3840x2160 Ngang 4K 2160x3840 Dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 Các độ phân giải trên 2560x1440 được xem là các khả năng thử nghiệm. x-apifox-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size x-apidog-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size examples: example: value: format: webp model: gpt-image-2.5-flare 'n': 1 prompt: >- Ảnh tĩnh sản phẩm: bàn phím cơ màu đen nhám, ánh sáng trường quay, không có chữ quality: trung bình response_format: url size: 1536x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.webp headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Grok x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208887-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "chỉnh sửa hình ảnh" Nguồn: https://docs.openaihub.net/api-45208888/ > 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/images/edits: post: summary: chỉnh sửa hình ảnh deprecated: false description: >- Với một lời nhắc, mô hình này sẽ trả về một hoặc nhiều phần hoàn chỉnh được dự đoán, đồng thời cũng có thể trả về xác suất của các token thay thế tại mỗi vị trí. Tạo các phần hoàn chỉnh cho lời nhắc và tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/createEdit operationId: v1_images_edits tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Grok - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: background: type: string description: >- Cho phép thiết lập độ trong suốt của nền cho hình ảnh được tạo. Các tùy chọn: opaque, transparent, auto (mặc định). Khi sử dụng auto, mô hình sẽ tự động xác định nền phù hợp nhất cho hình ảnh. Nên sử dụng định dạng png hoặc webp khi chọn transparent. examples: - tự động example: tự động image: type: string format: binary description: >- Hình ảnh cần chỉnh sửa. Phải là một tệp hình ảnh được hỗ trợ hoặc một mảng hình ảnh. Số lượng hình ảnh phải ít hơn 16 và tổng dung lượng không vượt quá 50MB. Hình ảnh đầu vào cho API chỉnh sửa. Tải lên bằng multipart/form-data. examples: - '' example: '' mask: type: string description: >- Một hình ảnh bổ sung có các vùng hoàn toàn trong suốt (ví dụ: giá trị alpha bằng không) cho biết vị trí cần chỉnh sửa hình ảnh. Nếu cung cấp nhiều hình ảnh, mặt nạ sẽ được áp dụng cho hình ảnh đầu tiên. Tệp phải là PNG hợp lệ, có dung lượng nhỏ hơn 4MB và có cùng kích thước với hình ảnh. examples: - '' example: '' model: type: string description: >- Mô hình được dùng để tạo hình ảnh. Chỉ hỗ trợ gpt-image-2.5-flare và gpt-image-2.5-sunburst. examples: - gpt-image-2.5-flare example: gpt-image-2.5-flare moderation: type: string description: >- Kiểm soát mức độ kiểm duyệt nội dung. Có thể đặt thành `low` để lọc ít hạn chế hơn hoặc `auto` (mặc định). examples: - tự động example: tự động 'n': type: string description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. examples: - '1' example: '1' prompt: type: string description: Mô tả bằng văn bản về hình ảnh mong muốn. examples: - '' example: '' quality: type: string description: |- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) examples: - tự động example: tự động size: type: string description: >- Kích thước hình ảnh 1024x1024 Hình vuông 1536x1024 Hình ngang 1024x1536 Hình dọc 2048x2048 Hình vuông 2K 2048x1152 Hình ngang 2K 3840x2160 Hình ngang 4K 2160x3840 Hình dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 examples: - 1024x1536 example: 1024x1536 required: - image - prompt examples: example: value: model: gpt-image-1 'n': 1 prompt: Một chú heo con luôn đáng yêu size: 1024x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.png headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Grok x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208888-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo DALL·E 3" Nguồn: https://docs.openaihub.net/api-45208889/ > 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/images/generations: post: summary: Tạo DALL·E 3 deprecated: false description: >- Với một lời nhắc, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được dự đoán, đồng thời cũng có thể trả về xác suất của các mã từ thay thế tại mỗi vị trí. Tạo các phần hoàn thành cho lời nhắc và các tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/create operationId: v1_images_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/DALL·E 3 - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Content-Type in: header description: '' required: true example: application/json schema: type: string - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - prompt - model - 'n' properties: background: type: string enum: - auto - opaque - transparent description: |- Nền Các tùy chọn: auto (mặc định), opaque, transparent Khi transparent, định dạng phải là png hoặc webp format: type: string description: >- Định dạng hình ảnh Các tùy chọn: png, jpeg, webp Sử dụng png hoặc webp cho nền trong suốt. (Tên trường chính thức là output_format, nhưng cổng này dùng nhất quán format như trong bảng điều khiển gỡ lỗi gpt-image-2.) model: type: string enum: - gpt-image-2.5-flare - gpt-image-2.5-sunburst enumDetails: - value: gpt-image-2.5-flare displayName: Flare - value: gpt-image-2.5-sunburst displayName: Biểu đồ tia nắng description: >- Tên mô hình gpt-image-2.5-flare Nhanh hơn, phù hợp cho việc tạo nội dung hằng ngày hoặc với mức độ đồng thời cao gpt-image-2.5-sunburst Độ chính xác cao hơn, phù hợp cho việc tinh chỉnh và sản xuất nội dung sáng tạo moderation: type: string enum: - auto - low description: |- Mức độ nghiêm ngặt của kiểm duyệt nội dung Các tùy chọn: auto (mặc định), low 'n': type: integer description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. Mặc định là 1 nếu không được cung cấp. prompt: type: string description: >- Mô tả bằng văn bản về hình ảnh mong muốn. Độ dài tối đa là 1000 ký tự. quality: type: string description: >- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) So với gpt-image-2, xhigh và max là các tùy chọn mới. low phù hợp với bản nháp; xhigh / max cung cấp nhiều chi tiết hơn nhưng có độ trễ và chi phí cao hơn. response_format: type: string enum: - url - b64_json enumDetails: - value: url - value: b64_json size: type: string description: >- Kích thước hình ảnh 1024x1024 Vuông 1536x1024 Ngang 1024x1536 Dọc 2048x2048 Vuông 2K 2048x1152 Ngang 2K 3840x2160 Ngang 4K 2160x3840 Dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 Các độ phân giải trên 2560x1440 được xem là các khả năng thử nghiệm. x-apifox-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size x-apidog-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size examples: example: value: format: webp model: gpt-image-2.5-flare 'n': 1 prompt: >- Ảnh tĩnh sản phẩm: bàn phím cơ màu đen nhám, ánh sáng trường quay, không có chữ quality: trung bình response_format: url size: 1536x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.webp headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/DALL·E 3 x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208889-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo/chỉnh sửa hình ảnh" Nguồn: https://docs.openaihub.net/api-45208890/ > 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/images/generations: post: summary: Tạo/chỉnh sửa hình ảnh deprecated: false description: >- Với một lời nhắc, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được dự đoán, đồng thời cũng có thể trả về xác suất của các mã từ thay thế tại mỗi vị trí. Tạo các phần hoàn thành cho lời nhắc và các tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/create operationId: v1_images_generations tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/FLUX/định dạng tương thích với GPT - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Content-Type in: header description: '' required: true example: application/json schema: type: string - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - prompt - model - 'n' properties: background: type: string enum: - auto - opaque - transparent description: |- Nền Các tùy chọn: auto (mặc định), opaque, transparent Khi transparent, định dạng phải là png hoặc webp format: type: string description: >- Định dạng hình ảnh Các tùy chọn: png, jpeg, webp Sử dụng png hoặc webp cho nền trong suốt. (Tên trường chính thức là output_format, nhưng cổng này dùng nhất quán format như trong bảng điều khiển gỡ lỗi gpt-image-2.) model: type: string enum: - gpt-image-2.5-flare - gpt-image-2.5-sunburst enumDetails: - value: gpt-image-2.5-flare displayName: Flare - value: gpt-image-2.5-sunburst displayName: Biểu đồ tia nắng description: >- Tên mô hình gpt-image-2.5-flare Nhanh hơn, phù hợp cho việc tạo nội dung hằng ngày hoặc với mức độ đồng thời cao gpt-image-2.5-sunburst Độ chính xác cao hơn, phù hợp cho việc tinh chỉnh và sản xuất nội dung sáng tạo moderation: type: string enum: - auto - low description: |- Mức độ nghiêm ngặt của kiểm duyệt nội dung Các tùy chọn: auto (mặc định), low 'n': type: integer description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. Mặc định là 1 nếu không được cung cấp. prompt: type: string description: >- Mô tả bằng văn bản về hình ảnh mong muốn. Độ dài tối đa là 1000 ký tự. quality: type: string description: >- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) So với gpt-image-2, xhigh và max là các tùy chọn mới. low phù hợp với bản nháp; xhigh / max cung cấp nhiều chi tiết hơn nhưng có độ trễ và chi phí cao hơn. response_format: type: string enum: - url - b64_json enumDetails: - value: url - value: b64_json size: type: string description: >- Kích thước hình ảnh 1024x1024 Vuông 1536x1024 Ngang 1024x1536 Dọc 2048x2048 Vuông 2K 2048x1152 Ngang 2K 3840x2160 Ngang 4K 2160x3840 Dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 Các độ phân giải trên 2560x1440 được xem là các khả năng thử nghiệm. x-apifox-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size x-apidog-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size examples: example: value: format: webp model: gpt-image-2.5-flare 'n': 1 prompt: >- Ảnh tĩnh sản phẩm: bàn phím cơ màu đen nhám, ánh sáng trường quay, không có chữ quality: trung bình response_format: url size: 1536x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.webp headers: {} x-apidog-name: '' security: [] x-apidog-folder: >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/FLUX/định dạng tương thích với GPT x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208890-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Chỉnh sửa Flux (định dạng dall-e-3 của OpenAI)" Nguồn: https://docs.openaihub.net/api-45208891/ > 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/images/edits: post: summary: Chỉnh sửa Flux (định dạng dall-e-3 của OpenAI) deprecated: false description: >- Với một lời nhắc, mô hình này sẽ trả về một hoặc nhiều phần hoàn chỉnh được dự đoán, đồng thời cũng có thể trả về xác suất của các token thay thế tại mỗi vị trí. Tạo các phần hoàn chỉnh cho lời nhắc và tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/createEdit operationId: v1_images_edits tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/FLUX/định dạng tương thích với GPT - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: multipart/form-data: schema: type: object properties: background: type: string description: >- Cho phép thiết lập độ trong suốt của nền cho hình ảnh được tạo. Các tùy chọn: opaque, transparent, auto (mặc định). Khi sử dụng auto, mô hình sẽ tự động xác định nền phù hợp nhất cho hình ảnh. Nên sử dụng định dạng png hoặc webp khi chọn transparent. examples: - tự động example: tự động image: type: string format: binary description: >- Hình ảnh cần chỉnh sửa. Phải là một tệp hình ảnh được hỗ trợ hoặc một mảng hình ảnh. Số lượng hình ảnh phải ít hơn 16 và tổng dung lượng không vượt quá 50MB. Hình ảnh đầu vào cho API chỉnh sửa. Tải lên bằng multipart/form-data. examples: - '' example: '' mask: type: string description: >- Một hình ảnh bổ sung có các vùng hoàn toàn trong suốt (ví dụ: giá trị alpha bằng không) cho biết vị trí cần chỉnh sửa hình ảnh. Nếu cung cấp nhiều hình ảnh, mặt nạ sẽ được áp dụng cho hình ảnh đầu tiên. Tệp phải là PNG hợp lệ, có dung lượng nhỏ hơn 4MB và có cùng kích thước với hình ảnh. examples: - '' example: '' model: type: string description: >- Mô hình được dùng để tạo hình ảnh. Chỉ hỗ trợ gpt-image-2.5-flare và gpt-image-2.5-sunburst. examples: - gpt-image-2.5-flare example: gpt-image-2.5-flare moderation: type: string description: >- Kiểm soát mức độ kiểm duyệt nội dung. Có thể đặt thành `low` để lọc ít hạn chế hơn hoặc `auto` (mặc định). examples: - tự động example: tự động 'n': type: string description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. examples: - '1' example: '1' prompt: type: string description: Mô tả bằng văn bản về hình ảnh mong muốn. examples: - '' example: '' quality: type: string description: |- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) examples: - tự động example: tự động size: type: string description: >- Kích thước hình ảnh 1024x1024 Hình vuông 1536x1024 Hình ngang 1024x1536 Hình dọc 2048x2048 Hình vuông 2K 2048x1152 Hình ngang 2K 3840x2160 Hình ngang 4K 2160x3840 Hình dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 examples: - 1024x1536 example: 1024x1536 required: - image - prompt examples: example: value: model: gpt-image-1 'n': 1 prompt: Một chú heo con luôn đáng yêu size: 1024x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.png headers: {} x-apidog-name: '' security: [] x-apidog-folder: >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/FLUX/định dạng tương thích với GPT x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208891-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ black-forest-labs/flux-kontext-dev" Nguồn: https://docs.openaihub.net/api-45208892/ > 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: /replicate/v1/models/black-forest-labs/flux-kontext-dev/predictions: post: summary: Tạo tác vụ black-forest-labs/flux-kontext-dev deprecated: false description: >- Tài liệu chính thức: https://replicate.com/black-forest-labs/flux-kontext-dev operationId: >- replicate_replicate_v1_models_black_forest_labs_flux_kontext_dev_predictions tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/FLUX/Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. - Tái tạo parameters: - 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: input: type: object required: - prompt - input_image properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Sử dụng "match_input_image" để khớp với tỷ lệ khung hình của hình ảnh đầu vào. Giá trị mặc định: "match_input_image". go_fast: type: boolean description: >- Giúp mô hình chạy nhanh hơn, chất lượng đầu ra có thể giảm nhẹ đối với các lời nhắc khó hơn. Giá trị mặc định: true. guidance: type: number description: >- Các từ gợi ý điều chỉnh cường độ. Giá trị mặc định: 2.5. Giá trị tối thiểu: 0, giá trị tối đa: 10 input_image: type: string description: >- Hình ảnh dùng làm tài liệu tham khảo. Phải có định dạng jpeg, png, gif hoặc webp. num_inference_steps: type: integer description: >- Số bước suy luận, mặc định: 28. Giá trị tối thiểu: 4, giá trị tối đa: 50. output_format: type: string description: 'Định dạng ảnh đầu ra. Mặc định: "webp".' output_quality: type: integer description: >- Chất lượng lưu hình ảnh đầu ra, từ 0 đến 100. 100 là chất lượng tốt nhất, 0 là chất lượng thấp nhất. Không liên quan đến đầu ra .png. Giá trị mặc định: 80. Giá trị nhỏ nhất: 0, giá trị lớn nhất: 100. prompt: type: string description: >- Mô tả bằng văn bản về nội dung bạn muốn tạo, hoặc hướng dẫn cách chỉnh sửa một hình ảnh được cung cấp. description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - go_fast - guidance - input_image - num_inference_steps - output_format - output_quality - prompt x-apidog-orders: - aspect_ratio - go_fast - guidance - input_image - num_inference_steps - output_format - output_quality - prompt x-apifox-orders: - input x-apidog-orders: - input examples: black_forest_labsflux_kontext_dev_single: value: input: aspect_ratio: match_input_image go_fast: true guidance: 2.5 input_image: >- https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg num_inference_steps: 30 output_format: jpg output_quality: 80 prompt: Đổi màu xe thành màu đỏ, bật đèn pha summary: black_forest_labsflux_kontext_dev_single description: Tạo tác vụ black-forest-labs/flux-kontext-dev responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: >- PostReplicateV1ModelsBlackForestLabsFluxKontextDevPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-29T07:12:42.163Z' data_removed: false id: tpdf40dypdrma0cram394vvzkg input: aspect_ratio: match_input_image go_fast: true guidance: 2.5 input_image: >- https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg num_inference_steps: 30 output_format: jpg output_quality: 80 prompt: Đổi màu xe thành màu đỏ, bật đèn pha logs: '' model: black-forest-labs/flux-kontext-dev status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/tpdf40dypdrma0cram394vvzkg/cancel get: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập trực tiếp URL này. stream: >- Vui lòng dán nội dung tài liệu cần dịch vào đây; tôi không thể truy cập trực tiếp URL được cung cấp. web: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ liên kết đã cung cấp. version: ẩn 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/Hình ảnh/FLUX/Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208892-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-45208893/ > 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: /replicate/v1/predictions/{id}: get: summary: Các tác vụ truy vấn deprecated: false description: Truy vấn trạng thái và kết quả tác vụ dựa trên ID dự đoán. operationId: replicate_replicate_v1_predictions_2 tags: - >- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/FLUX/Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. - Tái tạo 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: request_id: req_example status: OK 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/Hình ảnh/FLUX/Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208893-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo hình ảnh" Nguồn: https://docs.openaihub.net/api-45208894/ > 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/images/generations: post: summary: Tạo hình ảnh deprecated: false description: >- Với một lời nhắc, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được dự đoán, đồng thời cũng có thể trả về xác suất của các mã từ thay thế tại mỗi vị trí. Tạo các phần hoàn thành cho lời nhắc và các tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/create operationId: v1_images_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Doubao - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Content-Type in: header description: '' required: true example: application/json schema: type: string - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - prompt - model - 'n' properties: background: type: string enum: - auto - opaque - transparent description: |- Nền Các tùy chọn: auto (mặc định), opaque, transparent Khi transparent, định dạng phải là png hoặc webp format: type: string description: >- Định dạng hình ảnh Các tùy chọn: png, jpeg, webp Sử dụng png hoặc webp cho nền trong suốt. (Tên trường chính thức là output_format, nhưng cổng này dùng nhất quán format như trong bảng điều khiển gỡ lỗi gpt-image-2.) model: type: string enum: - gpt-image-2.5-flare - gpt-image-2.5-sunburst enumDetails: - value: gpt-image-2.5-flare displayName: Flare - value: gpt-image-2.5-sunburst displayName: Biểu đồ tia nắng description: >- Tên mô hình gpt-image-2.5-flare Nhanh hơn, phù hợp cho việc tạo nội dung hằng ngày hoặc với mức độ đồng thời cao gpt-image-2.5-sunburst Độ chính xác cao hơn, phù hợp cho việc tinh chỉnh và sản xuất nội dung sáng tạo moderation: type: string enum: - auto - low description: |- Mức độ nghiêm ngặt của kiểm duyệt nội dung Các tùy chọn: auto (mặc định), low 'n': type: integer description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. Mặc định là 1 nếu không được cung cấp. prompt: type: string description: >- Mô tả bằng văn bản về hình ảnh mong muốn. Độ dài tối đa là 1000 ký tự. quality: type: string description: >- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) So với gpt-image-2, xhigh và max là các tùy chọn mới. low phù hợp với bản nháp; xhigh / max cung cấp nhiều chi tiết hơn nhưng có độ trễ và chi phí cao hơn. response_format: type: string enum: - url - b64_json enumDetails: - value: url - value: b64_json size: type: string description: >- Kích thước hình ảnh 1024x1024 Vuông 1536x1024 Ngang 1024x1536 Dọc 2048x2048 Vuông 2K 2048x1152 Ngang 2K 3840x2160 Ngang 4K 2160x3840 Dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 Các độ phân giải trên 2560x1440 được xem là các khả năng thử nghiệm. x-apifox-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size x-apidog-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size examples: example: value: format: webp model: gpt-image-2.5-flare 'n': 1 prompt: >- Ảnh tĩnh sản phẩm: bàn phím cơ màu đen nhám, ánh sáng trường quay, không có chữ quality: trung bình response_format: url size: 1536x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.webp headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Doubao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208894-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Seedream 5.0 Pro" Nguồn: https://docs.openaihub.net/api-45208895/ > 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/images/generations: post: summary: Seedream 5.0 Pro deprecated: false description: '' operationId: post-api-v3-images-generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Doubao - volc parameters: [] requestBody: content: application/json: schema: type: object required: - model - prompt properties: guidance_scale: type: number description: Mức độ tuân thủ lời nhắc; phạm vi [1, 10] image: oneOf: - type: string format: uri - type: array items: type: string format: uri description: >- Tham chiếu (chính thức). Một chuỗi URL đơn hoặc mảng URL (chỉnh sửa tương tác / I2I, tối đa khoảng 10) images: oneOf: - type: string format: uri - type: array items: type: string format: uri description: >- trường tương thích; cổng kết nối chuẩn hóa thành image. Dùng trường này hoặc image model: type: string enum: - doubao-seedream-5-0-pro-260628 description: Tên mô hình 'n': type: integer description: Số lượng hình ảnh; Pro thường là 1 optimize_prompt_options: type: object required: - mode properties: mode: type: string enum: - standard - fast description: chế độ tối ưu hóa description: cài đặt tối ưu hóa lời nhắc x-apifox-orders: - mode x-apidog-orders: - mode output_format: type: string enum: - jpeg - png description: định dạng tệp hình ảnh prompt: type: string description: lời nhắc tạo / chỉnh sửa response_format: type: string enum: - url - b64_json description: cấu trúc phản hồi seed: type: integer description: Hạt giống ngẫu nhiên, phạm vi [-1, 2147483647], mặc định -1 size: type: string enum: - 1K - 2K - 1024x1024 - 1152x864 - 864x1152 - 1424x800 - 800x1424 - 1248x832 - 832x1248 - 1568x672 - 2048x2048 - 2368x1776 - 1776x2368 - 2816x1584 - 1584x2816 - 2496x1664 - 1664x2496 - 3136x1344 description: >- Mức độ phân giải hoặc số pixel. Thường là 1K/2K; cũng có thể là 1024x1024, 2048x2048, 2816x1584. Nếu để trống, chi phí sẽ được tính theo mức cao hơn watermark: type: boolean description: Có thêm hình mờ hay không x-apifox-orders: - guidance_scale - image - images - model - 'n' - optimize_prompt_options - output_format - prompt - response_format - seed - size - watermark x-apidog-orders: - guidance_scale - image - images - model - 'n' - optimize_prompt_options - output_format - prompt - response_format - seed - size - watermark examples: example: value: model: doubao-seedream-5-0-pro-260628 prompt: Một con mèo response_format: url size: 2K watermark: false 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/Hình ảnh/Doubao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208895-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-45208896/ > 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: /fal-ai/{model_name}/requests/{request_id}: get: summary: Lấy kết quả yêu cầu deprecated: false description: >- Truy vấn kết quả tác vụ bất đồng bộ của Fal.ai; trả về đầu ra là hình ảnh hoặc video. operationId: fal_ai_fal_ai_requests tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: - name: model_name in: path description: >- Tên mô hình, tự động Hệ thống của chúng tôi sẽ tự động xác định model_name required: true example: tự động schema: type: string - name: request_id in: path description: mã tác vụ required: true example: 5ed6b6bb-eaa3-4006-859b-e2f3fa748d8c schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: has_nsfw_concepts: - false images: - content_type: image/jpeg height: 1024 url: >- https://fal.media/files/tiger/BwdOcvXOx0UmkCyCMZGmZ_1ee10db761e146a28fdaadafa528d239.jpg width: 1024 prompt: >- Đặt chú vịt con nhỏ lên phía trên áo thun của người phụ nữ. request: guidance_scale: 3.5 image_urls: - >- https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp - >- Vui lòng tải hình ảnh lên trực tiếp để tôi có thể đọc và dịch nội dung. num_images: 1 output_format: jpeg prompt: >- Đặt chú vịt con nhỏ lên phía trên áo thun của người phụ nữ. safety_tolerance: '2' seed: 2841475369 timings: {} 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208896-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/nano-banana Tạo ảnh từ văn bản" Nguồn: https://docs.openaihub.net/api-45208897/ > 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: /fal-ai/nano-banana: post: summary: /fal-ai/nano-banana Tạo ảnh từ văn bản deprecated: false description: 'Tài liệu chính thức: https://fal.ai/models/fal-ai/nano-banana' operationId: fal_ai_fal_ai_nano_banana tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt properties: num_images: type: integer description: >- Số lượng hình ảnh được tạo. Phạm vi giá trị: 1-4. Giá trị mặc định: 1 prompt: type: string description: Tạo các từ gợi ý cho hình ảnh. refName: PostFalAiNanoBananaRequest x-apifox-orders: - num_images - prompt x-apidog-orders: - num_images - prompt examples: fal_ainano_banana_single: value: num_images: 1 prompt: >- Cảnh hành động chụp một chú chó Labrador đen đang bơi trong hồ bơi âm đất ở khu ngoại ô. Máy ảnh được đặt chính xác trên mặt nước, chia đôi hình ảnh, cho thấy cả đầu chú chó nhô lên khỏi mặt nước với một quả bóng tennis ngậm trong miệng, lẫn những bàn chân đang quẫy dưới nước. summary: fal_ainano_banana_single description: /fal-ai/nano-banana Tạo ảnh từ văn bản responses: '200': description: '' content: application/json: schema: type: object required: - status - request_id - response_url - status_url - cancel_url - logs - metrics - queue_position properties: cancel_url: type: string description: URL hủy tác vụ logs: type: array items: type: string description: Nhật ký chạy nullable: true metrics: type: object description: Số liệu chạy x-apidog-orders: [] queue_position: type: integer description: Vị trí trong hàng đợi request_id: type: string description: ID truy vết yêu cầu response_url: type: string description: URL truy vấn kết quả status: type: string description: Trạng thái status_url: type: string description: URL truy vấn trạng thái refName: PostFalAiNanoBananaResponse x-apifox-orders: - cancel_url - logs - metrics - queue_position - request_id - response_url - status - status_url x-apidog-orders: - cancel_url - logs - metrics - queue_position - request_id - response_url - status - status_url examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca/cancel logs: [] metrics: {} queue_position: 0 request_id: e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca response_url: >- Vui lòng dịch nội dung tài liệu kỹ thuật tại URL sau sang tiếng Việt. Giữ nguyên Markdown, mã, định danh, URL, đường dẫn, chỗ 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 bất kỳ chữ Hán nào: https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/nano-banana/requests/e7e9202c-efb8-40f2-81c3-13b3f7aaa4ca/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208897-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/nano-banana/edit Chỉnh sửa hình ảnh" Nguồn: https://docs.openaihub.net/api-45208898/ > 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: /fal-ai/nano-banana/edit: post: summary: /fal-ai/nano-banana/edit Chỉnh sửa hình ảnh deprecated: false description: 'Tài liệu chính thức: https://fal.ai/models/fal-ai/nano-banana/edit' operationId: fal_ai_fal_ai_nano_banana_edit tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_urls properties: image_urls: type: array items: type: string description: URL hình ảnh cần được chỉnh sửa. num_images: type: integer description: >- Số lượng hình ảnh được tạo. Phạm vi giá trị: 1-4. Giá trị mặc định: 1 prompt: type: string description: Các từ khóa gợi ý để chỉnh sửa hình ảnh. refName: PostFalAiNanoBananaEditRequest x-apifox-orders: - image_urls - num_images - prompt x-apidog-orders: - image_urls - num_images - prompt examples: fal_ainano_bananaedit_single: value: image_urls: - >- https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input.png - >- https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input-2.png num_images: 1 prompt: >- tạo một bức ảnh người đàn ông đang lái xe dọc theo bờ biển California summary: fal_ainano_bananaedit_single description: /fal-ai/nano-banana/edit Chỉnh sửa hình ảnh responses: '200': description: '' content: application/json: schema: type: object required: - status - request_id - response_url - status_url - cancel_url - logs - metrics - queue_position properties: cancel_url: type: string description: URL hủy tác vụ logs: type: array items: type: string description: Nhật ký chạy nullable: true metrics: type: object description: Số liệu chạy x-apidog-orders: [] queue_position: type: integer description: Vị trí trong hàng đợi request_id: type: string description: ID truy vết yêu cầu response_url: type: string description: URL truy vấn kết quả status: type: string description: Trạng thái status_url: type: string description: URL truy vấn trạng thái refName: PostFalAiNanoBananaEditResponse x-apifox-orders: - cancel_url - logs - metrics - queue_position - request_id - response_url - status - status_url x-apidog-orders: - cancel_url - logs - metrics - queue_position - request_id - response_url - status - status_url examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/nano-banana/requests/f8837f29-26cb-4213-90f5-22b2911a0ea7/cancel logs: [] metrics: {} queue_position: 0 request_id: f8837f29-26cb-4213-90f5-22b2911a0ea7 response_url: >- Vui lòng cung cấp nội dung tài liệu cần dịch; tôi không thể truy cập trực tiếp URL này. status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/nano-banana/requests/f8837f29-26cb-4213-90f5-22b2911a0ea7/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208898-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-45208899/ > 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: /fal-ai/{model_name}/requests/{request_id}: get: summary: Lấy kết quả yêu cầu deprecated: false description: >- Truy vấn kết quả tác vụ bất đồng bộ của Fal.ai; trả về đầu ra là hình ảnh hoặc video. operationId: fal_ai_fal_ai_requests tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: - name: model_name in: path description: >- Tên mô hình, tự động Hệ thống của chúng tôi sẽ tự động xác định model_name required: true example: tự động schema: type: string - name: request_id in: path description: mã tác vụ required: true example: 5ed6b6bb-eaa3-4006-859b-e2f3fa748d8c schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: has_nsfw_concepts: - false images: - content_type: image/jpeg height: 1024 url: >- https://fal.media/files/tiger/BwdOcvXOx0UmkCyCMZGmZ_1ee10db761e146a28fdaadafa528d239.jpg width: 1024 prompt: >- Đặt chú vịt con nhỏ lên phía trên áo thun của người phụ nữ. request: guidance_scale: 3.5 image_urls: - >- https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp - >- Vui lòng tải hình ảnh lên trực tiếp để tôi có thể đọc và dịch nội dung. num_images: 1 output_format: jpeg prompt: >- Đặt chú vịt con nhỏ lên phía trên áo thun của người phụ nữ. safety_tolerance: '2' seed: 2841475369 timings: {} 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208899-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-1/dev" Nguồn: https://docs.openaihub.net/api-45208900/ > 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: /fal-ai/flux-1/dev: post: summary: /fal-ai/flux-1/dev deprecated: false description: 'Tài liệu chính thức: https://fal.ai/models/fal-ai/flux-1/dev' operationId: fal_ai_fal_ai_flux_1_dev tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt properties: acceleration: type: string description: >- Tốc độ tạo. Tốc độ càng cao thì quá trình dựng càng nhanh. Giá trị mặc định: "regular" . Hỗ trợ: default, none, regular, high enable_safety_checker: type: boolean description: >- Nếu được đặt thành `true`, trình kiểm tra bảo mật sẽ được bật. Giá trị mặc định: `true` guidance_scale: type: number description: >- Thang CFG (Classifier Free Guidance - Huong dan khong can bo phan phan loai) do muc do ban muon mo hinh bam sat cac goi y khi tim hinh anh phu hop. Gia tri mac dinh: 3.5. Pham vi gia tri: 1-20 image_size: type: string description: >- Kích thước của hình ảnh được tạo. Mặc định: landscape_4_3, phạm vi (3:4, 4:3, 16:9, 9:16) num_images: type: integer description: >- Số lượng hình ảnh được tạo. Giá trị mặc định: 1 Giá trị trong khoảng: 1-4 num_inference_steps: type: integer description: >- Số bước suy luận cần thực hiện. Giá trị mặc định: 28. Phạm vi giá trị: 0-50 output_format: type: string description: >- Định dạng của hình ảnh được tạo. Giá trị mặc định: "jpeg". Các định dạng được hỗ trợ: default, JPEG, png prompt: type: string description: Lời nhắc văn bản refName: PostFalAiFlux1DevRequest x-apifox-orders: - acceleration - enable_safety_checker - guidance_scale - image_size - num_images - num_inference_steps - output_format - prompt x-apidog-orders: - acceleration - enable_safety_checker - guidance_scale - image_size - num_images - num_inference_steps - output_format - prompt examples: fal_aiflux_1dev_single: value: acceleration: thông thường enable_safety_checker: true guidance_scale: 3.5 image_size: landscape_4_3 num_images: 1 num_inference_steps: 28 output_format: jpeg prompt: >- Cảnh cực cận của một mắt hổ duy nhất, nhìn thẳng từ chính diện. Mống mắt và đồng tử chi tiết. Lấy nét sắc nét vào kết cấu và màu sắc của mắt. Ánh sáng tự nhiên làm nổi bật độ long lanh và chiều sâu chân thực của mắt. Từ "FLUX" được vẽ đè lên trên bằng những nét cọ lớn màu trắng, với kết cấu hiện rõ. summary: fal_aiflux_1dev_single description: /fal-ai/flux-1/dev responses: '200': description: '' content: application/json: schema: type: object required: - status - request_id - response_url - status_url - cancel_url - logs - metrics - queue_position properties: cancel_url: type: string description: URL hủy tác vụ logs: type: array items: type: string description: Nhật ký chạy nullable: true metrics: type: object description: Số liệu chạy x-apidog-orders: [] queue_position: type: integer description: Vị trí trong hàng đợi request_id: type: string description: ID truy vết yêu cầu response_url: type: string description: URL truy vấn kết quả status: type: string description: Trạng thái status_url: type: string description: URL truy vấn trạng thái refName: PostFalAiFlux1DevResponse x-apifox-orders: - cancel_url - logs - metrics - queue_position - request_id - response_url - status - status_url x-apidog-orders: - cancel_url - logs - metrics - queue_position - request_id - response_url - status - status_url examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/cancel logs: [] metrics: {} queue_position: 0 request_id: 3892f1e8-5fb1-469f-87b0-696d6054c9f2 response_url: >- https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208900-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-1/dev/image-to-image" Nguồn: https://docs.openaihub.net/api-45208901/ > 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: /fal-ai/flux-1/dev/image-to-image: post: summary: /fal-ai/flux-1/dev/image-to-image deprecated: false description: >- Tài liệu chính thức: https://fal.ai/models/fal-ai/flux-1/dev/image-to-image operationId: post-fal-ai-flux-1-dev-image-to-image tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - fal-ai parameters: [] requestBody: content: application/json: schema: type: object required: - image_url - prompt properties: acceleration: type: string description: >- Tốc độ tạo. Giá trị cao hơn thì nhanh hơn. Mặc định: "regular". Được hỗ trợ: default, none, regular, high enable_safety_checker: type: boolean description: Có bật bộ kiểm tra an toàn hay không guidance_scale: type: number description: >- Thang CFG (hướng dẫn không cần bộ phân loại): mức độ bám sát lời nhắc. Mặc định: 3.5. Phạm vi: 1–20 image_url: type: string description: >- Thả một tệp vào đây hoặc cung cấp URL dữ liệu base64. Định dạng được chấp nhận: jpg, jpeg, png, webp, gif, avif num_images: type: integer description: 'Số lượng hình ảnh cần tạo. Mặc định: 1. Phạm vi: 1–4' num_inference_steps: type: integer description: 'Số bước suy luận. Mặc định: 40. Phạm vi: 10–50' output_format: type: string description: >- Định dạng ảnh đầu ra. Mặc định: "jpeg". Được hỗ trợ: default, png, jpeg prompt: type: string description: Câu lệnh tạo hình ảnh strength: type: number description: >- Mức độ ảnh hưởng của ảnh ban đầu. Giá trị cao hơn sẽ phụ thuộc nhiều hơn vào mô hình. Mặc định: 0.95. Phạm vi: 0.01–1 x-apifox-orders: - acceleration - enable_safety_checker - guidance_scale - image_url - num_images - num_inference_steps - output_format - prompt - strength x-apidog-orders: - acceleration - enable_safety_checker - guidance_scale - image_url - num_images - num_inference_steps - output_format - prompt - strength examples: example: value: acceleration: thông thường enable_safety_checker: true guidance_scale: 3.5 image_url: >- 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. num_images: 1 num_inference_steps: 40 output_format: jpeg prompt: >- Một chú mèo mặc trang phục phù thủy với khu rừng huyền bí làm nền. strength: 0.95 summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel metrics: {} queue_position: 0 request_id: acf05732-7cb3-445b-9f39-fdaeccb1d730 response_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208901-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-1/dev/redux" Nguồn: https://docs.openaihub.net/api-45208902/ > 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: /fal-ai/flux-1/dev/redux: post: summary: /fal-ai/flux-1/dev/redux deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL này: https://fal.ai/models/fal-ai/flux-1/dev/redux operationId: fal_ai_fal_ai_flux_1_dev_redux tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - image_url properties: acceleration: type: string description: >- Tốc độ tạo. Tốc độ càng cao thì quá trình dựng càng nhanh. Giá trị mặc định: "regular"; hỗ trợ các giá trị default, none, regular và high enable_safety_checker: type: boolean description: >- Nếu được đặt thành `true`, trình kiểm tra bảo mật sẽ được bật. Giá trị mặc định: `true` guidance_scale: type: number description: >- Thang CFG (Classifier Free Guidance) đo mức độ bạn muốn mô hình bám sát các gợi ý khi tìm hình ảnh phù hợp. Giá trị mặc định: 3.5 Phạm vi giá trị: 1-20 image_size: type: string description: >- Kích thước của hình ảnh được tạo. Mặc định: landscape_4_3, phạm vi (3:4, 4:3, 16:9, 9:16) image_url: type: string description: >- Kéo và thả tệp vào đây, hoặc cung cấp URL dữ liệu được mã hóa base64 Các loại tệp được chấp nhận: jpg, jpeg, png, webp, gif, avif num_images: type: integer description: >- Số lượng hình ảnh được tạo. Giá trị mặc định: 1 Giá trị trong khoảng 1-4 num_inference_steps: type: integer description: >- Số bước suy luận cần thực hiện. Giá trị mặc định: 28 Giá trị trong khoảng: 1-50 output_format: type: string description: >- Định dạng của hình ảnh được tạo. Giá trị mặc định: "jpeg". Hỗ trợ: default, png, jpeg refName: PostFalAiFlux1DevReduxRequest x-apifox-orders: - acceleration - enable_safety_checker - guidance_scale - image_size - image_url - num_images - num_inference_steps - output_format x-apidog-orders: - acceleration - enable_safety_checker - guidance_scale - image_size - image_url - num_images - num_inference_steps - output_format examples: fal_aiflux_1devredux_single: value: acceleration: thông thường enable_safety_checker: true guidance_scale: 3.5 image_size: landscape_4_3 image_url: https://fal.media/files/kangaroo/acQvq-Kmo2lajkgvcEHdv.png num_images: 1 num_inference_steps: 28 output_format: jpeg summary: fal_aiflux_1devredux_single description: /fal-ai/flux-1/dev/redux responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel logs: [] metrics: {} queue_position: 0 request_id: acf05732-7cb3-445b-9f39-fdaeccb1d730 response_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208902-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-1/schnell/redux" Nguồn: https://docs.openaihub.net/api-45208903/ > 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: /fal-ai/flux-1/schnell/redux: post: summary: /fal-ai/flux-1/schnell/redux deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL này trong phiên hiện tại. operationId: fal_ai_fal_ai_flux_1_schnell_redux tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - image_url properties: acceleration: type: string description: >- Tốc độ tạo. Tốc độ càng cao thì quá trình dựng càng nhanh. Giá trị mặc định: "regular"; hỗ trợ các giá trị default, none, regular và high enable_safety_checker: type: boolean description: >- Nếu được đặt thành `true`, trình kiểm tra bảo mật sẽ được bật. Giá trị mặc định: `true` image_size: type: string description: >- Kích thước của hình ảnh được tạo. Mặc định: landscape_4_3, phạm vi (3:4, 4:3, 16:9, 9:16) image_url: type: string description: >- Kéo và thả tệp vào đây, hoặc cung cấp URL dữ liệu được mã hóa base64 Các loại tệp được chấp nhận: jpg, jpeg, png, webp, gif, avif num_images: type: integer description: >- Số lượng hình ảnh được tạo. Giá trị mặc định: 1 Giá trị trong khoảng 1-4 num_inference_steps: type: integer description: >- Số bước suy luận cần thực hiện. Giá trị mặc định: 4 Giá trị trong khoảng: 1-12 output_format: type: string description: >- Định dạng của hình ảnh được tạo. Giá trị mặc định: "jpeg". Hỗ trợ: default, png, jpeg refName: PostFalAiFlux1SchnellReduxRequest x-apifox-orders: - acceleration - enable_safety_checker - image_size - image_url - num_images - num_inference_steps - output_format x-apidog-orders: - acceleration - enable_safety_checker - image_size - image_url - num_images - num_inference_steps - output_format examples: fal_aiflux_1schnellredux_single: value: acceleration: thông thường enable_safety_checker: true image_size: landscape_4_3 image_url: https://fal.media/files/kangaroo/acQvq-Kmo2lajkgvcEHdv.png num_images: 1 num_inference_steps: 4 output_format: jpeg summary: fal_aiflux_1schnellredux_single description: /fal-ai/flux-1/schnell/redux responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel logs: [] metrics: {} queue_position: 0 request_id: acf05732-7cb3-445b-9f39-fdaeccb1d730 response_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208903-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-pro/kontext" Nguồn: https://docs.openaihub.net/api-45208904/ > 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: /fal-ai/flux-pro/kontext: post: summary: /fal-ai/flux-pro/kontext deprecated: false description: 'Tài liệu chính thức: https://fal.ai/models/fal-ai/flux-pro/kontext' operationId: fal_ai_fal_ai_flux_pro_kontext tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_url properties: guidance_scale: type: number description: >- Thang CFG (Dẫn hướng không dùng bộ phân loại) là thước đo mức độ bạn muốn mô hình bám sát các gợi ý khi tìm hình ảnh liên quan. Giá trị mặc định: 3.5 Phạm vi giá trị: 1-20 image_url: type: string description: >- Kéo và thả tệp vào đây, hoặc cung cấp URL dữ liệu được mã hóa base64 Các loại tệp được chấp nhận: jpg, jpeg, png, webp, gif, avif num_images: type: integer description: >- Số lượng hình ảnh được tạo. Giá trị mặc định: 1 Giá trị trong khoảng 1-4 output_format: type: string description: >- Định dạng của hình ảnh được tạo. Giá trị mặc định: "jpeg". Hỗ trợ: default, png, jpeg prompt: type: string description: Mẹo tạo hình ảnh safety_tolerance: type: string description: >- Mức độ dung sai an toàn của hình ảnh được tạo. 1 là nghiêm ngặt nhất và 5 là ít nghiêm ngặt nhất. Giá trị mặc định: "2" refName: PostFalAiFluxProKontextRequest x-apifox-orders: - guidance_scale - image_url - num_images - output_format - prompt - safety_tolerance x-apidog-orders: - guidance_scale - image_url - num_images - output_format - prompt - safety_tolerance examples: fal_aiflux_prokontext_single: value: guidance_scale: 3.5 image_url: >- https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png num_images: 1 output_format: jpeg prompt: Đặt một chiếc bánh vòng cạnh bột mì. safety_tolerance: '2' summary: fal_aiflux_prokontext_single description: /fal-ai/flux-pro/kontext responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel logs: [] metrics: {} queue_position: 0 request_id: acf05732-7cb3-445b-9f39-fdaeccb1d730 response_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208904-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-pro/kontext/text-to-image" Nguồn: https://docs.openaihub.net/api-45208905/ > 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: /fal-ai/flux-pro/kontext/text-to-image: post: summary: /fal-ai/flux-pro/kontext/text-to-image deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch vào đây. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp. Tôi sẽ 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. operationId: fal_ai_fal_ai_flux_pro_kontext_text_to_image tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Giá trị mặc định: "1:1". Hỗ trợ: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21 guidance_scale: type: number description: >- Thang CFG (Dẫn hướng không dùng bộ phân loại) là thước đo mức độ bạn muốn mô hình bám sát các gợi ý khi tìm hình ảnh liên quan. Giá trị mặc định: 3.5 Phạm vi giá trị: 1-20 num_images: type: integer description: >- Số lượng hình ảnh được tạo. Giá trị mặc định: 1 Giá trị trong khoảng 1-4 output_format: type: string description: >- Định dạng của hình ảnh được tạo. Giá trị mặc định: "jpeg". Hỗ trợ: default, png, jpeg prompt: type: string description: Mẹo tạo hình ảnh. safety_tolerance: type: string description: >- Mức độ dung sai an toàn của hình ảnh được tạo. 1 là nghiêm ngặt nhất và 5 là ít nghiêm ngặt nhất. Giá trị mặc định: "2" refName: PostFalAiFluxProKontextTextToImageRequest x-apifox-orders: - aspect_ratio - guidance_scale - num_images - output_format - prompt - safety_tolerance x-apidog-orders: - aspect_ratio - guidance_scale - num_images - output_format - prompt - safety_tolerance examples: fal_aiflux_prokontexttext_to_image_single: value: aspect_ratio: '1:1' guidance_scale: 3.5 num_images: 1 output_format: jpeg prompt: >- Cảnh cực cận của một mắt hổ duy nhất, nhìn thẳng từ chính diện. Mống mắt và đồng tử chi tiết. Lấy nét sắc nét vào kết cấu và màu sắc của mắt. Ánh sáng tự nhiên làm nổi bật độ long lanh và chiều sâu chân thực của mắt. Từ "FLUX" được vẽ đè lên trên bằng những nét cọ lớn màu trắng, với kết cấu hiện rõ. safety_tolerance: '2' summary: fal_aiflux_prokontexttext_to_image_single description: /fal-ai/flux-pro/kontext/text-to-image responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel logs: [] metrics: {} queue_position: 0 request_id: acf05732-7cb3-445b-9f39-fdaeccb1d730 response_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208905-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-pro/kontext/max" Nguồn: https://docs.openaihub.net/api-45208906/ > 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: /fal-ai/flux-pro/kontext/max: post: summary: /fal-ai/flux-pro/kontext/max deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL này, nhưng tôi có thể dịch toàn bộ sang tiếng Việt đồ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. operationId: fal_ai_fal_ai_flux_pro_kontext_max tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - output_format - image_url properties: aspect_ratio: type: string description: >- Kích thước hình ảnh, các giá trị liệt kê: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21 guidance_scale: type: number description: 'Giá trị phạm vi: 1-20' image_url: type: string description: URL hình ảnh num_images: type: integer description: 'Số lượng hình ảnh đầu ra, phạm vi giá trị: 1-4' output_format: type: string description: 'Định dạng đầu ra của hình ảnh: "jpeg", "png"' prompt: type: string description: từ trong lời nhắc safety_tolerance: type: string description: dung sai an toàn 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 sync_mode: type: boolean description: chế độ đồng bộ refName: PostFalAiFluxProKontextMaxRequest x-apifox-orders: - aspect_ratio - guidance_scale - image_url - num_images - output_format - prompt - safety_tolerance - seed - sync_mode x-apidog-orders: - aspect_ratio - guidance_scale - image_url - num_images - output_format - prompt - safety_tolerance - seed - sync_mode examples: fal_aiflux_prokontextmax_single: value: aspect_ratio: chuỗi guidance_scale: 3.5 image_url: >- https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png num_images: 1 output_format: jpeg prompt: Đặt một chiếc bánh vòng cạnh bột mì. safety_tolerance: '2' seed: 0 sync_mode: false summary: fal_aiflux_prokontextmax_single description: /fal-ai/flux-pro/kontext/max responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/e36fc67f-afa7-416a-a288-50d90a630d7a/cancel logs: [] metrics: {} queue_position: 0 request_id: e36fc67f-afa7-416a-a288-50d90a630d7a response_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/e36fc67f-afa7-416a-a288-50d90a630d7a status: IN_QUEUE status_url: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp URL này. 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208906-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-pro/kontext/max/multi" Nguồn: https://docs.openaihub.net/api-45208907/ > 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: /fal-ai/flux-pro/kontext/max/multi: post: summary: /fal-ai/flux-pro/kontext/max/multi deprecated: false description: >- Tài liệu chính thức: https://fal.ai/models/fal-ai/flux-pro/kontext/max/multi operationId: fal_ai_fal_ai_flux_pro_kontext_max_multi tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_urls properties: guidance_scale: type: number description: 'Giá trị phạm vi: 1-20' image_urls: type: array items: type: string description: URL hình ảnh num_images: type: integer description: 'Số lượng hình ảnh được tạo, phạm vi: 1-4' output_format: type: string description: 'Định dạng đầu ra của hình ảnh: "jpeg", "png"' prompt: type: string description: từ trong lời nhắc safety_tolerance: type: string description: dung sai an toàn refName: PostFalAiFluxProKontextMaxMultiRequest x-apifox-orders: - guidance_scale - image_urls - num_images - output_format - prompt - safety_tolerance x-apidog-orders: - guidance_scale - image_urls - num_images - output_format - prompt - safety_tolerance examples: fal_aiflux_prokontextmaxmulti_single: value: guidance_scale: 3.5 image_urls: - >- https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp - >- Vui lòng tải hình ảnh lên trực tiếp để tôi có thể đọc và dịch nội dung. num_images: 1 output_format: jpeg prompt: Đặt chú vịt con nhỏ lên phía trên áo thun của người phụ nữ. safety_tolerance: '2' summary: fal_aiflux_prokontextmaxmulti_single description: /fal-ai/flux-pro/kontext/max/multi responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/30bc4aeb-0543-4198-929c-da97da4d14c9/cancel logs: [] metrics: {} queue_position: 0 request_id: 30bc4aeb-0543-4198-929c-da97da4d14c9 response_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/30bc4aeb-0543-4198-929c-da97da4d14c9 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/30bc4aeb-0543-4198-929c-da97da4d14c9/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208907-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/wan/v2.2-a14b/image-to-image" Nguồn: https://docs.openaihub.net/api-45208908/ > 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: /fal-ai/wan/v2.2-a14b/image-to-image: post: summary: /fal-ai/wan/v2.2-a14b/image-to-image deprecated: false description: >- Vui lòng dán nội dung tài liệu Markdown cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp. operationId: fal_ai_fal_ai_wan_v2_2_a14b_image_to_image tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - image_url - prompt properties: acceleration: type: string description: >- Tốc độ tạo hình ảnh, giá trị liệt kê: "thông thường", "không có" aspect_ratio: type: string description: Kích thước hình ảnh enable_prompt_expansion: type: boolean description: Bật phần mở rộng lời nhắc enable_safety_checker: type: boolean description: 'Bật các kiểm tra bảo mật, giá trị mặc định: true' guidance_scale: type: number description: 'Giá trị phạm vi: 1-10' guidance_scale_2: type: integer description: 'Giá trị phạm vi: 1-10' image_format: type: string description: 'Định dạng đầu ra của hình ảnh: "jpeg", "png"' image_url: type: string description: URL hình ảnh num_inference_steps: type: integer description: 'Giá trị phạm vi: 2-40' prompt: type: string description: từ trong lời nhắc shift: type: integer description: 'Giá trị phạm vi: 1-10' strength: type: number description: 'Độ mạnh, phạm vi giá trị: 0-1' refName: PostFalAiWanV22A14bImageToImageRequest x-apifox-orders: - acceleration - aspect_ratio - enable_prompt_expansion - enable_safety_checker - guidance_scale - guidance_scale_2 - image_format - image_url - num_inference_steps - prompt - shift - strength x-apidog-orders: - acceleration - aspect_ratio - enable_prompt_expansion - enable_safety_checker - guidance_scale - guidance_scale_2 - image_format - image_url - num_inference_steps - prompt - shift - strength examples: fal_aiwanv22_a14bimage_to_image_single: value: acceleration: thông thường aspect_ratio: tự động enable_prompt_expansion: false enable_safety_checker: true guidance_scale: 3.5 guidance_scale_2: 4 image_format: jpeg image_url: >- https://storage.googleapis.com/falserverless/example_inputs/wan-image-to-image-input.png num_inference_steps: 27 prompt: >- Một cảnh quay điện ảnh về một thành phố cổ lúc hoàng hôn, những tòa nhà bằng đá tinh xảo, ánh sáng vàng ấm áp shift: 2 strength: 0.5 summary: fal_aiwanv22_a14bimage_to_image_single description: /fal-ai/wan/v2.2-a14b/image-to-image responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/wan/requests/f88f1b41-b325-4f23-926b-da51481bf6c6/cancel logs: [] metrics: {} queue_position: 0 request_id: f88f1b41-b325-4f23-926b-da51481bf6c6 response_url: >- https://queue.fal.run/fal-ai/wan/requests/f88f1b41-b325-4f23-926b-da51481bf6c6 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/wan/requests/f88f1b41-b325-4f23-926b-da51481bf6c6/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208908-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/bytedance/seedream/v4/text-to-image" Nguồn: https://docs.openaihub.net/api-45208909/ > 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: /fal-ai/bytedance/seedream/v4/text-to-image: post: summary: /fal-ai/bytedance/seedream/v4/text-to-image deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL được cung cấp. operationId: fal_ai_fal_ai_bytedance_seedream_v4_text_to_image tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object x-apidog-orders: [] examples: fal_aibytedanceseedreamv4text_to_image_single: value: enable_safety_checker: true image_size: height: 1280 width: 1280 num_images: 1 prompt: >- Vẽ một biểu đồ thể hiện sự phân bố thảm thực vật điển hình ở bốn vùng khí hậu khác nhau: rừng mưa nhiệt đới, rừng ôn đới, sa mạc và lãnh nguyên. summary: fal_aibytedanceseedreamv4text_to_image_single description: /fal-ai/bytedance/seedream/v4/text-to-image responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel logs: [] metrics: {} queue_position: 0 request_id: acf05732-7cb3-445b-9f39-fdaeccb1d730 response_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208909-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/bytedance/seedream/v4/edit" Nguồn: https://docs.openaihub.net/api-45208910/ > 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: /fal-ai/bytedance/seedream/v4/edit: post: summary: /fal-ai/bytedance/seedream/v4/edit deprecated: false description: >- Tài liệu chính thức: https://fal.ai/models/fal-ai/bytedance/seedream/v4/edit operationId: fal_ai_fal_ai_bytedance_seedream_v4_edit tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_urls properties: enable_safety_checker: type: boolean description: 'Bật các kiểm tra bảo mật, giá trị mặc định: true' image_size: type: object required: - height - width properties: height: type: integer description: Chiều cao (pixel) width: type: integer description: Chiều rộng (pixel) description: >- Kích thước, chiều rộng và chiều cao của hình ảnh phải nằm trong khoảng: 1024-4096. x-apifox-orders: - height - width x-apidog-orders: - height - width image_urls: type: array items: type: string description: URL hình ảnh num_images: type: integer description: 'Số lượng ảnh được tạo: 1-6' prompt: type: string description: từ trong lời nhắc refName: PostFalAiBytedanceSeedreamV4EditRequest x-apifox-orders: - enable_safety_checker - image_size - image_urls - num_images - prompt x-apidog-orders: - enable_safety_checker - image_size - image_urls - num_images - prompt examples: fal_aibytedanceseedreamv4edit_single: value: enable_safety_checker: true image_size: height: 1280 width: 1280 image_urls: - >- https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_1.png - >- https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_2.png - >- https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_3.png - >- https://storage.googleapis.com/falserverless/example_inputs/seedream4_edit_input_4.png num_images: 1 prompt: Mặc quần áo và giày cho người mẫu. summary: fal_aibytedanceseedreamv4edit_single description: /fal-ai/bytedance/seedream/v4/edit responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/bytedance/requests/42a7eb80-8916-43ae-b27b-02e79f479977/cancel logs: [] metrics: {} queue_position: 0 request_id: 42a7eb80-8916-43ae-b27b-02e79f479977 response_url: >- https://queue.fal.run/fal-ai/bytedance/requests/42a7eb80-8916-43ae-b27b-02e79f479977 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/bytedance/requests/42a7eb80-8916-43ae-b27b-02e79f479977/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208910-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/vidu/reference-to-image" Nguồn: https://docs.openaihub.net/api-45208911/ > 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: /fal-ai/vidu/reference-to-image: post: summary: /fal-ai/vidu/reference-to-image deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch vào đây. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp. operationId: fal_ai_fal_ai_vidu_reference_to_image tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - reference_image_urls properties: aspect_ratio: type: string description: 'Tỷ lệ hình ảnh, các giá trị liệt kê: 1:1, 16:9, 9:16' prompt: type: string description: từ trong lời nhắc reference_image_urls: type: array items: type: string description: URL hình ảnh tham khảo refName: PostFalAiViduReferenceToImageRequest x-apifox-orders: - aspect_ratio - prompt - reference_image_urls x-apidog-orders: - aspect_ratio - prompt - reference_image_urls examples: fal_aividureference_to_image_single: value: aspect_ratio: '16:9' prompt: >- Con quỷ nhỏ đang nhìn quả táo trên bãi biển và đi vòng quanh nó. reference_image_urls: - >- https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference1.png - >- https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference2.png - >- https://storage.googleapis.com/falserverless/web-examples/vidu/new-examples/reference3.png summary: fal_aividureference_to_image_single description: /fal-ai/vidu/reference-to-image responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/vidu/requests/405a114e-04bd-463a-a98c-895502cfdce9/cancel logs: [] metrics: {} queue_position: 0 request_id: 405a114e-04bd-463a-a98c-895502cfdce9 response_url: >- Vui lòng dán nội dung tài liệu cần dịch vào đây vì tôi không thể truy cập trực tiếp đường dẫn này. status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/vidu/requests/405a114e-04bd-463a-a98c-895502cfdce9/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208911-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/imagen4/preview" Nguồn: https://docs.openaihub.net/api-45208912/ > 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: /fal-ai/imagen4/preview: post: summary: /fal-ai/imagen4/preview deprecated: false description: 'Tài liệu chính thức: https://fal.ai/models/fal-ai/imagen4/preview' operationId: post-fal-ai-imagen4-preview tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - fal-ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình. Kiểu liệt kê: 1:1, 16:9, 9:16, 3:4, 4:3' num_images: type: integer description: 'Số lượng hình ảnh cần tạo. Phạm vi: 1–4' prompt: type: string description: Lời nhắc resolution: type: string description: 'Độ phân giải. Kiểu liệt kê: "1K", "2K"' x-apifox-orders: - aspect_ratio - num_images - prompt - resolution x-apidog-orders: - aspect_ratio - num_images - prompt - resolution examples: example: value: aspect_ratio: '1:1' num_images: 1 prompt: >- Ghi lại một cảnh cận cảnh thân mật, ngập trong ánh nắng cuối buổi chiều ấm áp, dịu nhẹ, len vào một căn bếp đậm chất thập niên 1960. Tâm điểm là một gói bột mì đa dụng cổ điển có thiết kế duyên dáng, được đặt đầy mời gọi trên mặt bàn Formica lốm đốm. Bao bì gợi lên cảm giác hoài niệm thuần khiết: có thể làm từ giấy dày, hơi sần, mang tông kem ấm, được trang trí bằng kiểu chữ đơn giản, đậm nét (chữ có chân thân thiện hoặc chữ viết tay) với hai màu đỏ và xanh lam kinh điển, ghi “ALL-PURPOSE FLOUR”, cùng một hình minh họa thú vị như bó lúa mì cách điệu hoặc nhân vật thợ làm bánh vui vẻ. Ở phần cuối bao bì, bằng chữ in đậm nhỏ hơn: “NET WT 5 LBS (80 OZ) 2.27kg”. Lấy nét rõ vào các chi tiết của bao bì – các mép hơi mềm của túi giấy, kết cấu của kỹ thuật in cổ điển, dòng chữ "All-Purpose Flour" đầy cuốn hút. Những gợi ý tinh tế về căn bếp thập niên 1960 tạo khung cho cảnh chụp – viền crôm của mặt bàn ánh lên dịu nhẹ, một thoáng mờ của tấm ốp tường bằng gạch men màu vàng nhạt, hoặc góc của một bộ hộp đựng bằng kim loại cổ điển nằm ngay ngoài vùng nét. Độ sâu trường ảnh nông giữ sự chú ý tập trung hoàn toàn vào bao bì được thiết kế đẹp mắt, tạo nên một thẩm mỹ giàu sự ấm áp, chân thực và sức hấp dẫn hoài cổ. resolution: 1K summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/imagen4/requests/484ccb37-5477-44fe-8e75-6d6f6e9160b3/cancel metrics: {} queue_position: 0 request_id: 484ccb37-5477-44fe-8e75-6d6f6e9160b3 response_url: >- https://queue.fal.run/fal-ai/imagen4/requests/484ccb37-5477-44fe-8e75-6d6f6e9160b3 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/imagen4/requests/484ccb37-5477-44fe-8e75-6d6f6e9160b3/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208912-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/qwen-image-edit-lora" Nguồn: https://docs.openaihub.net/api-45208913/ > 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: /fal-ai/qwen-image-edit-lora: post: summary: /fal-ai/qwen-image-edit-lora deprecated: false description: '' operationId: post-fal-ai-qwen-image-edit-lora tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - fal-ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_url properties: acceleration: type: string description: 'Mức tăng tốc tạo hình ảnh. Enum: ''none'', ''regular'', ''high''' enable_safety_checker: type: boolean description: 'Bật trình kiểm tra an toàn. Mặc định: true' guidance_scale: type: integer description: 'Phạm vi: 2–100' image_url: type: string description: URL hình ảnh negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) num_images: type: integer description: 'Số lượng hình ảnh cần tạo. Phạm vi: 1–4' num_inference_steps: type: integer description: 'Phạm vi: 2–100' output_format: type: string description: 'Định dạng ảnh đầu ra: jpeg, png' prompt: type: string description: Lời nhắc x-apifox-orders: - acceleration - enable_safety_checker - guidance_scale - image_url - negative_prompt - num_images - num_inference_steps - output_format - prompt x-apidog-orders: - acceleration - enable_safety_checker - guidance_scale - image_url - negative_prompt - num_images - num_inference_steps - output_format - prompt examples: example: value: acceleration: thông thường enable_safety_checker: true guidance_scale: 4 image_url: >- Không thể truy cập nội dung hình ảnh từ URL được cung cấp. Vui lòng tải hình ảnh lên trực tiếp hoặc dán nội dung tài liệu cần dịch. negative_prompt: mờ, xấu num_images: 1 num_inference_steps: 30 output_format: png prompt: Đổi túi thành Apple MacBook summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: request_id: req_example status: OK 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208913-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/qwen-image-edit-plus" Nguồn: https://docs.openaihub.net/api-45208914/ > 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: /fal-ai/qwen-image-edit-plus: post: summary: /fal-ai/qwen-image-edit-plus deprecated: false description: 'Tài liệu chính thức: https://fal.ai/models/fal-ai/qwen-image-edit-plus' operationId: post-fal-ai-qwen-image-edit-plus tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - fal-ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_urls properties: enable_safety_checker: type: boolean description: 'Bật trình kiểm tra an toàn. Mặc định: true' guidance_scale: type: integer description: 'Phạm vi: 0–20' image_size: type: string description: >- Enum kích thước hình ảnh: square、square_hd、landscape_4_3、landscape_16_9、portrait_3_4、portrait_9_16 image_urls: type: array items: type: string description: URL hình ảnh negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) num_images: type: integer description: 'Số lượng hình ảnh cần tạo. Phạm vi: 1–4' num_inference_steps: type: integer description: 'Phạm vi: 2–100' output_format: type: string description: 'Định dạng ảnh đầu ra: jpeg, png' prompt: type: string description: Lời nhắc. x-apifox-orders: - enable_safety_checker - guidance_scale - image_size - image_urls - negative_prompt - num_images - num_inference_steps - output_format - prompt x-apidog-orders: - enable_safety_checker - guidance_scale - image_size - image_urls - negative_prompt - num_images - num_inference_steps - output_format - prompt examples: example: value: enable_safety_checker: true guidance_scale: 4 image_size: square_hd image_urls: - >- Vui lòng tải ảnh lên trực tiếp để tôi có thể đọc và dịch nội dung. - >- https://v3.fal.media/files/penguin/BCOZp6teRhSQFuOXpbBOa_da8ef9b4982347a2a62a516b737d4f21.png - >- Vui lòng tải ảnh trực tiếp lên cuộc trò chuyện hoặc dán nội dung tài liệu cần dịch. Tôi không thể đọc nội dung ảnh chỉ từ URL này. negative_prompt: mờ, xấu num_images: 1 num_inference_steps: 50 output_format: png prompt: >- Chân dung cận cảnh một người phụ nữ đứng trước chiếc xe này trên đường cao tốc này summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/qwen-image-edit-plus/requests/9c08e7d8-312c-402d-a691-c207a9cb8121/cancel metrics: {} queue_position: 0 request_id: 9c08e7d8-312c-402d-a691-c207a9cb8121 response_url: >- https://queue.fal.run/fal-ai/qwen-image-edit-plus/requests/9c08e7d8-312c-402d-a691-c207a9cb8121 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/qwen-image-edit-plus/requests/9c08e7d8-312c-402d-a691-c207a9cb8121/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208914-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/kling-video/v2.5-turbo/pro/text-to-video" Nguồn: https://docs.openaihub.net/api-45208915/ > 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: /fal-ai/kling-video/v2.5-turbo/pro/text-to-video: post: summary: /fal-ai/kling-video/v2.5-turbo/pro/text-to-video deprecated: false description: '' operationId: post-fal-ai-kling-video-v2-5-turbo-pro-text-to-video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - fal-ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt properties: aspect_ratio: type: string description: 'Kiểu liệt kê tỷ lệ khung hình video: 16:9, 9:16, 1:1' cfg_scale: type: number description: 'Phạm vi: 0–1' duration: type: string description: 'Gia tri liet ke thoi luong video duoc tao: 5, 10' negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Câu lệnh tạo video. x-apifox-orders: - aspect_ratio - cfg_scale - duration - negative_prompt - prompt x-apidog-orders: - aspect_ratio - cfg_scale - duration - negative_prompt - prompt examples: example: value: aspect_ratio: '16:9' cfg_scale: 0.5 duration: '5' negative_prompt: mờ, biến dạng và chất lượng thấp prompt: >- Một vị lãnh chúa cao quý bước đi giữa thần dân của mình, sự hiện diện của ngài mang lại cảm giác an tâm và ấm áp. Ngài chào đón họ bằng một nụ cười hiền hòa, hiện thân cho những hy vọng của họ và giành được sự kính trọng qua những tương tác giản dị. Bầu không khí gần gũi và chân thành, làm nổi bật mối gắn kết giữa người lãnh đạo và cộng đồng. summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: request_id: req_example status: OK 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208915-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/kling-video/v2.5-turbo/pro/image-to-video" Nguồn: https://docs.openaihub.net/api-45208916/ > 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: /fal-ai/kling-video/v2.5-turbo/pro/image-to-video: post: summary: /fal-ai/kling-video/v2.5-turbo/pro/image-to-video deprecated: false description: >- Tài liệu chính thức: https://fal.ai/models/fal-ai/kling-video/v2.5-turbo/pro/image-to-video operationId: post-fal-ai-kling-video-v2-5-turbo-pro-image-to-video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - fal-ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_url properties: cfg_scale: type: number description: 'Phạm vi: 0–1' duration: type: string description: 'Gia tri liet ke thoi luong video duoc tao: 5, 10' image_url: type: string description: 'URL hình ảnh; chấp nhận: jpg, jpeg, png, webp, gif, avif' negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Lời nhắc x-apifox-orders: - cfg_scale - duration - image_url - negative_prompt - prompt x-apidog-orders: - cfg_scale - duration - image_url - negative_prompt - prompt examples: example: value: cfg_scale: 0.5 duration: '5' image_url: >- https://v3.fal.media/files/panda/HnY2yf-BbzlrVQxR-qP6m_9912d0932988453aadf3912fc1901f52.jpg negative_prompt: mờ, biến dạng và chất lượng thấp prompt: >- Một vạch xuất phát nổi bật phân chia hai chiếc xe mạnh mẽ, động cơ gầm vang trước thử thách phía trước. Chúng lao vút lên trong sức nóng của cuộc tranh tài, hòa thành một dải tốc độ và ánh crôm nhòe đi. Vạch đích hiện ra trước mắt khi cả hai quyết liệt tranh giành chiến thắng. summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/kling-video/requests/727028ec-aa98-4073-9bcd-0acb386abcfc/cancel metrics: {} queue_position: 0 request_id: 727028ec-aa98-4073-9bcd-0acb386abcfc response_url: >- https://queue.fal.run/fal-ai/kling-video/requests/727028ec-aa98-4073-9bcd-0acb386abcfc status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/kling-video/requests/727028ec-aa98-4073-9bcd-0acb386abcfc/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208916-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-lora" Nguồn: https://docs.openaihub.net/api-45208917/ > 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: /fal-ai/flux-lora: post: summary: /fal-ai/flux-lora deprecated: false description: 'Tài liệu chính thức: https://fal.ai/models/fal-ai/flux-lora' operationId: post-fal-ai-flux-lora tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - fal-ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt properties: enable_safety_checker: type: boolean description: 'Bật trình kiểm tra an toàn. Mặc định: true' guidance_scale: type: number description: 'Phạm vi: 0–35' image_size: type: string description: >- Kiểu liệt kê kích thước hình ảnh: square、square pro、landscape_4_3、landscape_16_9、portrait_3_4 num_images: type: integer description: Số lượng hình ảnh, phạm vi 1–4 num_inference_steps: type: integer description: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật trong phạm vi 1–50 để tôi dịch sang tiếng Việt. output_format: type: string description: 'Định dạng ảnh đầu ra: jpeg, png' prompt: type: string description: Lời nhắc x-apifox-orders: - enable_safety_checker - guidance_scale - image_size - num_images - num_inference_steps - output_format - prompt x-apidog-orders: - enable_safety_checker - guidance_scale - image_size - num_images - num_inference_steps - output_format - prompt examples: example: value: enable_safety_checker: true guidance_scale: 3.5 image_size: landscape_4_3 num_images: 1 num_inference_steps: 28 output_format: jpeg prompt: >- Cảnh cực cận của một mắt hổ duy nhất, nhìn thẳng từ chính diện. Mống mắt và đồng tử chi tiết. Lấy nét sắc nét vào kết cấu và màu sắc của mắt. Ánh sáng tự nhiên làm nổi bật độ long lanh và chiều sâu chân thực của mắt. Từ "FLUX" được vẽ đè lên trên bằng những nét cọ lớn màu trắng, với kết cấu hiện rõ. summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-lora/requests/07e0be22-3380-4699-a377-48729443435c/cancel metrics: {} queue_position: 0 request_id: 07e0be22-3380-4699-a377-48729443435c response_url: >- https://queue.fal.run/fal-ai/flux-lora/requests/07e0be22-3380-4699-a377-48729443435c status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-lora/requests/07e0be22-3380-4699-a377-48729443435c/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208917-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-lora/image-to-image" Nguồn: https://docs.openaihub.net/api-45208918/ > 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: /fal-ai/flux-lora/image-to-image: post: summary: /fal-ai/flux-lora/image-to-image deprecated: false description: >- Tài liệu chính thức: https://fal.ai/models/fal-ai/flux-lora/image-to-image operationId: post-fal-ai-flux-lora-image-to-image tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - fal-ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_url properties: enable_safety_checker: type: boolean description: 'Bật trình kiểm tra an toàn. Mặc định: true' guidance_scale: type: number description: 'Phạm vi: 0–35' image_url: type: string description: 'URL hình ảnh; chấp nhận: jpg, jpeg, png, webp, gif, avif' num_images: type: integer description: Số lượng hình ảnh, phạm vi 1–4 num_inference_steps: type: integer description: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật trong phạm vi 1–50 để tôi dịch sang tiếng Việt. output_format: type: string description: 'Định dạng ảnh đầu ra: jpeg, png' prompt: type: string description: Lời nhắc strength: type: number description: độ mạnh, phạm vi 0.01–1 x-apifox-orders: - enable_safety_checker - guidance_scale - image_url - num_images - num_inference_steps - output_format - prompt - strength x-apidog-orders: - enable_safety_checker - guidance_scale - image_url - num_images - num_inference_steps - output_format - prompt - strength examples: example: value: enable_safety_checker: true guidance_scale: 3.5 image_url: >- https://storage.googleapis.com/falserverless/example_inputs/dog.png num_images: 1 num_inference_steps: 28 output_format: jpeg prompt: >- Một bức ảnh chụp một con sư tử đang ngồi trên một băng ghế đá strength: 0.85 summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/flux-lora/requests/9b54828d-3c2b-4e0e-ac8c-ac234504015e/cancel metrics: {} queue_position: 0 request_id: 9b54828d-3c2b-4e0e-ac8c-ac234504015e response_url: >- https://queue.fal.run/fal-ai/flux-lora/requests/9b54828d-3c2b-4e0e-ac8c-ac234504015e status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-lora/requests/9b54828d-3c2b-4e0e-ac8c-ac234504015e/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208918-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/flux-lora/inpainting" Nguồn: https://docs.openaihub.net/api-45208919/ > 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: /fal-ai/flux-lora/inpainting: post: summary: /fal-ai/flux-lora/inpainting deprecated: false description: 'Tài liệu chính thức: https://fal.ai/models/fal-ai/flux-lora/inpainting' operationId: post-fal-ai-flux-lora-inpainting tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai - fal-ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_url - mask_url properties: enable_safety_checker: type: boolean description: 'Bật trình kiểm tra an toàn. Mặc định: true' guidance_scale: type: number description: 'Phạm vi: 0–35' image_url: type: string description: 'URL hình ảnh; chấp nhận: jpg, jpeg, png, webp, gif, avif' mask_url: type: string description: >- URL mặt nạ; định dạng được chấp nhận: jpg, jpeg, png, webp, gif, avif num_images: type: integer description: Số lượng hình ảnh, phạm vi 1–4 num_inference_steps: type: integer description: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật trong phạm vi 1–50 để tôi dịch sang tiếng Việt. output_format: type: string description: 'Định dạng ảnh đầu ra: jpeg, png' prompt: type: string description: Lời nhắc strength: type: number description: độ mạnh, phạm vi 0.01–1 x-apifox-orders: - enable_safety_checker - guidance_scale - image_url - mask_url - num_images - num_inference_steps - output_format - prompt - strength x-apidog-orders: - enable_safety_checker - guidance_scale - image_url - mask_url - num_images - num_inference_steps - output_format - prompt - strength examples: example: value: enable_safety_checker: true guidance_scale: 3.5 image_url: >- https://storage.googleapis.com/falserverless/example_inputs/dog.png mask_url: >- https://storage.googleapis.com/falserverless/example_inputs/dog_mask.png num_images: 1 num_inference_steps: 28 output_format: jpeg prompt: >- Một bức ảnh chụp một con sư tử đang ngồi trên một băng ghế đá strength: 0.85 summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: '1': summary: '1' value: cancel_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel metrics: {} queue_position: 0 request_id: acf05732-7cb3-445b-9f39-fdaeccb1d730 response_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status '2': summary: '2' value: cancel_url: >- https://queue.fal.run/fal-ai/flux-lora/requests/72a35804-b407-4b09-894b-3a35559c38f9/cancel metrics: {} queue_position: 0 request_id: 72a35804-b407-4b09-894b-3a35559c38f9 response_url: >- https://queue.fal.run/fal-ai/flux-lora/requests/72a35804-b407-4b09-894b-3a35559c38f9 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/flux-lora/requests/72a35804-b407-4b09-894b-3a35559c38f9/status 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/Hình ảnh/Fal.ai x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208919-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/veo3" Nguồn: https://docs.openaihub.net/api-45208920/ > 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: /fal-ai/veo3: post: summary: /fal-ai/veo3 deprecated: false description: 'Địa chỉ tài liệu chính thức: https://fal.ai/models/fal-ai/veo3' operationId: fal_ai_fal_ai_veo3 tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai/falai-veo3 tạo video - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của video được tạo. Nếu đặt thành 1:1, video sẽ bị kéo giãn. Giá trị mặc định: "16:9", phạm vi [16:9,9:16,1:1] auto_fix: type: boolean description: >- Có tự động thử sửa các câu lệnh không đáp ứng chính sách nội dung hoặc các bước kiểm tra tính hợp lệ khác bằng cách viết lại hay không. Mặc định: true duration: type: string description: >- Thời lượng của video được tạo (tính bằng giây) Giá trị mặc định: "8s" enhance_prompt: type: boolean description: >- Có tăng cường quá trình tạo video hay không. Giá trị mặc định: true generate_audio: type: boolean description: >- Có tạo âm thanh cho video hay không. Nếu là false, số điểm sẽ giảm %33. Giá trị mặc định: true prompt: type: string description: Lời nhắc văn bản resolution: type: string description: >- Độ phân giải mặc định của video được tạo: "720p" Phạm vi giá trị [720p, 1080p] refName: PostFalAiVeo3Request x-apifox-orders: - aspect_ratio - auto_fix - duration - enhance_prompt - generate_audio - prompt - resolution x-apidog-orders: - aspect_ratio - auto_fix - duration - enhance_prompt - generate_audio - prompt - resolution examples: fal_aiveo3_single: value: aspect_ratio: '16:9' auto_fix: true duration: 8s enhance_prompt: true generate_audio: true prompt: >- Một cuộc phỏng vấn đường phố tự nhiên trên vỉa hè đông đúc ở Thành phố New York vào buổi chiều. Người phỏng vấn cầm một chiếc micrô đơn giản, không có thương hiệu và hỏi: Bạn đã xem mô hình Veo3 mới của Google chưa? Đây là một mô hình cực kỳ tốt. Người được hỏi trả lời: Rồi, tôi đã xem, nó đã có sẵn trên fal. Nó tốt đến khó tin. resolution: 720p summary: fal_aiveo3_single description: /fal-ai/veo3 responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/veo3/requests/57b19308-8d3e-4196-b8bf-5ca80fa90827/cancel logs: [] metrics: {} queue_position: 0 request_id: 57b19308-8d3e-4196-b8bf-5ca80fa90827 response_url: >- https://queue.fal.run/fal-ai/veo3/requests/57b19308-8d3e-4196-b8bf-5ca80fa90827 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/veo3/requests/57b19308-8d3e-4196-b8bf-5ca80fa90827/status 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/Hình ảnh/Fal.ai/falai-veo3 tạo video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208920-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/veo3/fast/image-to-video" Nguồn: https://docs.openaihub.net/api-45208921/ > 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: /fal-ai/veo3/fast/image-to-video: post: summary: /fal-ai/veo3/fast/image-to-video deprecated: false description: >- Địa chỉ tài liệu chính thức: https://fal.ai/models/fal-ai/veo3/fast/image-to-video operationId: fal_ai_fal_ai_veo3_fast_image_to_video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai/falai-veo3 tạo video - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_url properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình mặc định cho video được tạo: "tự động"' duration: type: string description: >- Thời lượng của video được tạo (tính bằng giây) Giá trị mặc định: "8s" generate_audio: type: boolean description: >- Có tạo âm thanh cho video hay không. Nếu là false, số điểm sẽ giảm %33. Giá trị mặc định: true image_url: type: string description: >- URL của hình ảnh đầu vào cần tạo hiệu ứng chuyển động. Độ phân giải nên từ 720p trở lên, với tỷ lệ khung hình 16:9. Nếu tỷ lệ khung hình của hình ảnh không phải là 16:9, hình ảnh sẽ được cắt để vừa khung. prompt: type: string description: >- Một gợi ý bằng văn bản mô tả cách hình ảnh nên được tạo hiệu ứng chuyển động resolution: type: string description: >- Độ phân giải mặc định của video được tạo: "720p" Phạm vi giá trị [720p, 1080p] refName: PostFalAiVeo3FastImageToVideoRequest x-apifox-orders: - aspect_ratio - duration - generate_audio - image_url - prompt - resolution x-apidog-orders: - aspect_ratio - duration - generate_audio - image_url - prompt - resolution examples: fal_aiveo3fastimage_to_video_single: value: aspect_ratio: '16:9' duration: 8s generate_audio: true image_url: >- https://storage.googleapis.com/falserverless/example_inputs/veo3-i2v-input.png prompt: >- Một phụ nữ nhìn vào máy quay, hít vào, rồi hào hứng thốt lên: "mọi người đã thử Veo3 Image-to-Video trên Fal chưa? Nó tuyệt vời lắm!" resolution: 720p summary: fal_aiveo3fastimage_to_video_single description: /fal-ai/veo3/fast/image-to-video responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/veo3/requests/1b24b3ae-16a2-4d19-b10d-1e323ebff061/cancel logs: [] metrics: {} queue_position: 0 request_id: 1b24b3ae-16a2-4d19-b10d-1e323ebff061 response_url: >- https://queue.fal.run/fal-ai/veo3/requests/1b24b3ae-16a2-4d19-b10d-1e323ebff061 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/veo3/requests/1b24b3ae-16a2-4d19-b10d-1e323ebff061/status 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/Hình ảnh/Fal.ai/falai-veo3 tạo video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208921-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/veo3/fast" Nguồn: https://docs.openaihub.net/api-45208922/ > 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: /fal-ai/veo3/fast: post: summary: /fal-ai/veo3/fast deprecated: false description: 'Địa chỉ tài liệu chính thức: https://fal.ai/models/fal-ai/veo3/fast' operationId: fal_ai_fal_ai_veo3_fast tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai/falai-veo3 tạo video - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của video được tạo. Nếu đặt thành 1:1, video sẽ bị kéo giãn. Giá trị mặc định: "16:9", phạm vi [16:9,9:16,1:1] auto_fix: type: boolean description: >- Có tự động thử sửa các câu lệnh không đáp ứng chính sách nội dung hoặc các bước kiểm tra tính hợp lệ khác bằng cách viết lại hay không. Mặc định: true duration: type: string description: >- Thời lượng của video được tạo (tính bằng giây) Giá trị mặc định: "8s" enhance_prompt: type: boolean description: >- Có tăng cường quá trình tạo video hay không. Giá trị mặc định: true generate_audio: type: boolean description: >- Có tạo âm thanh cho video hay không. Nếu là false, số điểm sẽ giảm %33. Giá trị mặc định: true prompt: type: string description: Một gợi ý bằng văn bản mô tả video cần tạo resolution: type: string description: >- Độ phân giải mặc định của video được tạo: "720p" Phạm vi giá trị [720p, 1080p] refName: PostFalAiVeo3FastRequest x-apifox-orders: - aspect_ratio - auto_fix - duration - enhance_prompt - generate_audio - prompt - resolution x-apidog-orders: - aspect_ratio - auto_fix - duration - enhance_prompt - generate_audio - prompt - resolution examples: fal_aiveo3fast_single: value: aspect_ratio: '16:9' auto_fix: true duration: 4s enhance_prompt: true generate_audio: false prompt: >- Một cuộc phỏng vấn đường phố tự nhiên trên vỉa hè đông đúc ở Thành phố New York vào buổi chiều. Người phỏng vấn cầm một chiếc micrô đơn giản, không có thương hiệu và hỏi: Bạn đã xem mô hình Veo3 mới của Google chưa? Đây là một mô hình cực kỳ tốt. Người được hỏi trả lời: Rồi, tôi đã xem, nó đã có sẵn trên fal. Nó tốt đến khó tin. resolution: 720p summary: fal_aiveo3fast_single description: /fal-ai/veo3/fast responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/veo3/requests/fabda298-3a7c-43f6-ba3a-2bde5b344173/cancel logs: [] metrics: {} queue_position: 0 request_id: fabda298-3a7c-43f6-ba3a-2bde5b344173 response_url: >- https://queue.fal.run/fal-ai/veo3/requests/fabda298-3a7c-43f6-ba3a-2bde5b344173 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/veo3/requests/fabda298-3a7c-43f6-ba3a-2bde5b344173/status 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/Hình ảnh/Fal.ai/falai-veo3 tạo video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208922-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/veo3/image-to-video" Nguồn: https://docs.openaihub.net/api-45208923/ > 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: /fal-ai/veo3/image-to-video: post: summary: /fal-ai/veo3/image-to-video deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ đường dẫn đã cung cấp. operationId: fal_ai_fal_ai_veo3_image_to_video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai/falai-veo3 tạo video - Fal.ai parameters: [] requestBody: content: application/json: schema: type: object required: - prompt - image_url properties: aspect_ratio: type: string description: >- Kích thước, giá trị liệt kê: 16:9, 9:16, auto, giá trị mặc định: "auto" duration: type: string description: 'Thời lượng video, giá trị mặc định: "8 giây"' generate_audio: type: boolean description: 'Tạo âm thanh, giá trị mặc định: true' image_url: type: string description: URL hình ảnh tham chiếu prompt: type: string description: từ trong lời nhắc resolution: type: string description: 'Độ phân giải, giá trị liệt kê: "720p", "1080p"' refName: PostFalAiVeo3ImageToVideoRequest x-apifox-orders: - aspect_ratio - duration - generate_audio - image_url - prompt - resolution x-apidog-orders: - aspect_ratio - duration - generate_audio - image_url - prompt - resolution examples: fal_aiveo3image_to_video_single: value: aspect_ratio: tự động duration: 8s generate_audio: true image_url: >- https://storage.googleapis.com/falserverless/example_inputs/veo3-i2v-input.png prompt: >- Một phụ nữ nhìn vào máy quay, hít vào, rồi hào hứng thốt lên: "mọi người đã thử Veo3 Image-to-Video trên Fal chưa? Nó tuyệt vời lắm!" resolution: 720p summary: fal_aiveo3image_to_video_single description: /fal-ai/veo3/image-to-video responses: '200': description: '' content: application/json: schema: type: object required: - status - request_id - response_url - status_url - cancel_url - logs - metrics - queue_position properties: cancel_url: type: string description: URL hủy tác vụ logs: type: array items: type: string description: Nhật ký chạy nullable: true metrics: type: object description: Số liệu chạy x-apidog-orders: [] queue_position: type: integer description: Vị trí trong hàng đợi request_id: type: string description: ID truy vết yêu cầu response_url: type: string description: URL truy vấn kết quả status: type: string description: Trạng thái status_url: type: string description: URL truy vấn trạng thái refName: PostFalAiVeo3ImageToVideoResponse x-apifox-orders: - cancel_url - logs - metrics - queue_position - request_id - response_url - status - status_url x-apidog-orders: - cancel_url - logs - metrics - queue_position - request_id - response_url - status - status_url examples: example: summary: example value: cancel_url: >- https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10/cancel logs: [] metrics: {} queue_position: 0 request_id: bcd3b436-b7af-42f3-8649-204657bfaf10 response_url: >- https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10 status: IN_QUEUE status_url: >- https://queue.fal.run/fal-ai/veo3/requests/bcd3b436-b7af-42f3-8649-204657bfaf10/status 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/Hình ảnh/Fal.ai/falai-veo3 tạo video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208923-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "/fal-ai/veo3/requests/{request_id}" Nguồn: https://docs.openaihub.net/api-45208924/ > 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: /fal-ai/veo3/requests/{request_id}: get: summary: /fal-ai/veo3/requests/{request_id} deprecated: false description: Truy vấn trạng thái và kết quả của tác vụ tạo video Veo3. operationId: fal_ai_fal_ai_veo3_requests tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai/falai-veo3 tạo video - Fal.ai parameters: - name: request_id in: path description: ID truy vết yêu cầu required: true example: 46d69eca-9cf3-475b-974d-8e8fc405cd67 schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: request_id: req_example status: OK 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/Hình ảnh/Fal.ai/falai-veo3 tạo video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208924-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-45208925/ > 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/Hình ảnh/Ảnh thô AIGC của Tencent - 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/Hình ảnh/Ảnh thô AIGC của Tencent x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208925-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-45208926/ > 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-image: post: summary: Tạo tác vụ deprecated: false description: >- Tạo ảnh theo yêu cầu trên Đám mây Tencent. Tài liệu chính thức: https://cloud.tencent.com/document/product/266/126240 operationId: tencent_vod_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ảnh thô AIGC của Tencent - 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 từ ngữ trong lời nhắc hay không. Khi được bật, các lời nhắc gửi đến sẽ tự động được 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; ext_info: type: string 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 file_infos: type: array items: type: object properties: 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: - file_id - text - type - url x-apidog-orders: - file_id - text - type - url description: Danh sách thông tin tệp model_name: type: string description: |- Tên mô hình. Giá trị: GEM: Gemini; Qwen: Qianwen. Hunyuan: Hunyuan. Giá trị ví dụ: GEM model_version: type: string description: |- phien ban mo hinh. Gia tri: Khi ModelName la GEM, cac gia tri tuy chon la 2.5 va 3.0; Khi ModelName la Qwen, gia tri tuy chon la 0925; Khi ModelName la Hunyuan, gia tri tuy chon la 3.0; Gia tri vi du: 2.5 negative_prompt: type: string description: Từ khóa trong câu lệnh để ngăn mô hình tạo hình ảnh. output_config: type: object properties: aspect_ratio: type: string description: >- Chỉ định tỷ lệ khung hình của hình ảnh được tạo. Khi ModelName là GEM, các giá trị tùy chọn gồm 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 và 21:9; Khi ModelName là Qwen hoặc Jimeng, tính năng này hiện chưa được hỗ trợ. Jimeng sẽ kết hợp ý định trong Prompt với kích thước hình ảnh tham chiếu, và mô hình sẽ xác định tỷ lệ khung hình của hình ảnh đầu ra một cách thông minh. Giá trị ví dụ: 16:9 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 hình ảnh được tạo. Các giá trị tùy chọn gồm 720P, 1080P, 2K, 4K, 1024x1024, 2048x2048, 2304x1728, 2496x1664, 2560x1440 , 3024x1296, 4096x4096, 4694x3520, 4992x3328, 5404x3040, 6198x2656. Khi sử dụng mô hình Jimeng, bạn nên chỉ định độ phân giải và tỷ lệ khung hình của hình ảnh thông qua Prompt. Giá trị ví dụ: 1024x1024 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 của tác vụ tạo ảnh. x-apifox-orders: - aspect_ratio - input_compliance_check - output_compliance_check - person_generation - resolution - storage_mode x-apidog-orders: - aspect_ratio - input_compliance_check - output_compliance_check - person_generation - resolution - storage_mode prompt: type: string description: từ trong lời nhắc 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: TencentVodSampleRequest x-apifox-orders: - enhance_prompt - ext_info - file_infos - model_name - model_version - negative_prompt - output_config - prompt - session_context - session_id - tasks_priority x-apidog-orders: - enhance_prompt - ext_info - file_infos - model_name - model_version - negative_prompt - output_config - prompt - session_context - session_id - tasks_priority examples: example_single: value: enhance_prompt: Đã bật ext_info: '' file_infos: - file_id: '387702299774574677' text: Thông tin mô tả của hình ảnh gốc type: file url: '' model_name: GEM model_version: '3.0' negative_prompt: mờ, méo mó output_config: aspect_ratio: '1:1' input_compliance_check: Đã bật output_compliance_check: Đã bật person_generation: AllowAdult resolution: 1080P storage_mode: Tạm thời prompt: chuyển hình ảnh này sang phong cách anime session_context: '{"user_id": "123", "scene": "anh_dai_dien"}' session_id: image-task-67890 tasks_priority: 10 summary: example_single description: Tạo tác vụ responses: '200': description: '' content: application/json: schema: type: object required: - Response properties: Response: type: object required: - TaskId - RequestId properties: RequestId: type: string description: Mã yêu cầu TaskId: type: string description: Mã tác vụ description: Phần thân phản hồi theo phong cách Tencent Cloud x-apifox-orders: - RequestId - TaskId x-apidog-orders: - RequestId - TaskId refName: TencentVodSampleResponse description: >- Khi gửi thành công, hệ thống trả về `Response.TaskId`, được dùng cho truy vấn `GET /tencent-vod/v1/query/{task_id}` tiếp theo. x-apifox-orders: - Response x-apidog-orders: - Response examples: example: summary: example value: Response: RequestId: f50d7667-72d8-46bb-a7e3-0613588971b6 TaskId: 251007502-AigcImage***2782aff1e896673f1ft 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/Hình ảnh/Ảnh thô AIGC của Tencent x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208926-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "qwen-image-edit-2509" Nguồn: https://docs.openaihub.net/api-45208927/ > 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/images/generations: post: summary: qwen-image-edit-2509 deprecated: false description: >- Với một lời nhắc, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được dự đoán, đồng thời cũng có thể trả về xác suất của các mã từ thay thế tại mỗi vị trí. Tạo các phần hoàn thành cho lời nhắc và các tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/create operationId: v1_images_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Qwen - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Content-Type in: header description: '' required: true example: application/json schema: type: string - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - prompt - model - 'n' properties: background: type: string enum: - auto - opaque - transparent description: |- Nền Các tùy chọn: auto (mặc định), opaque, transparent Khi transparent, định dạng phải là png hoặc webp format: type: string description: >- Định dạng hình ảnh Các tùy chọn: png, jpeg, webp Sử dụng png hoặc webp cho nền trong suốt. (Tên trường chính thức là output_format, nhưng cổng này dùng nhất quán format như trong bảng điều khiển gỡ lỗi gpt-image-2.) model: type: string enum: - gpt-image-2.5-flare - gpt-image-2.5-sunburst enumDetails: - value: gpt-image-2.5-flare displayName: Flare - value: gpt-image-2.5-sunburst displayName: Biểu đồ tia nắng description: >- Tên mô hình gpt-image-2.5-flare Nhanh hơn, phù hợp cho việc tạo nội dung hằng ngày hoặc với mức độ đồng thời cao gpt-image-2.5-sunburst Độ chính xác cao hơn, phù hợp cho việc tinh chỉnh và sản xuất nội dung sáng tạo moderation: type: string enum: - auto - low description: |- Mức độ nghiêm ngặt của kiểm duyệt nội dung Các tùy chọn: auto (mặc định), low 'n': type: integer description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. Mặc định là 1 nếu không được cung cấp. prompt: type: string description: >- Mô tả bằng văn bản về hình ảnh mong muốn. Độ dài tối đa là 1000 ký tự. quality: type: string description: >- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) So với gpt-image-2, xhigh và max là các tùy chọn mới. low phù hợp với bản nháp; xhigh / max cung cấp nhiều chi tiết hơn nhưng có độ trễ và chi phí cao hơn. response_format: type: string enum: - url - b64_json enumDetails: - value: url - value: b64_json size: type: string description: >- Kích thước hình ảnh 1024x1024 Vuông 1536x1024 Ngang 1024x1536 Dọc 2048x2048 Vuông 2K 2048x1152 Ngang 2K 3840x2160 Ngang 4K 2160x3840 Dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 Các độ phân giải trên 2560x1440 được xem là các khả năng thử nghiệm. x-apifox-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size x-apidog-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size examples: example: value: format: webp model: gpt-image-2.5-flare 'n': 1 prompt: >- Ảnh tĩnh sản phẩm: bàn phím cơ màu đen nhám, ánh sáng trường quay, không có chữ quality: trung bình response_format: url size: 1536x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.webp headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Qwen x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208927-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "qwen-image-max-2025-12-30 địa chỉ mới" Nguồn: https://docs.openaihub.net/api-45208928/ > 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/multimodal-generation/generation: post: summary: qwen-image-max-2025-12-30 địa chỉ mới deprecated: false description: Các khả năng đa phương thức như TTS. operationId: alibailian_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Qwen - Xưởng mô hình Alibaba parameters: [] requestBody: content: application/json: schema: type: object required: - model - input properties: input: type: object required: - text - voice properties: language_type: type: string description: Loại ngôn ngữ text: type: string description: Vui lòng cung cấp nội dung văn bản cần dịch. voice: type: string description: 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: - language_type - text - voice x-apidog-orders: - language_type - text - voice model: type: string description: Tên mô hình / mã định danh mô hình refName: AlibailianSampleRequest x-apifox-orders: - input - model x-apidog-orders: - input - model examples: {} responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: output: task_id: task-example request_id: req-example 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/Hình ảnh/Qwen x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208928-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "wan2.7-image-pro" Nguồn: https://docs.openaihub.net/api-45208929/ > 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/images/generations: post: summary: wan2.7-image-pro deprecated: false description: >- Với một lời nhắc, mô hình sẽ trả về một hoặc nhiều phần hoàn thành được dự đoán, đồng thời cũng có thể trả về xác suất của các mã từ thay thế tại mỗi vị trí. Tạo các phần hoàn thành cho lời nhắc và các tham số được cung cấp. Tài liệu chính thức: https://platform.openai.com/docs/api-reference/images/create operationId: v1_images_generations tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Wan - API tạo ảnh từ văn bản/GPT Image-1 parameters: - name: Content-Type in: header description: '' required: true example: application/json schema: type: string - name: Accept in: header description: '' required: true example: application/json schema: type: string - name: Authorization in: header description: '' required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - prompt - model - 'n' properties: background: type: string enum: - auto - opaque - transparent description: |- Nền Các tùy chọn: auto (mặc định), opaque, transparent Khi transparent, định dạng phải là png hoặc webp format: type: string description: >- Định dạng hình ảnh Các tùy chọn: png, jpeg, webp Sử dụng png hoặc webp cho nền trong suốt. (Tên trường chính thức là output_format, nhưng cổng này dùng nhất quán format như trong bảng điều khiển gỡ lỗi gpt-image-2.) model: type: string enum: - gpt-image-2.5-flare - gpt-image-2.5-sunburst enumDetails: - value: gpt-image-2.5-flare displayName: Flare - value: gpt-image-2.5-sunburst displayName: Biểu đồ tia nắng description: >- Tên mô hình gpt-image-2.5-flare Nhanh hơn, phù hợp cho việc tạo nội dung hằng ngày hoặc với mức độ đồng thời cao gpt-image-2.5-sunburst Độ chính xác cao hơn, phù hợp cho việc tinh chỉnh và sản xuất nội dung sáng tạo moderation: type: string enum: - auto - low description: |- Mức độ nghiêm ngặt của kiểm duyệt nội dung Các tùy chọn: auto (mặc định), low 'n': type: integer description: >- Số lượng hình ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10. Mặc định là 1 nếu không được cung cấp. prompt: type: string description: >- Mô tả bằng văn bản về hình ảnh mong muốn. Độ dài tối đa là 1000 ký tự. quality: type: string description: >- Chất lượng hình ảnh Các tùy chọn: low, medium, high, xhigh, max, auto (mặc định) So với gpt-image-2, xhigh và max là các tùy chọn mới. low phù hợp với bản nháp; xhigh / max cung cấp nhiều chi tiết hơn nhưng có độ trễ và chi phí cao hơn. response_format: type: string enum: - url - b64_json enumDetails: - value: url - value: b64_json size: type: string description: >- Kích thước hình ảnh 1024x1024 Vuông 1536x1024 Ngang 1024x1536 Dọc 2048x2048 Vuông 2K 2048x1152 Ngang 2K 3840x2160 Ngang 4K 2160x3840 Dọc 4K auto Mặc định Các quy tắc giới hạn kích thước nghiêm ngặt 1. Độ dài cạnh tối đa của hình ảnh ≤ 3840px 2. Cả chiều rộng và chiều cao phải là bội số của 16px 3. Tỷ lệ cạnh dài / cạnh ngắn ≤ 3:1 4. Phạm vi tổng số điểm ảnh: tối thiểu 655360 ~ tối đa 8294400 Các độ phân giải trên 2560x1440 được xem là các khả năng thử nghiệm. x-apifox-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size x-apidog-orders: - background - format - model - moderation - 'n' - prompt - quality - response_format - size examples: example: value: format: webp model: gpt-image-2.5-flare 'n': 1 prompt: >- Ảnh tĩnh sản phẩm: bàn phím cơ màu đen nhám, ánh sáng trường quay, không có chữ quality: trung bình response_format: url size: 1536x1024 summary: example responses: '200': description: '' content: application/json: schema: type: object required: - created - data properties: created: type: integer data: type: array items: type: object properties: url: type: string x-apifox-orders: - url x-apidog-orders: - url x-apifox-orders: - created - data x-apidog-orders: - created - data examples: example: summary: example value: created: 1773100000 data: - url: >- https://cdn.example.com/images/gpt-image-2.5-flare/req_abc123/0.webp headers: {} x-apidog-name: '' security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Wan x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208929-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video Vincent" Nguồn: https://docs.openaihub.net/api-45208930/ > 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: /openapi/v2/video/text/generate: post: summary: Tạo video Vincent deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_text_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 refName: PostOpenapiV2VideoTextGenerateRequest x-apifox-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed x-apidog-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208930-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video Tusheng" Nguồn: https://docs.openaihub.net/api-45208931/ > 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: /openapi/v2/video/img/generate: post: summary: Tạo video Tusheng deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_img_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) img_id: type: integer description: ID hình ảnh nhận được thông qua giao diện tải lên model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 refName: PostOpenapiV2VideoImgGenerateRequest x-apifox-orders: - aspect_ratio - duration - img_id - model - negative_prompt - prompt - quality - seed x-apidog-orders: - aspect_ratio - duration - img_id - model - negative_prompt - prompt - quality - seed examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208931-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video từ khung hình đầu tiên và khung hình cuối cùng" Nguồn: https://docs.openaihub.net/api-45208932/ > 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: /openapi/v2/video/transition/generate: post: summary: Tạo video từ khung hình đầu tiên và khung hình cuối cùng deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_transition_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) first_frame_img: type: integer description: Hình ảnh khung hình đầu tiên last_frame_img: type: integer description: Hình ảnh khung hình cuối model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 refName: PostOpenapiV2VideoTransitionGenerateRequest x-apifox-orders: - aspect_ratio - duration - first_frame_img - last_frame_img - model - negative_prompt - prompt - quality - seed x-apidog-orders: - aspect_ratio - duration - first_frame_img - last_frame_img - model - negative_prompt - prompt - quality - seed examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208932-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Lấy trạng thái video" Nguồn: https://docs.openaihub.net/api-45208933/ > 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: /openapi/v2/video/result/{video_id}: get: summary: Lấy trạng thái video deprecated: false description: Truy vấn trạng thái và kết quả của tác vụ tạo video bằng video_id. operationId: pixverse_video_result_get tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: - name: video_id in: path description: Mã tác vụ video required: true example: '' schema: type: string - name: API-KEY in: header description: Khóa API nền tảng (tiêu đề yêu cầu) required: true example: '{{YOUR_API_KEY}}' schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208933-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video đồng bộ chuyển động môi" Nguồn: https://docs.openaihub.net/api-45208934/ > 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: /openapi/v2/video/lip_sync/generate: post: summary: Tạo video đồng bộ chuyển động môi deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_lip_sync_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' audio_url: type: string description: URL âm thanh duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 video_id: type: integer description: ID video refName: PostOpenapiV2VideoLipSyncGenerateRequest x-apifox-orders: - aspect_ratio - audio_url - duration - model - negative_prompt - prompt - quality - seed - video_id x-apidog-orders: - aspect_ratio - audio_url - duration - model - negative_prompt - prompt - quality - seed - video_id examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208934-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Lấy âm thanh TTS" Nguồn: https://docs.openaihub.net/api-45208935/ > 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: /openapi/v2/video/lip_sync/tts_list: get: summary: Lấy âm thanh TTS deprecated: false description: Liệt kê các giọng nói TTS có sẵn để tạo video đồng bộ khẩu hình. operationId: pixverse_video_lip_sync_tts_list tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208935-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video mở rộng" Nguồn: https://docs.openaihub.net/api-45208936/ > 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: /openapi/v2/video/extend/generate: post: summary: Tạo video mở rộng deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_extend_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 video_id: type: integer description: ID video gốc refName: PostOpenapiV2VideoExtendGenerateRequest x-apifox-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed - video_id x-apidog-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed - video_id examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208936-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Giao diện tạo hiệu ứng âm thanh (sound_effect)" Nguồn: https://docs.openaihub.net/api-45208937/ > 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: /openapi/v2/video/sound_effect/generate: post: summary: Giao diện tạo hiệu ứng âm thanh (sound_effect) deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_sound_effect_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 refName: PostOpenapiV2VideoSoundEffectGenerateRequest x-apifox-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed x-apidog-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208937-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video đa tác tử (đa tham chiếu)" Nguồn: https://docs.openaihub.net/api-45208938/ > 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: /openapi/v2/video/fusion/generate: post: summary: Tạo video đa tác tử (đa tham chiếu) deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_fusion_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) img_ids: type: array items: type: integer description: Danh sách mã định danh tài nguyên hình ảnh model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 refName: PostOpenapiV2VideoFusionGenerateRequest x-apifox-orders: - aspect_ratio - duration - img_ids - model - negative_prompt - prompt - quality - seed x-apidog-orders: - aspect_ratio - duration - img_ids - model - negative_prompt - prompt - quality - seed examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208938-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Vẽ lại video để tạo video" Nguồn: https://docs.openaihub.net/api-45208939/ > 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: /openapi/v2/video/restyle/generate: post: summary: Vẽ lại video để tạo video deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_restyle_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 refName: PostOpenapiV2VideoRestyleGenerateRequest x-apifox-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed x-apidog-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208939-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo mặt nạ thay thế cơ thể (Swap)" Nguồn: https://docs.openaihub.net/api-45208940/ > 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: /openapi/v2/video/mask/selection: post: summary: Tạo mặt nạ thay thế cơ thể (Swap) deprecated: false description: Lấy mặt nạ video. operationId: pixverse_video_mask_selection tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - video_id properties: video_id: type: integer description: ID video x-apifox-orders: - video_id x-apidog-orders: - video_id examples: {} responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208940-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video thay thế chủ thể (Hoán đổi)" Nguồn: https://docs.openaihub.net/api-45208941/ > 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: /openapi/v2/video/swap/generate: post: summary: Tạo video thay thế chủ thể (Hoán đổi) deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_swap_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 video_id: type: integer description: ID video refName: PostOpenapiV2VideoSwapGenerateRequest x-apifox-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed - video_id x-apidog-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed - video_id examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208941-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video nhiều khung hình (nhiều chuyển cảnh)" Nguồn: https://docs.openaihub.net/api-45208942/ > 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: /openapi/v2/video/multi_transition/generate: post: summary: Tạo video nhiều khung hình (nhiều chuyển cảnh) deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_multi_transition_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 refName: PostOpenapiV2VideoMultiTransitionGenerateRequest x-apifox-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed x-apidog-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208942-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo video bắt chước hành động (Mimic)" Nguồn: https://docs.openaihub.net/api-45208943/ > 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: /openapi/v2/video/mimic/generate: post: summary: Tạo video bắt chước hành động (Mimic) deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_mimic_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) img_id: type: integer description: Mã định danh tài nguyên hình ảnh model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 video_id: type: integer description: ID video refName: PostOpenapiV2VideoMimicGenerateRequest x-apifox-orders: - aspect_ratio - duration - img_id - model - negative_prompt - prompt - quality - seed - video_id x-apidog-orders: - aspect_ratio - duration - img_id - model - negative_prompt - prompt - quality - seed - video_id examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208943-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Chỉnh sửa video (Modify) tạo ra video" Nguồn: https://docs.openaihub.net/api-45208944/ > 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: /openapi/v2/video/modify/generate: post: summary: Chỉnh sửa video (Modify) tạo ra video deprecated: false description: >- Tạo video bằng Pixverse; thăm dò kết quả qua GET /openapi/v2/video/result/{id} sau khi gửi yêu cầu. operationId: pixverse_video_modify_generate tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - model - 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' duration: type: integer enum: - 5 - 8 - 10 description: Thời lượng (giây hoặc đơn vị do nền tảng quy định) model: type: string enum: - v3.5 - v4 - v4.5 - v5 - v5.5 - v6 description: phiên bản mô hình examples: - v5.5 negative_prompt: type: string description: Lời nhắc phủ định (nội dung cần tránh) prompt: type: string description: Mô tả video quality: type: string enum: - 360p - 540p - 720p - 1080p description: Mức chất lượng đầu ra 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 refName: PostOpenapiV2VideoModifyGenerateRequest x-apifox-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed x-apidog-orders: - aspect_ratio - duration - model - negative_prompt - prompt - quality - seed examples: v5_5: value: aspect_ratio: '16:9' duration: 5 model: v5.5 prompt: Một con mèo đang chạy trên cỏ quality: 720p summary: v5_5 description: Video Vincent responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208944-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tải ảnh lên" Nguồn: https://docs.openaihub.net/api-45208945/ > 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: /openapi/v2/image/upload: post: summary: Tải ảnh lên deprecated: false description: tải lên nhiều phần. operationId: pixverse_image_upload tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: image: type: string format: binary description: URL hình ảnh hoặc Base64 example: '' required: - image examples: {} responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208945-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tải tài nguyên lên (video/âm thanh)" Nguồn: https://docs.openaihub.net/api-45208946/ > 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: /openapi/v2/media/upload: post: summary: Tải tài nguyên lên (video/âm thanh) deprecated: false description: tải video/âm thanh lên theo nhiều phần. operationId: pixverse_media_upload tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: file: type: string format: binary description: Đối tượng tệp hoặc trường tệp example: '' required: - file examples: {} responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208946-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Giao diện tạo mẫu ảnh" Nguồn: https://docs.openaihub.net/api-45208947/ > 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: /openapi/v2/image/template/generate: post: summary: Giao diện tạo mẫu ảnh deprecated: false description: Sử dụng mẫu để tạo hình ảnh. operationId: pixverse_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: [] requestBody: content: application/json: schema: type: object required: - template_id properties: prompt: type: string description: Lời nhắc văn bản template_id: type: integer description: Mã mẫu refName: PixverseSampleRequest x-apifox-orders: - prompt - template_id x-apidog-orders: - prompt - template_id examples: {} responses: '200': description: Được content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208947-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Giao diện truy vấn kết quả hình ảnh" Nguồn: https://docs.openaihub.net/api-45208948/ > 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: /openapi/v2/image/result/{image_id}: get: summary: Giao diện truy vấn kết quả hình ảnh deprecated: false description: Truy vấn trạng thái và kết quả của tác vụ tạo mẫu ảnh theo image_id. operationId: pixverse_image_result_get tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix - Pixverse parameters: - name: image_id in: path description: Mã hình ảnh required: true example: '' schema: type: string - name: API-KEY in: header description: Khóa API nền tảng (tiêu đề yêu cầu) required: false example: '{{YOUR_API_KEY}}' schema: type: string responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: ErrCode: 0 ErrMsg: thành công RespData: id: 123456 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/Hình ảnh/Ali Pix x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208948-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ black-forest-labs/flux-kontext-dev" Nguồn: https://docs.openaihub.net/api-45208949/ > 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: /replicate/v1/models/black-forest-labs/flux-kontext-dev/predictions: post: summary: Tạo tác vụ black-forest-labs/flux-kontext-dev deprecated: false description: >- Tài liệu chính thức: https://replicate.com/black-forest-labs/flux-kontext-dev operationId: >- replicate_replicate_v1_models_black_forest_labs_flux_kontext_dev_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt - input_image properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Sử dụng "match_input_image" để khớp với tỷ lệ khung hình của hình ảnh đầu vào. Giá trị mặc định: "match_input_image". go_fast: type: boolean description: >- Giúp mô hình chạy nhanh hơn, chất lượng đầu ra có thể giảm nhẹ đối với các lời nhắc khó hơn. Giá trị mặc định: true. guidance: type: number description: >- Các từ gợi ý điều chỉnh cường độ. Giá trị mặc định: 2.5. Giá trị tối thiểu: 0, giá trị tối đa: 10 input_image: type: string description: >- Hình ảnh dùng làm tài liệu tham khảo. Phải có định dạng jpeg, png, gif hoặc webp. num_inference_steps: type: integer description: >- Số bước suy luận, mặc định: 28. Giá trị tối thiểu: 4, giá trị tối đa: 50. output_format: type: string description: 'Định dạng ảnh đầu ra. Mặc định: "webp".' output_quality: type: integer description: >- Chất lượng lưu hình ảnh đầu ra, từ 0 đến 100. 100 là chất lượng tốt nhất, 0 là chất lượng thấp nhất. Không liên quan đến đầu ra .png. Giá trị mặc định: 80. Giá trị nhỏ nhất: 0, giá trị lớn nhất: 100. prompt: type: string description: >- Mô tả bằng văn bản về nội dung bạn muốn tạo, hoặc hướng dẫn cách chỉnh sửa một hình ảnh được cung cấp. description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - go_fast - guidance - input_image - num_inference_steps - output_format - output_quality - prompt x-apidog-orders: - aspect_ratio - go_fast - guidance - input_image - num_inference_steps - output_format - output_quality - prompt x-apifox-orders: - input x-apidog-orders: - input examples: black_forest_labsflux_kontext_dev_single: value: input: aspect_ratio: match_input_image go_fast: true guidance: 2.5 input_image: >- https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg num_inference_steps: 30 output_format: jpg output_quality: 80 prompt: Đổi màu xe thành màu đỏ, bật đèn pha summary: black_forest_labsflux_kontext_dev_single description: Tạo tác vụ black-forest-labs/flux-kontext-dev responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: >- PostReplicateV1ModelsBlackForestLabsFluxKontextDevPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-29T07:12:42.163Z' data_removed: false id: tpdf40dypdrma0cram394vvzkg input: aspect_ratio: match_input_image go_fast: true guidance: 2.5 input_image: >- https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg num_inference_steps: 30 output_format: jpg output_quality: 80 prompt: Đổi màu xe thành màu đỏ, bật đèn pha logs: '' model: black-forest-labs/flux-kontext-dev status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/tpdf40dypdrma0cram394vvzkg/cancel get: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập trực tiếp URL này. stream: >- Vui lòng dán nội dung tài liệu cần dịch vào đây; tôi không thể truy cập trực tiếp URL được cung cấp. web: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ liên kết đã cung cấp. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208949-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ black-forest-labs/flux-1.1-pro-ultra" Nguồn: https://docs.openaihub.net/api-45208950/ > 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: /replicate/v1/models/black-forest-labs/flux-1.1-pro-ultra/predictions: post: summary: Tạo tác vụ black-forest-labs/flux-1.1-pro-ultra deprecated: false description: >- Tài liệu chính thức: https://replicate.com/black-forest-labs/flux-1.1-pro-ultra operationId: >- replicate_replicate_v1_models_black_forest_labs_flux_1_1_pro_ultra_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của ảnh được tạo, giá trị mặc định: "1:1". image_prompt_strength: type: number description: >- Sự kết hợp giữa câu lệnh và câu lệnh tạo hình ảnh. Giá trị tối thiểu: 0, giá trị tối đa: 1. output_format: type: string description: 'Định dạng của hình ảnh đầu ra. Giá trị mặc định: "jpg".' prompt: type: string description: Lời nhắc văn bản được tạo từ hình ảnh. raw: type: boolean description: >- Tạo ra hình ảnh ít qua xử lý hơn và tự nhiên hơn. Giá trị mặc định: false. safety_tolerance: type: integer description: >- Mức dung sai an toàn. 1 là nghiêm ngặt nhất và 6 là ít nghiêm ngặt nhất. Giá trị mặc định: 2. description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - image_prompt_strength - output_format - prompt - raw - safety_tolerance x-apidog-orders: - aspect_ratio - image_prompt_strength - output_format - prompt - raw - safety_tolerance x-apifox-orders: - input x-apidog-orders: - input examples: black_forest_labsflux_11_pro_ultra_single: value: input: aspect_ratio: '3:2' image_prompt_strength: 0.1 output_format: jpg prompt: >- một đỉnh núi phủ tuyết hùng vĩ, đắm mình trong ánh sáng ấm áp của mặt trời lặn raw: false safety_tolerance: 2 summary: black_forest_labsflux_11_pro_ultra_single description: Tạo tác vụ black-forest-labs/flux-1.1-pro-ultra responses: '200': description: '' content: application/json: schema: type: object required: - input properties: input: type: object required: - prompt properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' image_prompt_strength: type: number description: Mức độ tác động của lời nhắc tạo ảnh output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản raw: type: boolean description: Có trả về đầu ra thô (chưa qua xử lý) hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - image_prompt_strength - output_format - prompt - raw - safety_tolerance x-apidog-orders: - aspect_ratio - image_prompt_strength - output_format - prompt - raw - safety_tolerance x-apifox-orders: - input x-apidog-orders: - input examples: example: summary: example value: created_at: '2025-07-29T05:45:44.464Z' data_removed: false id: brgfcps121rm80crajvr2x4jg4 input: aspect_ratio: '3:2' image_prompt_strength: 0.1 output_format: jpg prompt: >- một đỉnh núi phủ tuyết hùng vĩ, đắm mình trong ánh sáng ấm áp của mặt trời lặn raw: false safety_tolerance: 2 logs: '' model: black-forest-labs/flux-1.1-pro-ultra status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/brgfcps121rm80crajvr2x4jg4/cancel get: >- https://api.replicate.com/v1/predictions/brgfcps121rm80crajvr2x4jg4 stream: >- Vui lòng dán nội dung tài liệu cần dịch vào đây; tôi không thể truy cập trực tiếp liên kết này. web: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập trực tiếp nội dung từ URL này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208950-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ black-forest-labs/flux-kontext-pro" Nguồn: https://docs.openaihub.net/api-45208951/ > 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: /replicate/v1/models/black-forest-labs/flux-kontext-pro/predictions: post: summary: Tạo tác vụ black-forest-labs/flux-kontext-pro deprecated: false description: >- Tài liệu chính thức: https://replicate.com/black-forest-labs/flux-kontext-pro operationId: >- replicate_replicate_v1_models_black_forest_labs_flux_kontext_pro_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Sử dụng "match_input_image" để khớp với tỷ lệ khung hình của hình ảnh đầu vào. Giá trị mặc định: "match_input_image", hỗ trợ 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2. input_image: type: string description: >- Hình ảnh dùng làm tài liệu tham khảo. Phải có định dạng jpeg, png, gif hoặc webp. output_format: type: string description: >- Định dạng đầu ra của hình ảnh được tạo. Giá trị mặc định: "png". prompt: type: string description: >- Mô tả bằng văn bản về nội dung bạn muốn tạo, hoặc hướng dẫn cách chỉnh sửa một hình ảnh được cung cấp. prompt_upsampling: type: boolean description: 'Tự động cải thiện lời nhắc. Giá trị mặc định: false.' safety_tolerance: type: integer description: >- Mức dung sai an toàn, 0 là nghiêm ngặt nhất và 6 là lỏng nhất. 2 hiện là giá trị tối đa được phép khi sử dụng hình ảnh đầu vào. Giá trị mặc định: 2 description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apifox-orders: - input x-apidog-orders: - input examples: black_forest_labsflux_kontext_pro_single: value: input: aspect_ratio: match_input_image input_image: >- Vui lòng tải ảnh trực tiếp lên để tôi có thể đọc và dịch nội dung, đồ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. output_format: jpg prompt: Hãy biến hình này thành phim hoạt hình thập niên 90. prompt_upsampling: false safety_tolerance: 2 summary: black_forest_labsflux_kontext_pro_single description: Tạo tác vụ black-forest-labs/flux-kontext-pro responses: '200': description: '' content: application/json: schema: type: object required: - input properties: input: type: object required: - prompt properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apifox-orders: - input x-apidog-orders: - input examples: '1': summary: '1' value: created_at: '2025-07-29T06:51:12.591Z' data_removed: false id: b1qw7g8h9xrma0crakst3xbj8m input: aspect_ratio: match_input_image input_image: >- Vui lòng tải ảnh trực tiếp lên để tôi có thể đọc và dịch nội dung, đồ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. output_format: jpg prompt: Hãy biến hình này thành phim hoạt hình thập niên 90. prompt_upsampling: false safety_tolerance: 2 logs: '' model: black-forest-labs/flux-kontext-pro status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/b1qw7g8h9xrma0crakst3xbj8m/cancel get: >- https://api.replicate.com/v1/predictions/b1qw7g8h9xrma0crakst3xbj8m stream: >- Không thể truy cập nội dung tài liệu từ URL được cung cấp. Vui lòng gửi trực tiếp nội dung cần dịch. web: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL này: https://replicate.com/p/b1qw7g8h9xrma0crakst3xbj8m version: ẩn '2': summary: '2' value: created_at: '2025-07-12T07:27:54.577Z' data_removed: false id: w44zs9cet5rmc0cqzp49gpkhf8 input: aspect_ratio: match_input_image input_image: >- Vui lòng tải ảnh lên trực tiếp hoặc dán nội dung tài liệu để tôi có thể dịch sang tiếng Việt và giữ nguyên định dạng Markdown, mã, định danh, URL, đường dẫn, chỗ giữ chỗ cùng cấu trúc JSON. output_format: jpg prompt: >- Làm cho các chữ cái có hiệu ứng 3D, lơ lửng trong không gian trên một con phố thành thị prompt_upsampling: false safety_tolerance: 2 logs: '' model: black-forest-labs/flux-kontext-dev status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8/cancel get: >- Vui lòng truy xuất nội dung tại https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8 rồi dịch tài liệu kỹ thuật đó sang tiếng Việt. Giữ nguyên Markdown, mã, định danh, URL, đường dẫn, chỗ dành sẵn, 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. stream: >- Vui lòng dán nội dung tài liệu vào đây để tôi có thể dịch sang tiếng Việt và giữ nguyên Markdown, mã nguồn, định danh, URL, đường dẫn, chỗ dành sẵn, cấu trúc JSON cùng định dạng. web: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập trực tiếp nội dung từ liên kết này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208951-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ black-forest-labs/flux-kontext-max" Nguồn: https://docs.openaihub.net/api-45208952/ > 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: /replicate/v1/models/black-forest-labs/flux-kontext-max/predictions: post: summary: Tạo tác vụ black-forest-labs/flux-kontext-max deprecated: false description: >- Tài liệu chính thức: https://replicate.com/black-forest-labs/flux-kontext-max operationId: >- replicate_replicate_v1_models_black_forest_labs_flux_kontext_max_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Sử dụng "match_input_image" để khớp với tỷ lệ khung hình của hình ảnh đầu vào. Giá trị mặc định: "match_input_image". input_image: type: string description: >- Hình ảnh dùng làm tài liệu tham khảo. Phải có định dạng jpeg, png, gif hoặc webp. output_format: type: string description: >- Định dạng đầu ra của hình ảnh được tạo. Giá trị mặc định: "png". prompt: type: string description: >- Mô tả bằng văn bản về nội dung bạn muốn tạo, hoặc hướng dẫn cách chỉnh sửa một hình ảnh được cung cấp. prompt_upsampling: type: boolean description: 'Tự động cải thiện lời nhắc. Giá trị mặc định: false.' safety_tolerance: type: integer description: >- Mức dung sai an toàn, 0 là nghiêm ngặt nhất và 6 là lỏng nhất. 2 hiện là giá trị tối đa được phép khi sử dụng hình ảnh đầu vào. Giá trị mặc định: 2. Giá trị tối thiểu: 0, giá trị tối đa: 6. description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apifox-orders: - input x-apidog-orders: - input examples: black_forest_labsflux_kontext_max_single: value: input: aspect_ratio: match_input_image input_image: >- Vui lòng tải ảnh lên trực tiếp hoặc dán nội dung tài liệu để tôi có thể dịch sang tiếng Việt và giữ nguyên định dạng Markdown, mã, định danh, URL, đường dẫn, chỗ giữ chỗ cùng cấu trúc JSON. output_format: jpg prompt: >- Làm cho các chữ cái có hiệu ứng 3D, lơ lửng trong không gian trên một con phố thành thị prompt_upsampling: false safety_tolerance: 2 summary: black_forest_labsflux_kontext_max_single description: Tạo tác vụ black-forest-labs/flux-kontext-max responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: >- PostReplicateV1ModelsBlackForestLabsFluxKontextMaxPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-29T07:21:33.309Z' data_removed: false id: 5pcmjq6sfnrmc0cram79p95eg4 input: aspect_ratio: match_input_image input_image: >- Vui lòng tải ảnh lên trực tiếp hoặc dán nội dung tài liệu để tôi có thể dịch sang tiếng Việt và giữ nguyên định dạng Markdown, mã, định danh, URL, đường dẫn, chỗ giữ chỗ cùng cấu trúc JSON. output_format: jpg prompt: >- Làm cho các chữ cái có hiệu ứng 3D, lơ lửng trong không gian trên một con phố thành thị prompt_upsampling: false safety_tolerance: 2 logs: '' model: black-forest-labs/flux-kontext-max status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/5pcmjq6sfnrmc0cram79p95eg4/cancel get: >- Vui lòng dán nội dung tài liệu cần dịch. Đường dẫn API này yêu cầu quyền truy cập nên tôi không thể lấy nội dung trực tiếp. stream: >- https://stream.replicate.com/v1/files/bcwr-o4bl6hrud4sg7ceoi45imkh7lq32nbyqvnsyg736v7ghpxwqxheq web: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ liên kết này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208952-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ - truyền phiên bản mô hình (dự đoán)" Nguồn: https://docs.openaihub.net/api-45208953/ > 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: /replicate/v1/predictions: post: summary: Tạo tác vụ - truyền phiên bản mô hình (dự đoán) deprecated: false description: |- Gửi tác vụ dự đoán ở chế độ phiên bản. Tài liệu chính thức: https://replicate.com/lucataco/remove-bg operationId: replicate_replicate_v1_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: [] requestBody: content: application/json: schema: type: object properties: input: type: object required: - image properties: image: type: string description: Xóa nền khỏi hình ảnh này. description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - image x-apidog-orders: - image version: type: string description: Phiên bản refName: PostReplicateV1PredictionsRequest x-apifox-orders: - input - version x-apidog-orders: - input - version examples: lucatacoremove_bg_single: value: input: image: >- https://replicate.delivery/pbxt/JWsRA6DxCK24PlMYK5ENFYAFxJGUQTLr0JmLwsLb8uhv1JTU/shoe.jpg version: >- 95fcc2a26d3899cd6c2691c900465aaeff466285a65c14638cc5f36f34befaf1 summary: lucatacoremove_bg_single description: Tạo tác vụ lucataco/remove-bg responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: PostReplicateV1PredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: '2': summary: '2' value: created_at: '2025-07-12T07:27:54.577Z' data_removed: false id: w44zs9cet5rmc0cqzp49gpkhf8 input: aspect_ratio: match_input_image input_image: >- Vui lòng tải ảnh lên trực tiếp hoặc dán nội dung tài liệu để tôi có thể dịch sang tiếng Việt và giữ nguyên định dạng Markdown, mã, định danh, URL, đường dẫn, chỗ giữ chỗ cùng cấu trúc JSON. output_format: jpg prompt: >- Làm cho các chữ cái có hiệu ứng 3D, lơ lửng trong không gian trên một con phố thành thị prompt_upsampling: false safety_tolerance: 2 logs: '' model: black-forest-labs/flux-kontext-dev status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8/cancel get: >- Vui lòng truy xuất nội dung tại https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8 rồi dịch tài liệu kỹ thuật đó sang tiếng Việt. Giữ nguyên Markdown, mã, định danh, URL, đường dẫn, chỗ dành sẵn, 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. stream: >- Vui lòng dán nội dung tài liệu vào đây để tôi có thể dịch sang tiếng Việt và giữ nguyên Markdown, mã nguồn, định danh, URL, đường dẫn, chỗ dành sẵn, cấu trúc JSON cùng định dạng. web: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập trực tiếp nội dung từ liên kết này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208953-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-45208954/ > 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: /replicate/v1/predictions/{id}: get: summary: Các tác vụ truy vấn deprecated: false description: Truy vấn trạng thái và kết quả tác vụ dựa trên ID dự đoán. operationId: replicate_replicate_v1_predictions_2 tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo 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: request_id: req_example status: OK 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208954-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ minimax/video-01-live" Nguồn: https://docs.openaihub.net/api-45208955/ > 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: /replicate/v1/models/minimax/video-01-live/predictions: post: summary: Tạo tác vụ minimax/video-01-live deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch vào đây. Tôi không thể truy cập trực tiếp nội dung từ URL https://replicate.com/minimax/video-01-live trong phiên này. operationId: replicate_replicate_v1_models_minimax_video_01_live_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt - first_frame_image properties: first_frame_image: type: string description: >- Dùng để tạo khung hình đầu tiên của video. Video đầu ra sẽ có cùng tỷ lệ khung hình với hình ảnh này. prompt: type: string description: Tạo lời nhắc dạng văn bản. prompt_optimizer: type: boolean description: 'Sử dụng trình tối ưu hóa gợi ý. Giá trị mặc định: true' description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - first_frame_image - prompt - prompt_optimizer x-apidog-orders: - first_frame_image - prompt - prompt_optimizer x-apifox-orders: - input x-apidog-orders: - input examples: minimaxvideo_01_live_single: value: input: first_frame_image: >- https://replicate.delivery/pbxt/M9jlcXgeaypBr2yQYGf9JXgxUCJWRt8ODUDvt90UWPUsQBXC/back-to-the-future.png prompt: một người đàn ông đang nói chuyện một cách giận dữ prompt_optimizer: true summary: minimaxvideo_01_live_single description: Tạo tác vụ minimax/video-01-live responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: PostReplicateV1ModelsMinimaxVideo01LivePredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-30T01:38:07.143Z' data_removed: false id: x18c1re8mxrma0crb3x8wbwqmg input: first_frame_image: >- https://replicate.delivery/pbxt/M9jlcXgeaypBr2yQYGf9JXgxUCJWRt8ODUDvt90UWPUsQBXC/back-to-the-future.png prompt: một người đàn ông đang nói chuyện một cách giận dữ prompt_optimizer: true logs: '' model: minimax/video-01-live status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/x18c1re8mxrma0crb3x8wbwqmg/cancel get: >- https://api.replicate.com/v1/predictions/x18c1re8mxrma0crb3x8wbwqmg stream: >- Vui long dan noi dung tai lieu vao day de toi co the dich sang tieng Viet. Toi khong the truy cap truc tiep noi dung tu URL nay. web: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập nội dung trực tiếp từ liên kết này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208955-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ minimax/video-01" Nguồn: https://docs.openaihub.net/api-45208956/ > 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: /replicate/v1/models/minimax/video-01/predictions: post: summary: Tạo tác vụ minimax/video-01 deprecated: false description: 'Tài liệu chính thức: https://replicate.com/minimax/video-01' operationId: replicate_replicate_v1_models_minimax_video_01_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: prompt: type: string description: Tạo lời nhắc dạng văn bản. prompt_optimizer: type: boolean description: 'Sử dụng trình tối ưu hóa gợi ý. Giá trị mặc định: true' description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - prompt - prompt_optimizer x-apidog-orders: - prompt - prompt_optimizer x-apifox-orders: - input x-apidog-orders: - input examples: minimaxvideo_01_single: value: input: prompt: >- một người phụ nữ đang đi bộ trên một con phố đông đúc ở Tokyo vào ban đêm, cô ấy đeo kính râm màu tối prompt_optimizer: true summary: minimaxvideo_01_single description: Tạo tác vụ minimax/video-01 responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: prompt: type: string description: Lời nhắc văn bản prompt_optimizer: type: boolean description: Có bật tối ưu hóa lời nhắc hay không description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - prompt - prompt_optimizer x-apidog-orders: - prompt - prompt_optimizer logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: PostReplicateV1ModelsMinimaxVideo01PredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-30T01:41:10.089Z' data_removed: false id: ree8dymk95rmc0crb3yt2pqhr4 input: prompt: >- một người phụ nữ đang đi bộ trên một con phố đông đúc ở Tokyo vào ban đêm, cô ấy đeo kính râm màu tối prompt_optimizer: true logs: '' model: minimax/video-01 status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/ree8dymk95rmc0crb3yt2pqhr4/cancel get: >- Tôi không thể truy cập nội dung từ URL này. Vui lòng dán tài liệu kỹ thuật cần dịch vào đây. stream: >- https://stream.replicate.com/v1/files/bcwr-wykptlq2o5ws5ukylao2u654xfxv6aaaekgxijlr7aibzkftt7bq web: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập nội dung từ liên kết này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208956-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ recraft-ai/recraft-v3" Nguồn: https://docs.openaihub.net/api-45208957/ > 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: /replicate/v1/models/recraft-ai/recraft-v3/predictions: post: summary: Tạo tác vụ recraft-ai/recraft-v3 deprecated: false description: 'Tài liệu chính thức: https://replicate.com/recraft-ai/recraft-v3' operationId: replicate_replicate_v1_models_recraft_ai_recraft_v3_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Giá trị mặc định: "Chưa thiết lập" prompt: type: string description: Lời nhắc văn bản được tạo từ hình ảnh. size: type: string description: >- Tạo chiều rộng và chiều cao của hình ảnh. Nếu tỷ lệ khung hình được thiết lập, các kích thước sẽ bị bỏ qua. Giá trị mặc định: "1024x1024" style: type: string description: >- Phong cách của hình ảnh được tạo. Giá trị mặc định: "any" description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - prompt - size - style x-apidog-orders: - aspect_ratio - prompt - size - style x-apifox-orders: - input x-apidog-orders: - input examples: recraft_airecraft_v3_single: value: input: aspect_ratio: Chưa đặt prompt: >- một bức ảnh động vật hoang dã chụp một chú gấu trúc đỏ đang sử dụng máy tính xách tay trong khu rừng phủ đầy tuyết size: 1365x1024 style: bất kỳ summary: recraft_airecraft_v3_single description: Tạo tác vụ recraft-ai/recraft-v3 responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: PostReplicateV1ModelsRecraftAiRecraftV3PredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-30T01:45:30.496Z' data_removed: false id: w5k77rccg1rma0crb40tssh86g input: aspect_ratio: Chưa đặt prompt: >- một bức ảnh động vật hoang dã chụp một chú gấu trúc đỏ đang sử dụng máy tính xách tay trong khu rừng phủ đầy tuyết size: 1365x1024 style: bất kỳ logs: '' model: recraft-ai/recraft-v3 status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/w5k77rccg1rma0crb40tssh86g/cancel get: >- https://api.replicate.com/v1/predictions/w5k77rccg1rma0crb40tssh86g stream: >- Vui lòng truy xuất nội dung tại https://stream.replicate.com/v1/files/bcwr-otkjt5aiey7d63eore5rhoezsvrxwsc5q6ow2x5lpqh3l6x33hgq rồi dịch tài liệu kỹ thuật 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. web: https://replicate.com/p/w5k77rccg1rma0crb40tssh86g version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208957-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ recraft-ai/recraft-v3-svg" Nguồn: https://docs.openaihub.net/api-45208958/ > 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: /replicate/v1/models/recraft-ai/recraft-v3-svg/predictions: post: summary: Tạo tác vụ recraft-ai/recraft-v3-svg deprecated: false description: 'Tài liệu chính thức: https://replicate.com/recraft-ai/recraft-v3-svg' operationId: replicate_replicate_v1_models_recraft_ai_recraft_v3_svg_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Giá trị mặc định: "Chưa thiết lập" prompt: type: string description: Lời nhắc văn bản được tạo từ hình ảnh. size: type: string description: >- Tạo chiều rộng và chiều cao của hình ảnh. Nếu tỷ lệ khung hình được thiết lập, các kích thước sẽ bị bỏ qua. Giá trị mặc định: "1024x1024" style: type: string description: >- Phong cách của hình ảnh được tạo. Giá trị mặc định: "any" description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - prompt - size - style x-apidog-orders: - aspect_ratio - prompt - size - style x-apifox-orders: - input x-apidog-orders: - input examples: recraft_airecraft_v3_svg_single: value: input: aspect_ratio: Chưa đặt prompt: >- chân dung một chú gấu trúc đỏ dễ thương đang sử dụng máy tính xách tay, áp phích có tiêu đề "Gấu trúc đỏ là Recraft v3", trên nền màu đỏ size: 1024x1024 style: bất kỳ summary: recraft_airecraft_v3_svg_single description: Tạo tác vụ recraft-ai/recraft-v3-svg responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: PostReplicateV1ModelsRecraftAiRecraftV3SvgPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-30T01:49:55.839Z' data_removed: false id: 21r1gkwrzxrme0crb42tx4qrem input: aspect_ratio: Chưa đặt prompt: >- chân dung một chú gấu trúc đỏ dễ thương đang sử dụng máy tính xách tay, áp phích có tiêu đề "Gấu trúc đỏ là Recraft v3", trên nền màu đỏ size: 1024x1024 style: bất kỳ logs: '' model: recraft-ai/recraft-v3-svg status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/21r1gkwrzxrme0crb42tx4qrem/cancel get: >- https://api.replicate.com/v1/predictions/21r1gkwrzxrme0crb42tx4qrem stream: >- https://stream.replicate.com/v1/files/bcwr-7u7q63im74v2xjin5o7xj5prlfisac3m7ni22gh22jfejdfwi22q web: https://replicate.com/p/21r1gkwrzxrme0crb42tx4qrem version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208958-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ flux-kontext-apps/multi-image-kontext-max" Nguồn: https://docs.openaihub.net/api-45208959/ > 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: /replicate/v1/models/flux-kontext-apps/multi-image-kontext-max/predictions: post: summary: Tạo tác vụ flux-kontext-apps/multi-image-kontext-max deprecated: false description: >- Tài liệu chính thức: https://replicate.com/flux-kontext-apps/multi-image-kontext-max operationId: >- replicate_replicate_v1_models_flux_kontext_apps_multi_image_kontext_max_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt - input_image_1 - input_image_2 properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Dùng "match_input_image" để khớp với tỷ lệ khung hình của hình ảnh đầu vào. Mặc định: "match_input_image" input_image_1: type: string description: >- Hình ảnh đầu vào đầu tiên. Phải ở định dạng jpeg, png, gif hoặc webp. input_image_2: type: string description: >- Hình ảnh đầu vào thứ hai. Phải ở định dạng jpeg, png, gif hoặc webp. output_format: type: string description: >- Định dạng đầu ra của hình ảnh được tạo. Giá trị mặc định: "png". prompt: type: string description: >- Mô tả bằng văn bản về cách kết hợp hoặc biến đổi hai hình ảnh đầu vào. safety_tolerance: type: integer description: >- Mức dung sai bảo mật, 0 là nghiêm ngặt nhất và 2 là lỏng nhất. Hiện tại, 2 là mức tối đa được phép. Giá trị mặc định: 2 description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image_1 - input_image_2 - output_format - prompt - safety_tolerance x-apidog-orders: - aspect_ratio - input_image_1 - input_image_2 - output_format - prompt - safety_tolerance x-apifox-orders: - input x-apidog-orders: - input examples: flux_kontext_appsmulti_image_kontext_max_single: value: input: aspect_ratio: '1:1' input_image_1: >- Vui lòng tải trực tiếp ảnh lên cuộc trò chuyện để tôi có thể đọc và dịch nội dung, đồng thời giữ nguyên Markdown, mã nguồn, định danh, URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON và định dạng. input_image_2: >- https://replicate.delivery/pbxt/N5rSdTCgBqIRvbkedcfLfS5xTSEEOqMtX9FsR1hLK9JYryml/0_1.webp output_format: png prompt: Cho người phụ nữ mặc áo thun trắng có dòng chữ trên đó safety_tolerance: 2 summary: flux_kontext_appsmulti_image_kontext_max_single description: Tạo tác vụ flux-kontext-apps/multi-image-kontext-max responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object required: - aspect_ratio - input_image_1 - input_image_2 - output_format - prompt - safety_tolerance properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image_1: type: string description: Hình ảnh đầu vào 1 (URL hoặc Base64) input_image_2: type: string description: Hình ảnh đầu vào 2 (URL hoặc Base64) output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image_1 - input_image_2 - output_format - prompt - safety_tolerance x-apidog-orders: - aspect_ratio - input_image_1 - input_image_2 - output_format - prompt - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: >- PostReplicateV1ModelsFluxKontextAppsMultiImageKontextMaxPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-30T02:08:26.368Z' data_removed: false id: b6k38vmb01rme0crb4bbr2apw4 input: aspect_ratio: '1:1' input_image_1: >- Vui lòng tải trực tiếp ảnh lên cuộc trò chuyện để tôi có thể đọc và dịch nội dung, đồng thời giữ nguyên Markdown, mã nguồn, định danh, URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON và định dạng. input_image_2: >- https://replicate.delivery/pbxt/N5rSdTCgBqIRvbkedcfLfS5xTSEEOqMtX9FsR1hLK9JYryml/0_1.webp output_format: png prompt: Cho người phụ nữ mặc áo thun trắng có dòng chữ trên đó safety_tolerance: 2 logs: '' model: flux-kontext-apps/multi-image-kontext-max status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/b6k38vmb01rme0crb4bbr2apw4/cancel get: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập trực tiếp URL API này. stream: >- https://stream.replicate.com/v1/files/bcwr-4lncowbqyyr5toyxguv6tr47ffpade3muguvemzik5let3hnlryq web: >- Vui lòng dán nội dung tài liệu cần dịch vào đây; tôi không thể truy cập trực tiếp nội dung từ đường dẫn này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208959-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ flux-kontext-apps/multi-image-kontext-pro" Nguồn: https://docs.openaihub.net/api-45208960/ > 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: /replicate/v1/models/flux-kontext-apps/multi-image-kontext-pro/predictions: post: summary: Tạo tác vụ flux-kontext-apps/multi-image-kontext-pro deprecated: false description: >- Tai lieu chinh thuc: https://replicate.com/flux-kontext-apps/multi-image-kontext-pro operationId: >- replicate_replicate_v1_models_flux_kontext_apps_multi_image_kontext_pro_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt - input_image_1 - input_image_2 properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Dùng "match_input_image" để khớp với tỷ lệ khung hình của hình ảnh đầu vào. Mặc định: "match_input_image" input_image_1: type: string description: >- Hình ảnh đầu vào đầu tiên. Phải ở định dạng jpeg, png, gif hoặc webp. input_image_2: type: string description: >- Hình ảnh đầu vào thứ hai. Phải ở định dạng jpeg, png, gif hoặc webp. output_format: type: string description: >- Định dạng đầu ra của hình ảnh được tạo. Giá trị mặc định: "png". prompt: type: string description: >- Mô tả bằng văn bản về cách kết hợp hoặc biến đổi hai hình ảnh đầu vào. safety_tolerance: type: integer description: >- Mức dung sai bảo mật, 0 là nghiêm ngặt nhất và 2 là ít nghiêm ngặt nhất. Hiện tại, 2 là mức tối đa được phép. Giá trị mặc định: 2. description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image_1 - input_image_2 - output_format - prompt - safety_tolerance x-apidog-orders: - aspect_ratio - input_image_1 - input_image_2 - output_format - prompt - safety_tolerance x-apifox-orders: - input x-apidog-orders: - input examples: flux_kontext_appsmulti_image_kontext_pro_single: value: input: aspect_ratio: match_input_image input_image_1: >- https://replicate.delivery/pbxt/N7gRAUNcVF6HarL0hdAQA2JYNMlJD52LP1wyaIWRUXWeHzqT/0_1-1.webp input_image_2: >- https://replicate.delivery/pbxt/N7gRAK5kbPwdsbOpqgyAIOFQX45U6suTlbL6ws2N74SnGFpo/test.jpg output_format: png prompt: Đặt người phụ nữ bên cạnh ngôi nhà safety_tolerance: 2 summary: flux_kontext_appsmulti_image_kontext_pro_single description: Tạo tác vụ flux-kontext-apps/multi-image-kontext-pro responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: >- PostReplicateV1ModelsFluxKontextAppsMultiImageKontextProPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-30T02:15:51.786Z' data_removed: false id: 26t3agjpx9rme0crb4es5cbxx4 input: aspect_ratio: match_input_image input_image_1: >- https://replicate.delivery/pbxt/N7gRAUNcVF6HarL0hdAQA2JYNMlJD52LP1wyaIWRUXWeHzqT/0_1-1.webp input_image_2: >- https://replicate.delivery/pbxt/N7gRAK5kbPwdsbOpqgyAIOFQX45U6suTlbL6ws2N74SnGFpo/test.jpg output_format: png prompt: Đặt người phụ nữ bên cạnh ngôi nhà safety_tolerance: 2 logs: '' model: flux-kontext-apps/multi-image-kontext-pro status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/26t3agjpx9rme0crb4es5cbxx4/cancel get: >- https://api.replicate.com/v1/predictions/26t3agjpx9rme0crb4es5cbxx4 stream: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập trực tiếp URL này. web: >- Vui lòng dán nội dung tài liệu cần dịch vào đây. Tôi không thể truy cập nội dung từ liên kết đã cung cấp, nhưng sẽ giữ nguyên Markdown, mã, định danh, URL, đường dẫn, phần giữ chỗ, cấu trúc JSON và định dạng. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208960-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ riffusion/riffusion" Nguồn: https://docs.openaihub.net/api-45208961/ > 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: /replicate/v1/models/riffusion/riffusion/predictions: post: summary: Tạo tác vụ riffusion/riffusion deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp. operationId: replicate_replicate_v1_models_riffusion_riffusion_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object properties: alpha: type: number description: >- Nếu sử dụng hai gợi ý, alpha sẽ được nội suy. Giá trị 0 nghĩa là sử dụng hoàn toàn prompt_a, còn giá trị 1 nghĩa là sử dụng hoàn toàn prompt_b. Giá trị mặc định: 0.5. Giá trị tối thiểu: 0, giá trị tối đa: 1. denoising: type: number description: >- Mức độ biến đổi phổ tần đầu vào. Giá trị mặc định: 0.75. Giá trị nhỏ nhất: 0, giá trị lớn nhất: 1. num_inference_steps: type: integer description: >- Số bước chạy mô hình khuếch tán. Giá trị mặc định: 50. Tối thiểu: 1. prompt_a: type: string description: Lời nhắc bằng âm thanh. prompt_b: type: string description: >- Lời nhắc thứ hai được nội suy từ lời nhắc thứ nhất, hoặc để trống nếu không thực hiện nội suy. seed_image_id: type: string description: ID ảnh khởi tạo / ảnh tham chiếu description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - alpha - denoising - num_inference_steps - prompt_a - prompt_b - seed_image_id x-apidog-orders: - alpha - denoising - num_inference_steps - prompt_a - prompt_b - seed_image_id version: type: string description: Phiên bản refName: PostReplicateV1ModelsRiffusionRiffusionPredictionsRequest x-apifox-orders: - input - version x-apidog-orders: - input - version examples: riffusionriffusion_single: value: input: alpha: 0.5 denoising: 0.75 num_inference_steps: 50 prompt_a: đoạn độc tấu synthesizer phong cách funk prompt_b: nhạc rap thập niên 90 seed_image_id: cảm xúc version: >- 8cf61ea6c56afd61d8f5b9ffd14d7c216c0a93844ce2d82ac1c9ecc9c7f24e05 summary: riffusionriffusion_single description: Tạo tác vụ riffusion/riffusion responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: PostReplicateV1ModelsRiffusionRiffusionPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: '2': summary: '2' value: created_at: '2025-07-12T07:27:54.577Z' data_removed: false id: w44zs9cet5rmc0cqzp49gpkhf8 input: aspect_ratio: match_input_image input_image: >- Vui lòng tải ảnh lên trực tiếp hoặc dán nội dung tài liệu để tôi có thể dịch sang tiếng Việt và giữ nguyên định dạng Markdown, mã, định danh, URL, đường dẫn, chỗ giữ chỗ cùng cấu trúc JSON. output_format: jpg prompt: >- Làm cho các chữ cái có hiệu ứng 3D, lơ lửng trong không gian trên một con phố thành thị prompt_upsampling: false safety_tolerance: 2 logs: '' model: black-forest-labs/flux-kontext-dev status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8/cancel get: >- Vui lòng truy xuất nội dung tại https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8 rồi dịch tài liệu kỹ thuật đó sang tiếng Việt. Giữ nguyên Markdown, mã, định danh, URL, đường dẫn, chỗ dành sẵn, 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. stream: >- Vui lòng dán nội dung tài liệu vào đây để tôi có thể dịch sang tiếng Việt và giữ nguyên Markdown, mã nguồn, định danh, URL, đường dẫn, chỗ dành sẵn, cấu trúc JSON cùng định dạng. web: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập trực tiếp nội dung từ liên kết này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208961-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ black-forest-labs/flux-fill-dev" Nguồn: https://docs.openaihub.net/api-45208962/ > 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: /replicate/v1/models/black-forest-labs/flux-fill-dev/predictions: post: summary: Tạo tác vụ black-forest-labs/flux-fill-dev deprecated: false description: >- Tài liệu chính thức: https://replicate.com/black-forest-labs/flux-fill-dev operationId: >- replicate_replicate_v1_models_black_forest_labs_flux_fill_dev_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - image - prompt properties: guidance: type: integer description: >- Thông tin hướng dẫn tạo hình ảnh. Giá trị mặc định: 30. Giá trị tối thiểu: 0, giá trị tối đa: 100. image: type: string description: >- Hình ảnh cần được sửa chữa. Có thể bao gồm mặt nạ alpha. Nếu chiều rộng hoặc chiều cao của hình ảnh không phải là bội số của 32, hình ảnh sẽ được điều chỉnh theo bội số gần nhất của 32. Nếu kích thước hình ảnh vượt quá 1440x1440, hình ảnh sẽ được thu nhỏ để vừa trong giới hạn 1440x1440. lora_scale: type: integer description: >- Xác định cường độ áp dụng cho LoRA chính. Đối với suy luận cơ bản, giá trị hợp lý nằm trong khoảng từ 0 đến 1. Đối với go_fast, chúng tôi áp dụng hệ số nhân 1.5 lần cho giá trị này; thông thường, hiệu năng sẽ tốt khi nhân giá trị cơ sở với hệ số này. Bạn vẫn có thể cần thử nghiệm để tìm ra giá trị tốt nhất cho LoRA cụ thể của mình. Giá trị mặc định: 1. Giá trị nhỏ nhất: -1, giá trị lớn nhất: 3. mask: type: string description: >- Một hình ảnh đen trắng mô tả phần hình ảnh cần được khôi phục. Các vùng màu đen sẽ được giữ nguyên và các vùng màu trắng sẽ được sửa chữa. megapixels: type: string description: >- Số lượng pixel gần đúng của hình ảnh được tạo. Sử dụng match_input để khớp với kích thước của đầu vào (tối đa 1440x1440 pixel), mặc định: "1". num_inference_steps: type: integer description: >- Số bước khử nhiễu. Phạm vi khuyến nghị là 28-50; số bước càng ít thì chất lượng đầu ra càng thấp nhưng tốc độ càng nhanh. Giá trị mặc định: 28. Giá trị tối thiểu: 1, giá trị tối đa: 50. num_outputs: type: integer description: >- Số lượng đầu ra cần tạo. Giá trị mặc định: 1. Giá trị tối thiểu: 1, giá trị tối đa: 4. output_format: type: string description: 'Định dạng của hình ảnh đầu ra. Mặc định: "webp".' output_quality: type: integer description: >- Chất lượng lưu ảnh đầu ra, từ 0 đến 100. 100 là chất lượng tốt nhất, 0 là chất lượng thấp nhất. Không liên quan đến đầu ra .png. Mặc định: 80 prompt: type: string description: Lời nhắc để tạo hình ảnh. description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - guidance - image - lora_scale - mask - megapixels - num_inference_steps - num_outputs - output_format - output_quality - prompt x-apidog-orders: - guidance - image - lora_scale - mask - megapixels - num_inference_steps - num_outputs - output_format - output_quality - prompt x-apifox-orders: - input x-apidog-orders: - input examples: black_forest_labsflux_fill_dev_single: value: input: guidance: 30 image: >- https://replicate.delivery/pbxt/M0hxMJeO7wFCMr7QYNZsjRxzHhz6ntlLllMteRQNsRD7f3Nf/flux-fill-dev.webp lora_scale: 1 mask: >- https://replicate.delivery/pbxt/M0hxLu8a1YBcybWuumSsfoEec8ooer6JZ2fR28vuM1U0CN9m/74b40bb1-364a-461a-bec5-200a38c7bc87.png megapixels: '1' num_inference_steps: 28 num_outputs: 2 output_format: webp output_quality: 80 prompt: một con tàu vũ trụ summary: black_forest_labsflux_fill_dev_single description: Tạo tác vụ black-forest-labs/flux-fill-dev responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: >- PostReplicateV1ModelsBlackForestLabsFluxFillDevPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-30T03:03:25.864Z' data_removed: false id: tv3jnp73n1rmc0crb54b3srz94 input: guidance: 30 image: >- https://replicate.delivery/pbxt/M0hxMJeO7wFCMr7QYNZsjRxzHhz6ntlLllMteRQNsRD7f3Nf/flux-fill-dev.webp lora_scale: 1 mask: >- https://replicate.delivery/pbxt/M0hxLu8a1YBcybWuumSsfoEec8ooer6JZ2fR28vuM1U0CN9m/74b40bb1-364a-461a-bec5-200a38c7bc87.png megapixels: '1' num_inference_steps: 28 num_outputs: 1 output_format: webp output_quality: 80 prompt: một con tàu vũ trụ logs: '' model: black-forest-labs/flux-fill-dev status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/tv3jnp73n1rmc0crb54b3srz94/cancel get: >- https://api.replicate.com/v1/predictions/tv3jnp73n1rmc0crb54b3srz94 stream: >- Vui lòng dán nội dung tài liệu vào đây để tôi có thể dịch sang tiếng Việt mà vẫn giữ nguyên Markdown, mã, định danh, URL, đường dẫn, phần giữ chỗ, cấu trúc JSON và định dạng. web: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập nội dung từ URL này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208962-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ `black-forest-labs/flux-fill-pro`" Nguồn: https://docs.openaihub.net/api-45208963/ > 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: /replicate/v1/models/black-forest-labs/flux-fill-pro/predictions: post: summary: Tạo tác vụ `black-forest-labs/flux-fill-pro` deprecated: false description: >- Vui lòng dán nội dung tài liệu từ https://replicate.com/black-forest-labs/flux-fill-pro để tôi có thể dịch sang tiếng Việt và giữ nguyên Markdown, mã, định danh, URL, đường dẫn, phần giữ chỗ, cấu trúc JSON cùng định dạng. operationId: >- replicate_replicate_v1_models_black_forest_labs_flux_fill_pro_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - image - prompt properties: guidance: type: integer description: >- Kiểm soát sự cân bằng giữa mức độ tuân thủ lời nhắc văn bản và chất lượng/sự đa dạng của hình ảnh. Giá trị cao hơn giúp kết quả đầu ra bám sát lời nhắc hơn, nhưng có thể làm giảm chất lượng tổng thể của hình ảnh. Giá trị thấp hơn mang lại nhiều tự do sáng tạo hơn cho kết quả đầu ra, nhưng có thể ít liên quan hơn đến lời nhắc. Giá trị mặc định: 60. Giá trị tối thiểu: 1.5, giá trị tối đa: 100. image: type: string description: >- Các hình ảnh cần được sửa chữa. Có thể bao gồm mặt nạ alpha. Phải ở định dạng jpeg, png, gif hoặc webp. mask: type: string description: >- Một hình ảnh đen trắng mô tả phần hình ảnh cần được phục hồi. Các vùng màu đen sẽ được giữ nguyên và các vùng màu trắng sẽ được sửa chữa. Hình này phải có cùng kích thước với hình ảnh. Tham số này là tùy chọn nếu bạn đã cung cấp mặt nạ alpha trong hình ảnh gốc. Hình phải có định dạng jpeg, png, gif hoặc webp. outpaint: type: string description: >- Các tùy chọn để sửa nhanh hình ảnh đầu vào. Mặt nạ sẽ bị bỏ qua. Giá trị mặc định: "None" output_format: type: string description: 'Định dạng của hình ảnh đầu ra. Giá trị mặc định: "jpg".' prompt: type: string description: Lời nhắc văn bản được tạo từ hình ảnh. prompt_upsampling: type: boolean description: >- Tự động sửa đổi câu lệnh để tạo thêm nhiều ý tưởng. Giá trị mặc định: false safety_tolerance: type: integer description: >- Mức dung sai bảo mật, trong đó 1 là nghiêm ngặt nhất và 6 là lỏng lẻo nhất. Giá trị mặc định: 2. steps: type: integer description: >- Số bước khuếch tán. Giá trị cao hơn cung cấp chi tiết tinh tế hơn, nhưng cũng mất nhiều thời gian xử lý hơn. Giá trị mặc định: 50. Giá trị tối thiểu: 15, giá trị tối đa: 50. description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - guidance - image - mask - outpaint - output_format - prompt - prompt_upsampling - safety_tolerance - steps x-apidog-orders: - guidance - image - mask - outpaint - output_format - prompt - prompt_upsampling - safety_tolerance - steps x-apifox-orders: - input x-apidog-orders: - input examples: black_forest_labsflux_fill_pro_single: value: input: guidance: 60 image: >- https://replicate.delivery/pbxt/M0gpKVE9wmEtOQFNDOpwz1uGs0u6nK2NcE85IihwlN0ZEnMF/kill-bill-poster.jpg mask: >- https://replicate.delivery/pbxt/M0gpLCYdCLbnhcz95Poy66q30XW9VSCN65DoDQ8IzdzlQonw/kill-bill-mask.png outpaint: Không có output_format: jpg prompt: áp phích phim ghi "FLUX FILL" prompt_upsampling: false safety_tolerance: 2 steps: 50 summary: black_forest_labsflux_fill_pro_single description: Tạo tác vụ `black-forest-labs/flux-fill-pro` responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: >- PostReplicateV1ModelsBlackForestLabsFluxFillProPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-30T03:10:33.786Z' data_removed: false id: w72vtvbb79rmc0crb57tckqt24 input: guidance: 60 image: >- https://replicate.delivery/pbxt/M0gpKVE9wmEtOQFNDOpwz1uGs0u6nK2NcE85IihwlN0ZEnMF/kill-bill-poster.jpg mask: >- https://replicate.delivery/pbxt/M0gpLCYdCLbnhcz95Poy66q30XW9VSCN65DoDQ8IzdzlQonw/kill-bill-mask.png outpaint: Không có output_format: jpg prompt: áp phích phim ghi "FLUX FILL" prompt_upsampling: false safety_tolerance: 2 steps: 50 logs: '' model: black-forest-labs/flux-fill-pro status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/w72vtvbb79rmc0crb57tckqt24/cancel get: >- https://api.replicate.com/v1/predictions/w72vtvbb79rmc0crb57tckqt24 stream: >- Vui lòng dán nội dung tài liệu cần dịch vào đây; tôi không thể truy cập trực tiếp tệp từ URL này. web: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập nội dung từ đường dẫn này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208963-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ google/imagen-4-fast" Nguồn: https://docs.openaihub.net/api-45208964/ > 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: /replicate/v1/models/google/imagen-4-fast/predictions: post: summary: Tạo tác vụ google/imagen-4-fast deprecated: false description: 'Tài liệu chính thức: https://replicate.com/google/imagen-4-fast' operationId: replicate_replicate_v1_models_google_imagen_4_fast_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Giá trị mặc định: "1:1". output_format: type: string description: 'Định dạng của hình ảnh đầu ra. Giá trị mặc định: "jpg".' prompt: type: string description: Lời nhắc văn bản được tạo từ hình ảnh. safety_filter_level: type: string description: >- block_low_and_above là mức nghiêm ngặt nhất, block_medium_and_above sẽ chặn một số lời nhắc, còn block_only_high là mức ít nghiêm ngặt nhất, nhưng một số lời nhắc vẫn sẽ bị chặn. Giá trị mặc định: "block_only_high" description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - output_format - prompt - safety_filter_level x-apidog-orders: - aspect_ratio - output_format - prompt - safety_filter_level x-apifox-orders: - input x-apidog-orders: - input examples: googleimagen_4_fast_single: value: input: aspect_ratio: '4:3' output_format: jpg prompt: >- Bức ảnh: Tạo một cảnh quay trung cảnh đậm chất điện ảnh, chân thực như ảnh chụp, ghi lại nguồn năng lượng cuốn hút của một bộ phim hành động đầy kịch tính. Tâm điểm là một cô gái trẻ có mái tóc sẫm màu tung bay trong gió, điểm những lọn tóc màu hồng, cùng nét mặt đầy quyết tâm; cô nhìn thẳng và chăm chú vào ống kính máy ảnh, với vị trí hơi lệch khỏi trung tâm. Cô mặc một chiếc áo khoác đua xe ôm sát màu hồng và vàng bên ngoài áo ba lỗ màu đen, trên ngực in dòng chữ "Imagen 4 Fast" theo kiểu chữ gợi chuyển động và ở dòng kế tiếp là "on Replicate", đồng thời đeo kính phi công được đẩy lên trên đầu. Ánh sáng đầy kịch tính với các vệt nhòe do chuyển động và ánh neon phản chiếu từ đèn thành phố lướt qua, tạo nên những quầng lóe trong ống kính và các vệt sáng sống động (chúng không che khuôn mặt cô). Phông nền cho thấy cảnh đô thị ban đêm bị làm nhòe, với những vệt đèn pha ô tô và các tòa nhà chọc trời rực sáng lao vụt qua, được thể hiện bằng hiệu ứng nhòe chuyển động mạnh và độ sâu trường ảnh nông. Ánh sáng có độ tương phản cao, bảng màu neon rực rỡ với sắc xanh lam đậm và vàng điện, cùng đôi mắt mãnh liệt của cô được lấy nét sắc như dao, làm nổi bật bầu không khí dồn dập và đầy phấn khích. Cô được chiếu sáng trong khi phông nền tối hơn. safety_filter_level: block_only_high summary: googleimagen_4_fast_single description: Tạo tác vụ google/imagen-4-fast responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: PostReplicateV1ModelsGoogleImagen4FastPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: '[long payload omitted: 1,953 units]' 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208964-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ google/imagen-4-ultra" Nguồn: https://docs.openaihub.net/api-45208965/ > 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: /replicate/v1/models/google/imagen-4-ultra/predictions: post: summary: Tạo tác vụ google/imagen-4-ultra deprecated: false description: 'Tài liệu chính thức: https://replicate.com/google/imagen-4-ultra' operationId: replicate_replicate_v1_models_google_imagen_4_ultra_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Giá trị mặc định: "1:1". output_format: type: string description: 'Định dạng của ảnh đầu ra. Mặc định: "jpg"' prompt: type: string description: Lời nhắc văn bản được tạo từ hình ảnh. safety_filter_level: type: string description: >- block_low_and_above là mức nghiêm ngặt nhất, block_medium_and_above sẽ chặn một số lời nhắc, còn block_only_high là mức ít nghiêm ngặt nhất, nhưng một số lời nhắc vẫn sẽ bị chặn. Giá trị mặc định: "block_only_high" description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - output_format - prompt - safety_filter_level x-apidog-orders: - aspect_ratio - output_format - prompt - safety_filter_level x-apifox-orders: - input x-apidog-orders: - input examples: googleimagen_4_ultra_single: value: input: aspect_ratio: '16:9' output_format: jpg prompt: >- Bức ảnh: Tạo một cảnh quay trung cảnh đậm chất điện ảnh, chân thực như ảnh chụp, tái hiện sự ấm áp hoài niệm của một bộ phim độc lập giữa thập niên 2000. Chủ thể là một cô gái trẻ có mái tóc bob thẳng, bóng mượt, màu trắng bạch kim lạnh và làn da có tàn nhang, đang nhìn thẳng và chăm chú vào ống kính máy ảnh với nụ cười nhếch đầy ẩn ý, đầu cô hơi ngẩng lên. Cô mặc một chiếc áo thun ban nhạc dáng rộng có dòng chữ "Imagen 4 Ultra on Replicate" thật lớn với kiểu chữ cách điệu bên ngoài một chiếc áo dài tay kẻ sọc, cùng đôi khuyên tai bạc nhỏ đơn giản. Ánh sáng là nắng vàng dịu nhẹ lúc hoàng hôn, tạo hiệu ứng lóe sáng ống kính và làm các hạt bụi trong không khí bừng sáng. Phông nền là một khung cảnh đô thị ngoài trời được làm mờ với những bức tường phủ đầy hình vẽ graffiti (dòng graffiti ghi "ultra" bằng kiểu chữ graffiti cách điệu), được thể hiện với độ sâu trường ảnh nông. Hạt phim tự nhiên, bảng màu ấm và hơi trầm, cùng độ nét tập trung vào đôi mắt giàu biểu cảm của cô làm tăng cảm giác gần gũi, chân thực. safety_filter_level: block_only_high summary: googleimagen_4_ultra_single description: Tạo tác vụ google/imagen-4-ultra responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: PostReplicateV1ModelsGoogleImagen4UltraPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: '[long payload omitted: 1,759 units]' 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208965-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ google/imagen-4" Nguồn: https://docs.openaihub.net/api-45208966/ > 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: /replicate/v1/models/google/imagen-4/predictions: post: summary: Tạo tác vụ google/imagen-4 deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ đường dẫn đã cung cấp. operationId: replicate_replicate_v1_models_google_imagen_4_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình của hình ảnh được tạo. Giá trị mặc định: "1:1". Hỗ trợ: 1:1, 9:16, 16:9, 3:4, 4:3 output_format: type: string description: 'Định dạng của hình ảnh đầu ra. Giá trị mặc định: "jpg".' prompt: type: string description: Lời nhắc văn bản được tạo từ hình ảnh. safety_filter_level: type: string description: >- block_low_and_above là mức nghiêm ngặt nhất, block_medium_and_above sẽ chặn một số lời nhắc, còn block_only_high là mức ít nghiêm ngặt nhất, nhưng một số lời nhắc vẫn sẽ bị chặn. Giá trị mặc định: "block_only_high" description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - output_format - prompt - safety_filter_level x-apidog-orders: - aspect_ratio - output_format - prompt - safety_filter_level x-apifox-orders: - input x-apidog-orders: - input examples: googleimagen_4_single: value: input: aspect_ratio: '16:9' output_format: jpg prompt: >- Bức ảnh: Tạo một cảnh quay trung cảnh đậm chất điện ảnh, chân thực như ảnh chụp, tái hiện sự ấm áp hoài niệm của một bộ phim độc lập cuối thập niên 90. Tâm điểm là một cô gái trẻ có mái tóc nhuộm màu vàng hồng rực rỡ và làn da đầy tàn nhang, đang nhìn thẳng và chăm chú vào ống kính với nụ cười đầy hy vọng nhưng hơi thiếu chắc chắn; cô đứng hơi lệch khỏi trung tâm. Cô mặc một chiếc áo thun ban nhạc cổ điển dáng rộng có dòng chữ "Replicate" (hơi sờn) bên ngoài áo dài tay kẻ sọc, cùng đôi khuyên tai bạc dạng đinh đơn giản. Ánh sáng là nắng dịu nhẹ màu vàng vào giờ hoàng kim, chiếu xuyên qua một ô cửa sổ hơi bám bụi, tạo hiệu ứng lóe sáng ống kính và làm nổi bật những hạt bụi lơ lửng trong không khí. Phông nền là một phòng ngủ bừa bộn được làm mờ, với áp phích trên tường và dây đèn trang trí, được thể hiện bằng độ sâu trường ảnh nông. Hạt phim tự nhiên, bảng màu ấm và hơi trầm, cùng độ nét tập trung vào đôi mắt giàu biểu cảm của cô làm tăng thêm cảm giác thân mật, chân thực. safety_filter_level: block_medium_and_above summary: googleimagen_4_single description: Tạo tác vụ google/imagen-4 responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object required: - aspect_ratio - output_format - prompt - safety_filter_level properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản safety_filter_level: type: string description: Mức bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - output_format - prompt - safety_filter_level x-apidog-orders: - aspect_ratio - output_format - prompt - safety_filter_level logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: PostReplicateV1ModelsGoogleImagen4PredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: '[long payload omitted: 1,747 units]' 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208966-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ prunaai/vace-14b" Nguồn: https://docs.openaihub.net/api-45208967/ > 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: /replicate/v1/models/prunaai/vace-14b/predictions: post: summary: Tạo tác vụ prunaai/vace-14b deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp. operationId: replicate_replicate_v1_models_prunaai_vace_14b_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: frame_num: type: integer description: 'Số lượng khung hình cần tạo. Giá trị mặc định: 81.' prompt: type: string description: Mô tả văn bản. sample_guide_scale: 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, chỗ dành sẵn, cấu trúc JSON và định dạng. Chỉ trả về văn bản đã dịch và không để lại bất kỳ chữ Hán nào. Thang hướng dẫn mẫu. Giá trị mặc định: 5 sample_shift: type: integer description: 'Độ lệch mẫu. Mặc định: 16' sample_solver: type: string description: 'Bộ giải lấy mẫu. Mặc định: "unipc"' sample_steps: type: integer description: 'Các bước ví dụ. Giá trị mặc định: 50' seed: type: integer description: Hạt giống ngẫu nhiên (-1 nghĩa là ngẫu nhiên) size: type: string description: 'Độ phân giải đầu ra. Giá trị mặc định: "832*480"' speed_mode: type: string description: >- Mức độ tối ưu hóa tốc độ. Mặc định: "Ép nhẹ 🍊 (ổn định hơn)" src_mask: type: string description: Nhập video hoặc hình ảnh đã che mà bạn muốn chỉnh sửa. src_ref_images: type: array items: type: string description: Nhập một hình ảnh tham chiếu để chỉnh sửa. src_video: type: string description: Nhập video bạn muốn chỉnh sửa. description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - frame_num - prompt - sample_guide_scale - sample_shift - sample_solver - sample_steps - seed - size - speed_mode - src_mask - src_ref_images - src_video x-apidog-orders: - frame_num - prompt - sample_guide_scale - sample_shift - sample_solver - sample_steps - seed - size - speed_mode - src_mask - src_ref_images - src_video version: type: string description: Phiên bản refName: PostReplicateV1ModelsPrunaaiVace14bPredictionsRequest x-apifox-orders: - input - version x-apidog-orders: - input - version examples: prunaaivace_14b_single: value: input: frame_num: 81 prompt: >- Video cho thấy một người đàn ông cưỡi ngựa trên một thảo nguyên rộng lớn. Anh ấy có mái tóc dài màu tím oải hương và mặc trang phục truyền thống gồm áo trắng và quần đen. Phong cách hoạt hình khiến anh ấy trông như đang tham gia một hoạt động ngoài trời hoặc biểu diễn. Phía sau là dãy núi hùng vĩ cùng bầu trời đầy mây, tạo cảm giác yên bình và bao la. Toàn bộ video được quay từ một góc máy cố định, tập trung vào người cưỡi và con ngựa của anh ấy. sample_guide_scale: 5 sample_shift: 16 sample_solver: unipc sample_steps: 50 seed: -1 size: 1280*720 speed_mode: Tăng tốc cực đại 🚀 (nhanh hơn nữa) src_mask: >- https://replicate.delivery/pbxt/N323tegI7AuoZmg0U5CuTKa7VBFC4gymhe0kT8Jk3o2sjUUj/src_mask.mp4 src_ref_images: - >- https://replicate.delivery/pbxt/N323t5X69JB1MPD4w4cDIxK4rm0BG0W2JOWBrDrR4O9HTcyp/src_ref_image_1.png src_video: >- https://replicate.delivery/pbxt/N323u1ljtNYyyaLrgw0ZLmXgepvWlBvxbJWi3sAa2VDPuNus/src_video.mp4 version: >- 51299232dc3d0946d5f5ed74935d85243e172698f747d291460db1e6ef3669fb summary: prunaaivace_14b_single description: Tạo tác vụ prunaai/vace-14b responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: PostReplicateV1ModelsPrunaaiVace14bPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: '2': summary: '2' value: created_at: '2025-07-12T07:27:54.577Z' data_removed: false id: w44zs9cet5rmc0cqzp49gpkhf8 input: aspect_ratio: match_input_image input_image: >- Vui lòng tải ảnh lên trực tiếp hoặc dán nội dung tài liệu để tôi có thể dịch sang tiếng Việt và giữ nguyên định dạng Markdown, mã, định danh, URL, đường dẫn, chỗ giữ chỗ cùng cấu trúc JSON. output_format: jpg prompt: >- Làm cho các chữ cái có hiệu ứng 3D, lơ lửng trong không gian trên một con phố thành thị prompt_upsampling: false safety_tolerance: 2 logs: '' model: black-forest-labs/flux-kontext-dev status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8/cancel get: >- Vui lòng truy xuất nội dung tại https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8 rồi dịch tài liệu kỹ thuật đó sang tiếng Việt. Giữ nguyên Markdown, mã, định danh, URL, đường dẫn, chỗ dành sẵn, 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. stream: >- Vui lòng dán nội dung tài liệu vào đây để tôi có thể dịch sang tiếng Việt và giữ nguyên Markdown, mã nguồn, định danh, URL, đường dẫn, chỗ dành sẵn, cấu trúc JSON cùng định dạng. web: >- Vui lòng dán nội dung tài liệu cần dịch; tôi không thể truy cập trực tiếp nội dung từ liên kết này. version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208967-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ ideogram-ai/ideogram-v2-turbo" Nguồn: https://docs.openaihub.net/api-45208968/ > 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: /replicate/v1/models/ideogram-ai/ideogram-v2-turbo/predictions: post: summary: Tạo tác vụ ideogram-ai/ideogram-v2-turbo deprecated: false description: >- Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể truy cập trực tiếp nội dung từ URL đã cung cấp. operationId: replicate_replicate_v1_models_ideogram_ai_ideogram_v2_turbo_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: - 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: input: type: object required: - prompt properties: aspect_ratio: type: string description: >- Tỷ lệ khung hình. Bị bỏ qua nếu độ phân giải hoặc hình ảnh sửa chữa được chỉ định. Giá trị mặc định: "1:1". magic_prompt_option: type: string description: >- Magic Prompt diễn giải các câu lệnh của bạn và tối ưu hóa chúng để tăng tối đa sự đa dạng và chất lượng của những hình ảnh tạo ra. Bạn cũng có thể dùng tính năng này để viết câu lệnh bằng nhiều ngôn ngữ khác nhau. Giá trị mặc định: "Tự động". prompt: type: string description: Lời nhắc văn bản được tạo từ hình ảnh. resolution: type: string description: >- độ phân giải. Tỷ lệ khung hình phủ kín. Nếu một hình ảnh sửa chữa được chỉ định, tham số này sẽ bị bỏ qua. Giá trị mặc định: "Không có". style_type: type: string description: >- Phong cách giúp xác định diện mạo thẩm mỹ cụ thể của hình ảnh bạn muốn tạo ra. Giá trị mặc định: "Không có". description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - magic_prompt_option - prompt - resolution - style_type x-apidog-orders: - aspect_ratio - magic_prompt_option - prompt - resolution - style_type x-apifox-orders: - input x-apidog-orders: - input examples: ideogram_aiideogram_v2_turbo_single: value: input: aspect_ratio: '1:1' magic_prompt_option: Tự động prompt: >- Hình minh họa một chiếc giày chạy bộ màu vàng với dòng chữ "Chạy AI bằng API" được viết trên giày. Chiếc giày được đặt trên nền màu hồng. Dòng chữ có màu trắng và in đậm. Tổng thể hình ảnh mang phong cách hiện đại, đậm chất công nghệ, với các yếu tố gợi lên tốc độ. resolution: Không có style_type: Không có summary: ideogram_aiideogram_v2_turbo_single description: Tạo tác vụ ideogram-ai/ideogram-v2-turbo responses: '200': description: '' content: application/json: schema: type: object required: - id - status properties: created_at: type: string description: Thời gian tạo data_removed: type: boolean description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa error: type: string description: Thông báo lỗi nullable: true id: type: string description: ID tài nguyên hoặc tác vụ input: type: object properties: aspect_ratio: type: string description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1' input_image: type: string description: URL hình ảnh đầu vào hoặc Base64 output_format: type: string description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp' prompt: type: string description: Lời nhắc văn bản prompt_upsampling: type: boolean description: Có tăng độ phân giải / cải thiện lời nhắc hay không safety_tolerance: type: integer description: Mức dung sai của bộ lọc an toàn description: Vui lòng cung cấp nội dung tài liệu cần dịch. x-apifox-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance x-apidog-orders: - aspect_ratio - input_image - output_format - prompt - prompt_upsampling - safety_tolerance logs: type: string description: Nhật ký chạy model: type: string description: Tên mô hình / mã định danh mô hình output: type: string description: Kết quả đầu ra nullable: true status: type: string description: Trạng thái urls: type: object required: - cancel - get - stream - web properties: cancel: type: string description: URL để hủy tác vụ get: type: string description: URL để truy vấn trạng thái tác vụ stream: type: string description: Có truyền phát phản hồi hay không web: type: string description: URL để xem tác vụ trong trình duyệt description: Danh sách URL tài nguyên x-apifox-orders: - cancel - get - stream - web x-apidog-orders: - cancel - get - stream - web version: type: string description: Phiên bản refName: >- PostReplicateV1ModelsIdeogramAiIdeogramV2TurboPredictionsResponse x-apifox-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version x-apidog-orders: - created_at - data_removed - error - id - input - logs - model - output - status - urls - version examples: example: summary: example value: created_at: '2025-07-29T09:37:36.685Z' data_removed: false id: 2jycc2v9nnrmc0crap5tv5zaxr input: aspect_ratio: '1:1' magic_prompt_option: Tự động prompt: >- Hình minh họa một chiếc giày chạy bộ màu vàng với dòng chữ "Chạy AI bằng API" được viết trên giày. Chiếc giày được đặt trên nền màu hồng. Dòng chữ có màu trắng và in đậm. Tổng thể hình ảnh mang phong cách hiện đại, đậm chất công nghệ, với các yếu tố gợi lên tốc độ. resolution: Không có style_type: Không có logs: '' model: ideogram-ai/ideogram-v2-turbo status: starting urls: cancel: >- https://api.replicate.com/v1/predictions/2jycc2v9nnrmc0crap5tv5zaxr/cancel get: >- https://api.replicate.com/v1/predictions/2jycc2v9nnrmc0crap5tv5zaxr stream: >- Vui lòng dán nội dung tài liệu vào đây để tôi dịch sang tiếng Việt và giữ nguyên Markdown, mã nguồn, định danh, URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON và định dạng. web: https://replicate.com/p/2jycc2v9nnrmc0crap5tv5zaxr version: ẩn 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208968-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ``` --- # "Tạo tác vụ bytedance/seedream-4" Nguồn: https://docs.openaihub.net/api-45208969/ > 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: /replicate/v1/models/bytedance/seedream-4/predictions: post: summary: Tạo tác vụ bytedance/seedream-4 deprecated: false description: >- Gửi một yêu cầu dự đoán chuyển văn bản thành hình ảnh bằng ByteDance Seedream 4; trả về mã định danh dự đoán để thăm dò. operationId: replicate_replicate_v1_models_bytedance_seedream_4_predictions tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao - Tái tạo parameters: [] requestBody: content: application/json: schema: type: object x-apidog-orders: [] examples: bytedanceseedream_4_single: value: input: aspect_ratio: '4:3' height: 2048 image_input: [] max_images: 2 prompt: >- một bức ảnh chụp mặt tiền một cửa hàng có tên i"sedream 4", cửa hàng bán sách, một áp phích trên cửa sổ ghi i"sedream 4 hiện đã có trên Replicate! sequential_image_generation: tự động size: 2K width: 2048 summary: bytedanceseedream_4_single description: Tạo tác vụ bytedance/seedream-4 responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: request_id: req_example status: OK 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/Hình ảnh/Tổng hợp bản sao x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208969-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-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: [] ``` --- # "Bảng so sánh nhóm API" Nguồn: https://docs.openaihub.net/api-groups/ > Các nhóm và hệ số dưới đây áp dụng cho OpenAiHub theo chính sách hiện hành đã được xác nhận. Hệ số là tỷ lệ tính phí, không phải cam kết tốc độ hoặc chất lượng. > Lưu ý khi đọc: bảng nguồn có một số nhãn trùng và mô tả hỗ trợ chưa đồng nhất. Giữ nguyên số liệu để đối chiếu; nếu các cột mâu thuẫn, xác nhận với [CSKH](https://t.me/muataikhoan_sp) trước khi chọn nhóm. Các mô tả về hiệu năng, kiểm duyệt và nguồn kênh không phải SLA đã kiểm chứng. ## 🧩 Loại nhóm & Đặc điểm | Nhóm | Loại | Tỷ lệ sử dụng | Mô hình được hỗ trợ | |----------------------|---------------------------------------------------------------------------|-------------------------|-------------------------------------| | Mặc định | Kết hợp ChatGPT (kênh AZ) + Claude (kênh relay) + MJ (mô hình nhanh) + Mô hình AI Trung Quốc (Doubao + DeepSeek + Qwen) | Tỷ lệ chính thức ×1 | OpenAI, Claude, mô hình nội địa Trung Quốc | | Gemini Cao cấp | Gemini (mô hình kênh Google) | Tỷ lệ chính thức ×1 | Gemini | | Gemini Chính thức | Gemini (mô hình kênh Google), rẻ hơn (nhiều tài khoản hơn, chi phí thấp hơn) | Tỷ lệ chính thức ×3 | Gemini | | Azure Thuần | Chỉ ChatGPT (kênh AZ) + mô hình nội địa | Tỷ lệ chính thức ×1.5 | OpenAI, mô hình nội địa | | Relay Chính thức | ChatGPT (kênh AZ + kênh ngược) + mô hình nội địa Trung Quốc (ưu tiên AZ, relay chỉ dùng dự phòng) | Tỷ lệ chính thức ×3 | OpenAI, mô hình nội địa Trung Quốc | | OpenAI Cao cấp | ChatGPT (mô hình kênh relay OpenAI chính thức) | Tỷ lệ chính thức ×6 | OpenAI | | Ưu tiên Relay OpenAI | ChatGPT (mô hình kênh relay OpenAI chính thức), giá cao hơn (nhiều tài khoản hơn) | Tỷ lệ chính thức ×8 | OpenAI | | Proxy Ngược | Hỗ trợ GPT + Claude + Gemini + Grok | Tỷ lệ chính thức ×1.4 | OpenAI, Claude | | Ưu đãi có thời hạn | Hỗ trợ mô hình nội địa Trung Quốc (Doubao + DeepSeek + Qwen) | Tỷ lệ chính thức ×0.6 | Gemini, mô hình nội địa | | Claude Chính thức 2 | Claude (kênh relay AWS) | Tỷ lệ chính thức ×6 | Claude | | Claude Chính thức 3 | Claude (kênh relay AWS + Anthropic) | Tỷ lệ chính thức ×12 | Claude | | Claude Trực tiếp | Claude (kênh relay Anthropic) | Tỷ lệ chính thức ×16 | Claude | | Dành riêng Claude Code | Claude code | Tỷ lệ chính thức ×1.5 | Claude code | --- ## ⚖️ So sánh ưu/nhược điểm | Nhóm | Proxy Ngược | Mặc định | AZ | Relay Chính thức | OpenAI Cao cấp | Gemini Cao cấp | Gemini Chính thức | Claude Chính thức | Claude Trực tiếp | |--------------------------|-----------------|---------------------|-------------------|----------------------|------------------------------|----------------|---------------------|---------------------|-------------------| | **Đặc điểm** | ChatGPT chính thức, cập nhật nhanh, giá tốt, nhưng gọi API phức tạp. Có thể hiển thị cùng tên mô hình nhưng phiên bản ước tính khác nhau. | ChatGPT chính thức, cập nhật nhanh, giá rõ ràng | Kênh AZ, dự phòng đầy đủ, dung lượng cao, tốc độ cao, ổn định, hỗ trợ FC & TC | Tốc độ nhanh, dung lượng cao, không giới hạn tốc độ, hỗ trợ FC & TC | ChatGPT chính thức, tốc độ nhanh, dung lượng cao, nhiều tài khoản, ổn định hơn | Gemini chính thức, thông minh hơn, giá tốt, dung lượng cao, ổn định | Gemini chính thức, giá tốt hơn, dung lượng cao hơn, nhiều tài khoản hơn | Từ AWS + Anthropic, kênh mượt, dự phòng đầy đủ, dung lượng cao, tốc độ cao | Từ Anthropic chính thức, nhiều tài khoản hơn, ổn định hơn | | **Nhược điểm** | Không phải giao diện chính thức | Không phải giao diện chính thức | Đôi khi bị giới hạn tốc độ qua Azure | Bị ảnh hưởng bởi độ ổn định API chính thức | Bị ảnh hưởng bởi độ ổn định API chính thức | Bị ảnh hưởng bởi độ ổn định API chính thức | Chi phí cao hơn, tỷ lệ sử dụng nhân, bị ảnh hưởng bởi độ ổn định API chính thức | Bị ảnh hưởng bởi độ ổn định API chính thức | Bị ảnh hưởng bởi độ ổn định API chính thức | | **Ghi chú** | Chủ yếu dùng cho tác vụ truy cập tần suất cao (ví dụ: say1, benchmark...) | Kênh relay, kênh chính thức | Dùng xác thực doanh nghiệp Azure, hỗ trợ FC & TC. TC hỗ trợ 1000w tpm. Công khai dùng OpenAI làm mô phỏng | Tất cả dùng kênh OpenAI chính thức, hỗ trợ FC & TC, 1000w tpm, dùng tài khoản OpenAI lớn, đã phát hành | Dùng kênh OpenAI chính thức, hỗ trợ FC & TC, 1000w tpm, tài khoản OpenAI lớn, đã phát hành | Dùng Google API chính thức, nhiều tài khoản, giá cao | Dùng Google API chính thức, nhiều tài khoản, giá cao | Dùng kênh chính thức, hỗ trợ gọi Claude code, tài khoản lớn, giá cao | Dùng kênh chính thức, hỗ trợ gọi Claude code, tài khoản lớn, giá cao | --- ## ✅ Hỗ trợ mô hình | Mô hình | Proxy Ngược | Mặc định | Azure | Proxy Ngược | | --------------------- | ------------------- | -------- | -------- | ------------ | | GPT-4 | ✅ Đầy đủ | ✅ Đầy đủ | ✅ Đầy đủ | ✅ Đầy đủ | | GPT-3.5 | ✅ Đầy đủ | ✅ Đầy đủ | ✅ Đầy đủ | ✅ Đầy đủ | | Các mô hình OpenAI khác | ✅ | ✅ | ✅ | ✅ | | Midjourney (tạo ảnh) | ❌ | ✅ | ❌ | ❌ | | Claude | ✅ qua proxy ngược | ❌ | ❌ | ✅ proxy ngược | | Gemini | ✅ proxy ngược | ✅ | ✅ | ✅ chính thức | --- ## ✅ Giải thích các kênh được đề cập: | Tên kênh | Giải thích đơn giản | | -------------------------------------- | ----------------------------------------------------------------------------- | | **Kênh Relay ChatGPT Chính thức** | Dịch vụ cung cấp trực tiếp từ trang chủ OpenAI (openai.com). | | **Kênh AZ (Azure)** | Dịch vụ ChatGPT chạy trên nền tảng điện toán đám mây Microsoft Azure. | | **Kênh Google Gemini** | Mô hình Gemini được cung cấp qua dịch vụ của Google. | | **Mô hình nội địa** | Các mô hình AI được phát triển bởi các công ty nội địa (Trung Quốc). | | **Claude qua AWS** | Mô hình Claude được cung cấp qua cơ sở hạ tầng Amazon Web Services (AWS). | | **Claude qua Anthropic** | Mô hình Claude truy cập trực tiếp từ hệ thống chính thức của Anthropic. | ## 📌 Lưu ý * **Proxy Ngược**: Không chính thức, rẻ, có thể thay đổi do phụ thuộc vào reverse-engineering * **Azure**: Chính thức nhưng không kiểm duyệt, phù hợp cho hệ thống tải cao * **Relay Chính thức**: Dùng tài khoản OpenAI thực, độ ổn định cao nhưng giá cao hơn * Người dùng có thể **chọn nhóm API** khi tạo token trên trang quản lý tài khoản --- # API key & bảo mật Nguồn: https://docs.openaihub.net/api-keys/ ## Lấy API key Đăng nhập [OpenAiHub](https://openaihub.net). Tìm phần quản lý API key/token trong bảng điều khiển và làm theo hướng dẫn trên giao diện. Nếu tài khoản chưa có quyền tạo key, liên hệ [hỗ trợ](https://t.me/muataikhoan_sp). Tên menu và tùy chọn có thể thay đổi theo tài khoản. Không cần chia sẻ mật khẩu hoặc mã OTP để được hướng dẫn. ## Sử dụng phía máy chủ Với API tương thích OpenAI, truyền key trong header: ```http Authorization: Bearer YOUR_API_KEY ``` `YOUR_API_KEY` là placeholder. Đọc key từ biến môi trường hoặc kho bí mật của hệ thống, không viết thẳng vào source code. - Không đặt key vào frontend, app public hoặc URL query. - Không gửi key vào ChatGPT, Claude hay công cụ AI khi hỏi hỗ trợ. - Không đăng file `.env`, log chứa header Authorization hoặc ảnh chụp key. - Tạo key riêng cho từng ứng dụng khi tài khoản cho phép; đặt giới hạn phù hợp. - Không dùng token quản trị hoặc cookie đăng nhập thay cho API key. ## Nếu key bị lộ Thu hồi hoặc vô hiệu hóa key trong bảng điều khiển ngay khi có thể. Tạo key thay thế, cập nhật ứng dụng và kiểm tra lịch sử sử dụng. Nếu không tìm thấy thao tác thu hồi, liên hệ CSKH ngay. Không chỉ xóa key khỏi bài đăng: bản sao hoặc lịch sử commit vẫn có thể giữ key cũ. --- # Base URL & model Nguồn: https://docs.openaihub.net/base-url/ ## Chọn đúng địa chỉ | Công cụ yêu cầu | Giá trị | | --- | --- | | API host / origin | `https://api.openaihub.net` | | OpenAI SDK base_url / baseURL | `https://api.openaihub.net/v1` | | URL đầy đủ để gửi chat bằng HTTP | `https://api.openaihub.net/v1/chat/completions` | | URL đầy đủ để xem model | `https://api.openaihub.net/v1/models` | Nếu công cụ tự thêm `/v1`, chỉ điền domain gốc. Nếu công cụ tự thêm `/chat/completions`, thường cần base URL kết thúc bằng `/v1`. Đọc mô tả trường của công cụ trước khi lưu. Không điền URL đầy đủ `/v1/chat/completions` vào OpenAI SDK: SDK còn nối thêm API path. ## Không dùng địa chỉ website làm API `https://openaihub.net` là website. `https://docs.openaihub.net` là tài liệu. Địa chỉ API là `https://api.openaihub.net`. ## Chọn model từ tài khoản Gọi `GET /v1/models` bằng API key để lấy danh sách model có thể truy cập. Sao chép đúng `id`, giữ nguyên dấu gạch nối, chữ hoa/thường và hậu tố nếu có. Model xuất hiện trong danh sách không đồng nghĩa hỗ trợ mọi giao thức. Ví dụ về Chat Completions chỉ áp dụng với model tương thích Chat Completions. Với Responses, giao thức native, ảnh, video hoặc âm thanh, cần xác nhận model và API path riêng trước khi tích hợp. ## Lỗi đường dẫn phổ biến - `/v1/v1/...`: cả bạn và công cụ đều thêm `/v1`. - `/chat/completions/chat/completions`: đã điền endpoint đầy đủ vào trường base URL. - Phản hồi HTML thay vì JSON: có thể đang gọi website, trang lỗi hoặc sai route. Xem [Bắt đầu nhanh](https://docs.openaihub.net/quickstart/) để kiểm tra bằng HTTP trước khi cấu hình ứng dụng. --- # Trò chuyện Nguồn: https://docs.openaihub.net/chat/ Chọn API phù hợp bên dưới. Các giao thức có thể khác nhau; không dùng chung đường dẫn hoặc cấu trúc request giữa các model. Xem [Bảng so sánh nhóm API](https://docs.openaihub.net/api-groups/) và [Đặc điểm & khác biệt giá](https://docs.openaihub.net/group-pricing/). ## ChatGpt > Trò chuyện ChatGPT - [Tạo cuộc trò chuyện](https://docs.openaihub.net/api-45208823/) - [Liệt kê các mô hình](https://docs.openaihub.net/api-45208824/) ## ChatGpt > Các lượt hoàn tất của ChatGPT - [Đã tạo xong](https://docs.openaihub.net/api-45208825/) ## ChatGpt > Nhúng ChatGPT - [Tạo các vectơ nhúng](https://docs.openaihub.net/api-45208826/) ## ChatGpt > Tìm kiếm trên web - [Tìm kiếm trên web](https://docs.openaihub.net/api-45208827/) ## ChatGpt > Âm thanh ChatGPT - [Tạo giọng nói gpt-4o-mini-tts](https://docs.openaihub.net/api-45208828/) - [Âm thanh thành văn bản gpt-4o-transcribe](https://docs.openaihub.net/api-45208829/) - [Tạo bản dịch (không được hỗ trợ)](https://docs.openaihub.net/api-45208830/) - [GPT-4o-audio](https://docs.openaihub.net/api-45208831/) ## Claude > Định dạng gốc - [Tạo nội dung hoàn tất cuộc trò chuyện (truyền trực tuyến) [định dạng gốc]](https://docs.openaihub.net/api-45208832/) ## Claude > Định dạng tương thích - [Tạo cuộc trò chuyện tư duy](https://docs.openaihub.net/api-45208833/) ## Claude > Định dạng gốc · có cấu trúc / tìm kiếm trên web - [Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch.](https://docs.openaihub.net/api-45208834/) ## Gemini > Định dạng gốc - [tạo văn bản](https://docs.openaihub.net/api-45208835/) - [Sinh văn bản (luồng)](https://docs.openaihub.net/api-45208836/) - [Tạo văn bản + suy luận (luồng)](https://docs.openaihub.net/api-45208837/) - [Tạo hình ảnh](https://docs.openaihub.net/api-45208838/) - [Tạo hình ảnh gemini-2.5-flash-image](https://docs.openaihub.net/api-45208839/) - [Tạo ảnh bằng gemini-3-pro-image-preview, kiểm soát tỷ lệ khung hình + độ rõ nét](https://docs.openaihub.net/api-45208840/) - [tìm kiếm trên Google](https://docs.openaihub.net/api-45208841/) - [Imagen 4 đang được phát triển](https://docs.openaihub.net/api-45208842/) - [Tạo văn bản gemini-3-pro-preview:generateContent](https://docs.openaihub.net/api-45208843/) - [gemini-tts chuyển văn bản thành giọng nói](https://docs.openaihub.net/api-45208844/) - [Nhúng](https://docs.openaihub.net/api-45208845/) - [gemini-3.1-flash-lite-image](https://docs.openaihub.net/api-45208846/) - [TTS chuyển văn bản thành giọng nói](https://docs.openaihub.net/api-45208847/) - [Imagen tạo ra hình ảnh](https://docs.openaihub.net/api-45208848/) - [Tao anh bang gemini-nano-banana-2.1](https://docs.openaihub.net/api-45208849/) ## Gemini > Định dạng tương thích với trò chuyện - [giao diện tạo hình ảnh gemini [định dạng tương thích với trò chuyện]](https://docs.openaihub.net/api-45208850/) - [Nhúng văn bản [định dạng tương thích với trò chuyện]](https://docs.openaihub.net/api-45208851/) ## Trò chuyện (Phản hồi) - [Tạo phản hồi của mô hình](https://docs.openaihub.net/api-45208852/) - [nén ngữ cảnh gpt](https://docs.openaihub.net/api-45208853/) --- # Kết nối bằng AI Nguồn: https://docs.openaihub.net/connect-with-ai/ Dùng ChatGPT, Claude hoặc trợ lý lập trình để cấu hình công cụ của bạn. **Không gửi API key thật vào hội thoại.** AI chỉ cần địa chỉ dịch vụ, tên công cụ, model và thông báo lỗi đã che thông tin nhạy cảm. ## Sao chép prompt này Nhấn nút copy ở góc khối bên dưới, thay tên công cụ và mục tiêu của bạn rồi gửi cho AI: ```text Tôi muốn kết nối [TÊN CÔNG CỤ VÀ PHIÊN BẢN] với OpenAiHub để [MỤC TIÊU SỬ DỤNG]. Đọc tài liệu trước: https://docs.openaihub.net/llms.txt Nếu cần toàn bộ nội dung: https://docs.openaihub.net/llms-full.txt API origin: https://api.openaihub.net OpenAI SDK base URL: https://api.openaihub.net/v1 Hãy hướng dẫn từng bước theo tài liệu của công cụ. Phân biệt API origin, SDK base URL và URL endpoint đầy đủ. Không tự đoán model hoặc khẳng định mọi giao thức đều được hỗ trợ. Tôi sẽ lấy model ID từ GET /v1/models trên máy của mình. Hãy hỏi nếu thiếu thông tin và dùng placeholder cho API key. Không yêu cầu tôi gửi key, mật khẩu, cookie hoặc mã OTP. ``` ## Gửi link thay vì sao chép - [Mục lục cho AI](https://docs.openaihub.net/llms.txt): giúp AI chọn bài cần đọc. - [Toàn bộ tài liệu](https://docs.openaihub.net/llms-full.txt): bản đầy đủ, có thể vượt giới hạn đọc của một số AI. Ưu tiên mục lục hoặc bài riêng khi cần cấu hình một công cụ. - [API Trò chuyện](https://docs.openaihub.net/llms-chat.txt), [API Hình ảnh](https://docs.openaihub.net/llms-images.txt), [API Video](https://docs.openaihub.net/llms-video.txt): bản gộp theo nhóm. - [Bắt đầu nhanh dạng Markdown](https://docs.openaihub.net/quickstart.md): dành cho lần kết nối đầu tiên. Mỗi bài đều có **Sao chép cho AI** và **Xem Markdown** ở đầu trang. Bản copy kèm URL nguồn để AI biết nội dung đến từ đâu. ## Nếu AI không mở được link Một số công cụ AI không có quyền truy cập web. Mở bài liên quan, nhấn **Sao chép cho AI** rồi dán nội dung trực tiếp vào hội thoại. Hoặc tải bản text và đính kèm nếu công cụ hỗ trợ. Nội dung tài liệu và lời khuyên của AI không thay thế việc kiểm tra quyền model, số dư hoặc phản hồi API thực tế. --- # "Đặc điểm & Sự khác biệt giá của nhóm API" Nguồn: https://docs.openaihub.net/group-pricing/ > Các nhóm và hệ số dưới đây áp dụng cho OpenAiHub theo chính sách hiện hành đã được xác nhận. Hệ số là tỷ lệ tính phí, không phải cam kết tốc độ hoặc chất lượng. Trong hệ thống của chúng tôi, **các nhóm API** có tính chất đặc biệt, thể hiện rõ ràng ở các khía cạnh sau: --- ## 📡 1. Sự khác biệt về nguồn truy cập * Các mô hình như **GPT, Claude...** trong mỗi nhóm được kết nối với **các kênh khác nhau** (chính thức, Azure, proxy ngược, v.v.) * Điều này **dẫn đến sự chênh lệch giá** giữa các nhóm --- ## 💲 2. Đa dạng về giá * Sự biến động giá của API trên thị trường xuất phát từ **sự khác biệt về nguồn truy cập** * Hệ thống của chúng tôi áp dụng **chính sách giá rõ ràng và minh bạch**, giúp người dùng dễ dàng so sánh và lựa chọn --- ## 🧩 3. Lựa chọn của người dùng * Người dùng được **tự do chọn nhóm API** phù hợp với nhu cầu về tốc độ, giá cả hoặc độ ổn định * Hệ thống hỗ trợ **cấu hình linh hoạt và cá nhân hóa** --- ## 📐 Giải thích "Tỷ lệ giá chính thức" Để giúp người dùng hiểu rõ hơn về cơ chế giá, chúng tôi giới thiệu khái niệm **"Tỷ lệ giá chính thức"**: | Tình huống | Giải thích | | ---------------- | --------------------------------------------------------- | | **Tỷ lệ = 1.0** | Nếu OpenAI tính **$1**, hệ thống **cũng trừ $1** | | **Tỷ lệ = 1.65** | Nếu OpenAI tính **$1**, hệ thống sẽ trừ **$1.65** | > ⚖️ Phương pháp tính này giúp người dùng dễ dàng ước tính chi phí, đồng thời mang lại **sự minh bạch và linh hoạt** trong việc chọn cấu hình dịch vụ phù hợp với nhu cầu và ngân sách. --- # Hình ảnh Nguồn: https://docs.openaihub.net/images/ Chọn API phù hợp bên dưới. Các giao thức có thể khác nhau; không dùng chung đường dẫn hoặc cấu trúc request giữa các model. Xem [Bảng so sánh nhóm API](https://docs.openaihub.net/api-groups/) và [Đặc điểm & khác biệt giá](https://docs.openaihub.net/group-pricing/). ## Midjourney > Gửi tác vụ - [Vẽ (wenshengtu/tushetu)](https://docs.openaihub.net/api-45208864/) - [Thực hiện các thao tác (thu phóng/biến thể/di chuyển/vẽ lại, v.v.)](https://docs.openaihub.net/api-45208865/) - [Xác nhận cửa sổ (bước thứ hai sau khi thao tác trả về mã:21)](https://docs.openaihub.net/api-45208866/) - [Trộn hình ảnh](https://docs.openaihub.net/api-45208867/) - [Hình ảnh và văn bản (các từ gợi ý được suy ngược)](https://docs.openaihub.net/api-45208868/) - [Phân tích từ ngữ trong lời nhắc (không có kênh)](https://docs.openaihub.net/api-45208869/) - [Thay đổi khuôn mặt (chức năng phiên bản nâng cao) (không có kênh)](https://docs.openaihub.net/api-45208870/) - [Chỉnh sửa hình ảnh (phiên bản nâng cao)](https://docs.openaihub.net/api-45208871/) - [Video sinh từ hình ảnh (chức năng phiên bản nâng cao)](https://docs.openaihub.net/api-45208872/) - [Phóng to/biến thể bản gốc, nhấn chỉ mục](https://docs.openaihub.net/api-45208873/) - [Chuyển đổi lệnh văn bản (nội dung)](https://docs.openaihub.net/api-45208874/) - [Kiểm tra các tác vụ theo từng lô dựa trên các điều kiện](https://docs.openaihub.net/api-45208875/) - [Tải lên hình ảnh tham chiếu (trả về mảng URL](https://docs.openaihub.net/api-45208876/) ## Midjourney > Các tác vụ truy vấn - [Truy vấn chi tiết tác vụ](https://docs.openaihub.net/api-45208877/) - [Kiểm tra seed](https://docs.openaihub.net/api-45208878/) ## Midjourney - [Tải ảnh lên](https://docs.openaihub.net/api-45208854/) - [Gửi tác vụ rút gọn](https://docs.openaihub.net/api-45208855/) - [Gửi tác vụ Imagine](https://docs.openaihub.net/api-45208856/) - [Lấy trạng thái tác vụ theo ID](https://docs.openaihub.net/api-45208857/) - [Truy vấn các tác vụ dựa trên danh sách ID](https://docs.openaihub.net/api-45208858/) - [Lấy hạt giống hình ảnh](https://docs.openaihub.net/api-45208859/) - [Thực thi hành động](https://docs.openaihub.net/api-45208860/) - [Gửi tác vụ Blend](https://docs.openaihub.net/api-45208861/) - [Gửi tác vụ Mô tả](https://docs.openaihub.net/api-45208862/) - [Hộp thoại gửi](https://docs.openaihub.net/api-45208863/) ## GPT Image-1 - [Tạo gpt-image-1](https://docs.openaihub.net/api-45208879/) - [chỉnh sửa hình ảnh](https://docs.openaihub.net/api-45208880/) - [Mặt nạ gpt-image-1](https://docs.openaihub.net/api-45208881/) - [Chỉnh sửa gpt-image-1.5](https://docs.openaihub.net/api-45208882/) - [Tạo gpt-image-2](https://docs.openaihub.net/api-45208883/) - [Chỉnh sửa gpt-image-2](https://docs.openaihub.net/api-45208884/) - [Tạo gpt-image-2.5](https://docs.openaihub.net/api-45208885/) - [Chỉnh sửa gpt-image-2.5](https://docs.openaihub.net/api-45208886/) ## Grok - [Tạo hình ảnh](https://docs.openaihub.net/api-45208887/) - [chỉnh sửa hình ảnh](https://docs.openaihub.net/api-45208888/) ## DALL·E 3 - [Tạo DALL·E 3](https://docs.openaihub.net/api-45208889/) ## FLUX > định dạng tương thích với GPT - [Tạo/chỉnh sửa hình ảnh](https://docs.openaihub.net/api-45208890/) - [Chỉnh sửa Flux (định dạng dall-e-3 của OpenAI)](https://docs.openaihub.net/api-45208891/) ## FLUX > Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. - [Tạo tác vụ black-forest-labs/flux-kontext-dev](https://docs.openaihub.net/api-45208892/) - [Các tác vụ truy vấn](https://docs.openaihub.net/api-45208893/) ## Doubao - [Tạo hình ảnh](https://docs.openaihub.net/api-45208894/) - [Seedream 5.0 Pro](https://docs.openaihub.net/api-45208895/) ## Fal.ai > falai-veo3 tạo video - [/fal-ai/veo3](https://docs.openaihub.net/api-45208920/) - [/fal-ai/veo3/fast/image-to-video](https://docs.openaihub.net/api-45208921/) - [/fal-ai/veo3/fast](https://docs.openaihub.net/api-45208922/) - [/fal-ai/veo3/image-to-video](https://docs.openaihub.net/api-45208923/) - [/fal-ai/veo3/requests/{request_id}](https://docs.openaihub.net/api-45208924/) ## Fal.ai - [Lấy kết quả yêu cầu](https://docs.openaihub.net/api-45208896/) - [/fal-ai/nano-banana Tạo ảnh từ văn bản](https://docs.openaihub.net/api-45208897/) - [/fal-ai/nano-banana/edit Chỉnh sửa hình ảnh](https://docs.openaihub.net/api-45208898/) - [Lấy kết quả yêu cầu](https://docs.openaihub.net/api-45208899/) - [/fal-ai/flux-1/dev](https://docs.openaihub.net/api-45208900/) - [/fal-ai/flux-1/dev/image-to-image](https://docs.openaihub.net/api-45208901/) - [/fal-ai/flux-1/dev/redux](https://docs.openaihub.net/api-45208902/) - [/fal-ai/flux-1/schnell/redux](https://docs.openaihub.net/api-45208903/) - [/fal-ai/flux-pro/kontext](https://docs.openaihub.net/api-45208904/) - [/fal-ai/flux-pro/kontext/text-to-image](https://docs.openaihub.net/api-45208905/) - [/fal-ai/flux-pro/kontext/max](https://docs.openaihub.net/api-45208906/) - [/fal-ai/flux-pro/kontext/max/multi](https://docs.openaihub.net/api-45208907/) - [/fal-ai/wan/v2.2-a14b/image-to-image](https://docs.openaihub.net/api-45208908/) - [/fal-ai/bytedance/seedream/v4/text-to-image](https://docs.openaihub.net/api-45208909/) - [/fal-ai/bytedance/seedream/v4/edit](https://docs.openaihub.net/api-45208910/) - [/fal-ai/vidu/reference-to-image](https://docs.openaihub.net/api-45208911/) - [/fal-ai/imagen4/preview](https://docs.openaihub.net/api-45208912/) - [/fal-ai/qwen-image-edit-lora](https://docs.openaihub.net/api-45208913/) - [/fal-ai/qwen-image-edit-plus](https://docs.openaihub.net/api-45208914/) - [/fal-ai/kling-video/v2.5-turbo/pro/text-to-video](https://docs.openaihub.net/api-45208915/) - [/fal-ai/kling-video/v2.5-turbo/pro/image-to-video](https://docs.openaihub.net/api-45208916/) - [/fal-ai/flux-lora](https://docs.openaihub.net/api-45208917/) - [/fal-ai/flux-lora/image-to-image](https://docs.openaihub.net/api-45208918/) - [/fal-ai/flux-lora/inpainting](https://docs.openaihub.net/api-45208919/) ## Ảnh thô AIGC của Tencent - [Lấy kết quả yêu cầu](https://docs.openaihub.net/api-45208925/) - [Tạo tác vụ](https://docs.openaihub.net/api-45208926/) ## Qwen - [qwen-image-edit-2509](https://docs.openaihub.net/api-45208927/) - [qwen-image-max-2025-12-30 địa chỉ mới](https://docs.openaihub.net/api-45208928/) ## Wan - [wan2.7-image-pro](https://docs.openaihub.net/api-45208929/) ## Ali Pix - [Tạo video Vincent](https://docs.openaihub.net/api-45208930/) - [Tạo video Tusheng](https://docs.openaihub.net/api-45208931/) - [Tạo video từ khung hình đầu tiên và khung hình cuối cùng](https://docs.openaihub.net/api-45208932/) - [Lấy trạng thái video](https://docs.openaihub.net/api-45208933/) - [Tạo video đồng bộ chuyển động môi](https://docs.openaihub.net/api-45208934/) - [Lấy âm thanh TTS](https://docs.openaihub.net/api-45208935/) - [Tạo video mở rộng](https://docs.openaihub.net/api-45208936/) - [Giao diện tạo hiệu ứng âm thanh (sound_effect)](https://docs.openaihub.net/api-45208937/) - [Tạo video đa tác tử (đa tham chiếu)](https://docs.openaihub.net/api-45208938/) - [Vẽ lại video để tạo video](https://docs.openaihub.net/api-45208939/) - [Tạo mặt nạ thay thế cơ thể (Swap)](https://docs.openaihub.net/api-45208940/) - [Tạo video thay thế chủ thể (Hoán đổi)](https://docs.openaihub.net/api-45208941/) - [Tạo video nhiều khung hình (nhiều chuyển cảnh)](https://docs.openaihub.net/api-45208942/) - [Tạo video bắt chước hành động (Mimic)](https://docs.openaihub.net/api-45208943/) - [Chỉnh sửa video (Modify) tạo ra video](https://docs.openaihub.net/api-45208944/) - [Tải ảnh lên](https://docs.openaihub.net/api-45208945/) - [Tải tài nguyên lên (video/âm thanh)](https://docs.openaihub.net/api-45208946/) - [Giao diện tạo mẫu ảnh](https://docs.openaihub.net/api-45208947/) - [Giao diện truy vấn kết quả hình ảnh](https://docs.openaihub.net/api-45208948/) ## Tổng hợp bản sao - [Tạo tác vụ black-forest-labs/flux-kontext-dev](https://docs.openaihub.net/api-45208949/) - [Tạo tác vụ black-forest-labs/flux-1.1-pro-ultra](https://docs.openaihub.net/api-45208950/) - [Tạo tác vụ black-forest-labs/flux-kontext-pro](https://docs.openaihub.net/api-45208951/) - [Tạo tác vụ black-forest-labs/flux-kontext-max](https://docs.openaihub.net/api-45208952/) - [Tạo tác vụ - truyền phiên bản mô hình (dự đoán)](https://docs.openaihub.net/api-45208953/) - [Các tác vụ truy vấn](https://docs.openaihub.net/api-45208954/) - [Tạo tác vụ minimax/video-01-live](https://docs.openaihub.net/api-45208955/) - [Tạo tác vụ minimax/video-01](https://docs.openaihub.net/api-45208956/) - [Tạo tác vụ recraft-ai/recraft-v3](https://docs.openaihub.net/api-45208957/) - [Tạo tác vụ recraft-ai/recraft-v3-svg](https://docs.openaihub.net/api-45208958/) - [Tạo tác vụ flux-kontext-apps/multi-image-kontext-max](https://docs.openaihub.net/api-45208959/) - [Tạo tác vụ flux-kontext-apps/multi-image-kontext-pro](https://docs.openaihub.net/api-45208960/) - [Tạo tác vụ riffusion/riffusion](https://docs.openaihub.net/api-45208961/) - [Tạo tác vụ black-forest-labs/flux-fill-dev](https://docs.openaihub.net/api-45208962/) - [Tạo tác vụ `black-forest-labs/flux-fill-pro`](https://docs.openaihub.net/api-45208963/) - [Tạo tác vụ google/imagen-4-fast](https://docs.openaihub.net/api-45208964/) - [Tạo tác vụ google/imagen-4-ultra](https://docs.openaihub.net/api-45208965/) - [Tạo tác vụ google/imagen-4](https://docs.openaihub.net/api-45208966/) - [Tạo tác vụ prunaai/vace-14b](https://docs.openaihub.net/api-45208967/) - [Tạo tác vụ ideogram-ai/ideogram-v2-turbo](https://docs.openaihub.net/api-45208968/) - [Tạo tác vụ bytedance/seedream-4](https://docs.openaihub.net/api-45208969/) --- # Tài liệu OpenAiHub Nguồn: https://docs.openaihub.net/ Kết nối ứng dụng của bạn với API OpenAiHub. Bắt đầu từ một yêu cầu đơn giản, sau đó cấu hình công cụ phù hợp. ## Bắt đầu tại đây - [Bắt đầu nhanh](https://docs.openaihub.net/quickstart/): chuẩn bị key, xem model và gửi yêu cầu chat. - [Base URL & model](https://docs.openaihub.net/base-url/): điền đúng địa chỉ cho từng ứng dụng. - [Python & JavaScript](https://docs.openaihub.net/sdk/): ví dụ tích hợp bằng OpenAI SDK. - [Kết nối bằng AI](https://docs.openaihub.net/connect-with-ai/): sao chép hướng dẫn để AI hỗ trợ cấu hình. ## API và nhóm dịch vụ - [Trò chuyện](https://docs.openaihub.net/chat/): ChatGPT, Claude, Gemini và các giao thức liên quan. - [Hình ảnh](https://docs.openaihub.net/images/): tạo ảnh, chỉnh sửa ảnh và truy vấn tác vụ. - [Video](https://docs.openaihub.net/video/): tạo video, xử lý và lấy kết quả theo từng model. - [Bảng so sánh nhóm API](https://docs.openaihub.net/api-groups/). - [Đặc điểm & Sự khác biệt giá của nhóm API](https://docs.openaihub.net/group-pricing/). ## Thông tin kết nối | Mục | Giá trị | | --- | --- | | API origin | `https://api.openaihub.net` | | Base URL cho OpenAI SDK | `https://api.openaihub.net/v1` | | Danh sách model | `GET /v1/models` | | Xác thực API tương thích OpenAI | `Authorization: Bearer YOUR_API_KEY` | | CSKH | [@muataikhoan_sp](https://t.me/muataikhoan_sp) | Tính khả dụng của model và giao thức phụ thuộc quyền tài khoản. Tài liệu này không phải cam kết rằng mọi model hoặc mọi API của nhà cung cấp đều được hỗ trợ. ## Dành cho AI Mỗi bài có nút **Sao chép cho AI** và link **Xem Markdown**. Bạn có thể gửi AI một trong các link sau: - [Mục lục cho AI](https://docs.openaihub.net/llms.txt) - [Toàn bộ tài liệu dạng text](https://docs.openaihub.net/llms-full.txt) OpenAiHub là dịch vụ độc lập, không phải website chính thức của OpenAI. --- # Bắt đầu nhanh Nguồn: https://docs.openaihub.net/quickstart/ ## Chuẩn bị API key Mở [OpenAiHub](https://openaihub.net), đăng nhập hoặc đăng ký tài khoản. Trong bảng điều khiển, tìm mục quản lý API key/token và tạo key theo quyền truy cập tài khoản của bạn. Nếu chưa thấy mục này, liên hệ [@muataikhoan_sp](https://t.me/muataikhoan_sp). Không gửi API key cho AI, không đăng lên GitHub và không nhúng trong mã frontend. Các ví dụ dưới đây dùng biến môi trường trên máy của bạn. ## Đặt biến môi trường Trên macOS/Linux, nhập key ở chế độ ẩn để tránh lưu key trong lịch sử shell: ```bash read -rs OPENAI_API_KEY export OPENAI_API_KEY ``` Dán key, nhấn Enter. Lệnh nhập ẩn này không hiển thị ký tự khi gõ. ## Lấy danh sách model ```bash curl --fail-with-body https://api.openaihub.net/v1/models \ -H "Authorization: Bearer $OPENAI_API_KEY" ``` Chọn một giá trị `id` trong kết quả và đặt biến: ```bash export OPENAI_MODEL="MODEL_ID_FROM_YOUR_ACCOUNT" ``` `MODEL_ID_FROM_YOUR_ACCOUNT` là chỗ giữ chỗ, không phải model thật. Không tự dùng một model chỉ vì công cụ có sẵn tên đó. ## Gửi yêu cầu chat Ví dụ dưới đây dành cho model hỗ trợ giao thức Chat Completions. Danh sách model không bảo đảm mọi model đều dùng được endpoint này. ```bash curl --fail-with-body https://api.openaihub.net/v1/chat/completions \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d "{\"model\":\"$OPENAI_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Xin chào!\"}]}" ``` Với phản hồi Chat Completions thành công, nội dung văn bản thường nằm ở `choices[0].message.content`. ## Khi chưa kết nối được Xem [Xử lý lỗi](https://docs.openaihub.net/troubleshooting/). Quyền model, số dư và giao thức khả dụng phụ thuộc tài khoản. Nếu model yêu cầu giao thức khác, hỏi hỗ trợ thay vì thử đổi endpoint ngẫu nhiên. --- # Python & JavaScript Nguồn: https://docs.openaihub.net/sdk/ Các ví dụ sau dùng OpenAI SDK cho model tương thích Chat Completions. Đây không phải cấu hình mặc định cho mọi giao thức hoặc mọi model. Chuẩn bị `OPENAI_API_KEY` và `OPENAI_MODEL` như [Bắt đầu nhanh](https://docs.openaihub.net/quickstart/). Chọn model từ tài khoản, không dùng nguyên placeholder. ## Python ```bash python -m pip install openai ``` ```python import os from openai import OpenAI client = OpenAI( api_key=os.environ["OPENAI_API_KEY"], base_url="https://api.openaihub.net/v1", timeout=60.0, max_retries=0, ) response = client.chat.completions.create( model=os.environ["OPENAI_MODEL"], messages=[{"role": "user", "content": "Xin chào!"}], ) print(response.choices[0].message.content) ``` Lưu thành `example.py`, chạy `python example.py`. ## JavaScript / Node.js Dùng phiên bản Node.js còn được hỗ trợ, đáp ứng yêu cầu của phiên bản SDK đang cài. ```bash npm install openai ``` ```javascript import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY, baseURL: "https://api.openaihub.net/v1", timeout: 60_000, maxRetries: 0, }); const response = await client.chat.completions.create({ model: process.env.OPENAI_MODEL, messages: [{ role: "user", content: "Xin chào!" }], }); console.log(response.choices[0].message.content); ``` Lưu thành `example.mjs`, chạy `node example.mjs`. Chạy ở máy chủ hoặc máy cá nhân; không đưa key vào JavaScript trên trình duyệt. ## Timeout và retry Ví dụ tắt retry tự động để dễ đọc lỗi và tránh gửi lại ngoài ý muốn. Khi tích hợp production, chỉ thêm retry có giới hạn sau khi hiểu mã lỗi và rủi ro lặp yêu cầu/tính phí. Không retry liên tục lỗi xác thực hoặc yêu cầu không hợp lệ. ## Công cụ khác Chọn provider **OpenAI-compatible / Custom OpenAI** nếu công cụ có hỗ trợ, nhập base URL theo [hướng dẫn](https://docs.openaihub.net/base-url/), rồi chọn model thật từ tài khoản. Nếu công cụ chỉ hỗ trợ đăng nhập thuê bao chính thức, việc có API key không bảo đảm dùng được. --- # Liên hệ hỗ trợ Nguồn: https://docs.openaihub.net/support/ ## Hỗ trợ qua Telegram **[@muataikhoan_sp](https://t.me/muataikhoan_sp)** Liên hệ để được hướng dẫn tài khoản, API key, model khả dụng, thông tin giá và hỗ trợ kết nối. ## Gửi thông tin gì? Sao chép mẫu dưới đây và điền các mục có sẵn: ```text Công cụ và phiên bản: Mục tiêu sử dụng: API base URL đang điền: Model ID: API path: HTTP status / thông báo lỗi: Thời điểm xảy ra lỗi (kèm múi giờ): Request ID (nếu có): Các bước đã thử: ``` Không gửi API key, mật khẩu, cookie đăng nhập hoặc mã OTP. Che thông tin nhạy cảm trong ảnh chụp trước khi gửi. ## Giá và chính sách Kiểm tra thông tin hiện hành trong tài khoản hoặc hỏi CSKH. Tài liệu này không công bố mức nạp tối thiểu, tín dụng tặng, thời gian phản hồi hay cam kết SLA khi chưa có chính sách được xác nhận. --- # Xử lý lỗi Nguồn: https://docs.openaihub.net/troubleshooting/ ## Kiểm tra theo thứ tự 1. Xác nhận API origin là `https://api.openaihub.net`. 2. Kiểm tra công cụ có tự thêm `/v1` hoặc API path không. 3. Xác nhận biến môi trường đã được đặt trong đúng tiến trình chạy ứng dụng. 4. Gọi `GET /v1/models` để kiểm tra xác thực và xem model truy cập được. 5. Xác nhận model hỗ trợ giao thức đang gọi; kiểm tra số dư/hạn mức trong bảng điều khiển. ## HTTP 401 hoặc lỗi token Key có thể thiếu, sai, bị thu hồi hoặc không có quyền. Kiểm tra header Bearer và khoảng trắng thừa. Không dùng cookie đăng nhập thay key. Lưu lại nội dung lỗi đã che thông tin nhạy cảm nếu vẫn thất bại. ## HTTP 403 Có thể liên quan quyền truy cập, chính sách bảo mật hoặc lớp bảo vệ mạng. Không kết luận API key hỏng chỉ dựa vào mã này. Gửi CSKH thời điểm lỗi, API path và request ID nếu có. ## HTTP 404 hoặc trả HTML Kiểm tra nhầm domain website, sai route, `/v1/v1` hoặc lặp `/chat/completions`. Một trang HTML trả HTTP 200 không phải phản hồi API thành công. ## Model không khả dụng So sánh chính xác model ID với kết quả `/v1/models`. Nếu có trong danh sách mà vẫn lỗi, kiểm tra giao thức và quyền nhóm tài khoản với CSKH. Không tự thay model trong tác vụ production. ## HTTP 429, 5xx hoặc timeout Đọc chi tiết lỗi trước khi thử lại. Với giới hạn tốc độ, giảm số yêu cầu đồng thời và dùng backoff có giới hạn nếu phù hợp. Với timeout, kiểm tra mạng và thời gian xử lý dự kiến. Timeout không chứng minh yêu cầu chưa được xử lý. Không tự gửi lặp tác vụ dài hoặc có tính phí khi chưa xác nhận trạng thái. ## Nhờ AI hoặc CSKH kiểm tra Chuẩn bị tên công cụ, phiên bản, base URL, model, HTTP status, API path, thời điểm lỗi và request ID. Che API key, header Authorization, dữ liệu khách hàng và prompt nhạy cảm. [Liên hệ @muataikhoan_sp](https://t.me/muataikhoan_sp). --- # Video Nguồn: https://docs.openaihub.net/video/ Chọn API phù hợp bên dưới. Các giao thức có thể khác nhau; không dùng chung đường dẫn hoặc cấu trúc request giữa các model. Xem [Bảng so sánh nhóm API](https://docs.openaihub.net/api-groups/) và [Đặc điểm & khác biệt giá](https://docs.openaihub.net/group-pricing/). ## Veo > Định dạng video OpenAI - [OpenAI tạo video (có hình ảnh)](https://docs.openaihub.net/api-45208970/) - [Tác vụ truy vấn OpenAI](https://docs.openaihub.net/api-45208971/) - [Tải xuống video OpenAI](https://docs.openaihub.net/api-45208972/) ## Veo > 3.1 Định dạng gốc - [Tạo video veo-3.1-generate-preview](https://docs.openaihub.net/api-45208973/) - [Tạo video veo-3.1-fast-generate-preview](https://docs.openaihub.net/api-45208974/) - [Các tác vụ truy vấn](https://docs.openaihub.net/api-45208975/) ## Veo > Định dạng hợp nhất cho video - [Tạo video (hình ảnh tham chiếu)](https://docs.openaihub.net/api-45208976/) - [Các tác vụ truy vấn](https://docs.openaihub.net/api-45208977/) ## Luma > Định dạng API chính thức - [Gửi tác vụ tạo video](https://docs.openaihub.net/api-45208978/) - [Video mở rộng](https://docs.openaihub.net/api-45208979/) ## Luma > Các tác vụ truy vấn - [Truy vấn một tác vụ duy nhất](https://docs.openaihub.net/api-45208980/) - [Lấy nhiều tác vụ theo lô](https://docs.openaihub.net/api-45208981/) ## Kling > văn bản thành video - [văn bản thành video](https://docs.openaihub.net/api-45208991/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45208992/) ## Kling > ảnh-thành-video - [ảnh-thành-video](https://docs.openaihub.net/api-45208993/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45208994/) ## Kling > Omni-Image - [Omni-Image](https://docs.openaihub.net/api-45208995/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45208996/) ## Kling > Video học viên tham chiếu nhiều hình ảnh - [Video học viên tham chiếu nhiều hình ảnh](https://docs.openaihub.net/api-45208997/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45208998/) ## Kling > Chỉnh sửa video đa phương thức - [Khởi tạo video cần chỉnh sửa](https://docs.openaihub.net/api-45208999/) - [Thêm lựa chọn video](https://docs.openaihub.net/api-45209000/) - [Xóa lựa chọn video](https://docs.openaihub.net/api-45209001/) - [Xem trước video đã chọn](https://docs.openaihub.net/api-45209002/) - [video đa phương thức](https://docs.openaihub.net/api-45209003/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209004/) ## Kling > hiệu ứng video - [hiệu ứng video](https://docs.openaihub.net/api-45209005/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209006/) ## Kling > Hình ảnh > phần mở rộng video - [phần mở rộng video](https://docs.openaihub.net/api-45209009/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209010/) ## Kling > Hình ảnh - [Hình ảnh](https://docs.openaihub.net/api-45209007/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209008/) ## Kling > Nhiều hình ảnh tham khảo - [Nhiều hình ảnh tham khảo](https://docs.openaihub.net/api-45209011/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209012/) ## Kling > Keling 3.0turbo - [văn bản thành video](https://docs.openaihub.net/api-45209013/) - [ảnh-thành-video](https://docs.openaihub.net/api-45209014/) - [Truy vấn video](https://docs.openaihub.net/api-45209015/) ## Kling > Omni-Video - [Omni-Video](https://docs.openaihub.net/api-45209016/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209017/) ## Kling > Mở rộng hình ảnh - [Mở rộng hình ảnh](https://docs.openaihub.net/api-45209018/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209019/) ## Kling > nhận dạng hình ảnh - [nhận dạng hình ảnh](https://docs.openaihub.net/api-45209020/) ## Kling > con người kỹ thuật số - [con người kỹ thuật số](https://docs.openaihub.net/api-45209021/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209022/) ## Kling > Văn bản thành âm thanh - [Văn bản thành âm thanh](https://docs.openaihub.net/api-45209023/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209024/) ## Kling > Video sang âm thanh - [Video sang âm thanh](https://docs.openaihub.net/api-45209025/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209026/) ## Kling > Tổng hợp giọng nói - [Tổng hợp giọng nói](https://docs.openaihub.net/api-45209027/) ## Kling > Thử đồ ảo - [Thử đồ ảo](https://docs.openaihub.net/api-45209028/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209029/) ## Kling > đồng bộ chuyển động môi - [nhận dạng khuôn mặt](https://docs.openaihub.net/api-45209030/) - [đồng bộ chuyển động môi](https://docs.openaihub.net/api-45209031/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209032/) ## Kling > Âm thanh tùy chỉnh - [Âm thanh tùy chỉnh](https://docs.openaihub.net/api-45209033/) - [Truy vấn âm sắc tùy chỉnh (đơn lẻ)](https://docs.openaihub.net/api-45209034/) - [Kiểm tra âm thanh chính thức](https://docs.openaihub.net/api-45209035/) - [Xoa am thanh tuy chinh](https://docs.openaihub.net/api-45209036/) ## Kling > điều khiển chuyển động - [điều khiển chuyển động](https://docs.openaihub.net/api-45209037/) - [Tác vụ truy vấn (đơn lẻ)](https://docs.openaihub.net/api-45209038/) ## Kling > nội dung chính - [Chủ đề (cũ)](https://docs.openaihub.net/api-45209039/) - [Phần nội dung chính (phiên bản mới)](https://docs.openaihub.net/api-45209040/) - [Truy vấn principal tùy chỉnh (một phiên bản mới duy nhất)](https://docs.openaihub.net/api-45209041/) - [Truy vấn chủ thể chính thức (phiên bản mới của danh sách)](https://docs.openaihub.net/api-45209042/) - [Xóa chủ thể tùy chỉnh (phiên bản mới)](https://docs.openaihub.net/api-45209043/) ## Kling - [Hình ảnh](https://docs.openaihub.net/api-45208982/) - [văn bản thành video](https://docs.openaihub.net/api-45208983/) - [ảnh-thành-video](https://docs.openaihub.net/api-45208984/) - [đồng bộ chuyển động môi](https://docs.openaihub.net/api-45208985/) - [Thử đồ ảo](https://docs.openaihub.net/api-45208986/) - [phần mở rộng video](https://docs.openaihub.net/api-45208987/) - [hiệu ứng video](https://docs.openaihub.net/api-45208988/) - [Video học viên tham chiếu nhiều hình ảnh](https://docs.openaihub.net/api-45208989/) - [Các tác vụ truy vấn (miễn phí)](https://docs.openaihub.net/api-45208990/) ## Đường băng - [Gửi tác vụ tạo video](https://docs.openaihub.net/api-45209044/) - [Truy vấn các tác vụ video (miễn phí)](https://docs.openaihub.net/api-45209045/) ## Doubao - [Tạo tác vụ](https://docs.openaihub.net/api-45209046/) - [Truy vấn một tác vụ duy nhất](https://docs.openaihub.net/api-45209047/) - [Truy vấn danh sách tác vụ tạo video list-default](https://docs.openaihub.net/api-45209048/) - [Tạo một tác vụ tạo video](https://docs.openaihub.net/api-45209049/) - [API tác vụ truy vấn tạo video doubao-2.0](https://docs.openaihub.net/api-45209050/) - [doubao-2.0 Truy vấn danh sách tác vụ tạo video](https://docs.openaihub.net/api-45209051/) ## sora > Định dạng video hợp nhất - [Tạo video bằng hình ảnh sora-2](https://docs.openaihub.net/api-45209053/) - [Các tác vụ truy vấn](https://docs.openaihub.net/api-45209054/) ## sora > Định dạng video chính thức của OpenAI - [OpenAI tạo video (có hình ảnh)](https://docs.openaihub.net/api-45209055/) - [openai chỉnh sửa video](https://docs.openaihub.net/api-45209056/) - [Tác vụ truy vấn OpenAI](https://docs.openaihub.net/api-45209057/) - [Tải xuống video OpenAI](https://docs.openaihub.net/api-45209058/) - [Tạo một nhân vật từ video đã tải lên](https://docs.openaihub.net/api-45209059/) ## sora > định dạng trò chuyện - [Tạo video](https://docs.openaihub.net/api-45209060/) ## sora - [Tạo một vai trò](https://docs.openaihub.net/api-45209052/) ## Thông Nghĩa Vạn Tượng - [Tạo video](https://docs.openaihub.net/api-45209061/) - [Truy vấn video](https://docs.openaihub.net/api-45209062/) ## hiểu thấu đáo > Định dạng hợp nhất cho video - [Video mở rộng](https://docs.openaihub.net/api-45209063/) - [Tạo video](https://docs.openaihub.net/api-45209064/) - [Các tác vụ truy vấn](https://docs.openaihub.net/api-45209065/) ## hiểu thấu đáo > Định dạng video OpenAI - [openai tạo video, hình ảnh và video](https://docs.openaihub.net/api-45209066/) - [Các tác vụ truy vấn](https://docs.openaihub.net/api-45209067/) ## hiểu thấu đáo > định dạng chính thức - [Tạo video](https://docs.openaihub.net/api-45209068/) - [Chỉnh sửa video](https://docs.openaihub.net/api-45209069/) - [Truy vấn video](https://docs.openaihub.net/api-45209070/) ## Ví dụ > Định dạng hợp nhất cho video - [Tạo video](https://docs.openaihub.net/api-45209079/) - [Các tác vụ truy vấn](https://docs.openaihub.net/api-45209080/) ## Ví dụ - [Tạo tác vụ video Tusheng](https://docs.openaihub.net/api-45209071/) - [Tạo một tác vụ video học viên tham chiếu (cuộc gọi chủ thể)](https://docs.openaihub.net/api-45209072/) - [Tạo tác vụ video để tạo khung hình đầu và cuối](https://docs.openaihub.net/api-45209073/) - [Tạo tác vụ sinh ảnh](https://docs.openaihub.net/api-45209074/) - [Tạo một tác vụ âm thanh Vincent](https://docs.openaihub.net/api-45209075/) - [Tổng hợp giọng nói](https://docs.openaihub.net/api-45209076/) - [Tạo một tác vụ video Vincent](https://docs.openaihub.net/api-45209077/) - [Lấy kết quả yêu cầu](https://docs.openaihub.net/api-45209078/) ## Tencent AIGC - [Tạo tác vụ](https://docs.openaihub.net/api-45209081/) - [Tác vụ tạo mẫu hiệu ứng đặc biệt](https://docs.openaihub.net/api-45209082/) - [Lấy kết quả yêu cầu](https://docs.openaihub.net/api-45209083/) ## seedance-2-0 - [Video](https://docs.openaihub.net/api-45209084/) - [Các tác vụ truy vấn](https://docs.openaihub.net/api-45209085/) ## Cinema2.0 - [trình tạo sơ đồ Vincentian](https://docs.openaihub.net/api-45209086/) - [Truy vấn tác vụ](https://docs.openaihub.net/api-45209087/) ## MiniMax - [Tải lên âm thanh đã phân nhánh](https://docs.openaihub.net/api-45209088/) - [Nhân bản giọng nói nhanh](https://docs.openaihub.net/api-45209089/) - [Tác vụ tạo video Vincent Tusheng](https://docs.openaihub.net/api-45209090/) - [Truy van trang thai tac vu tao video](https://docs.openaihub.net/api-45209091/) - [Truy xuất (để tải video, tải âm thanh không đồng bộ)](https://docs.openaihub.net/api-45209092/) - [tổng hợp văn bản](https://docs.openaihub.net/api-45209093/) - [Tổng hợp giọng nói đồng bộ V2](https://docs.openaihub.net/api-45209094/) - [thiết kế âm thanh](https://docs.openaihub.net/api-45209095/) - [Tạo video](https://docs.openaihub.net/api-45209096/) - [Truy vấn một tác vụ duy nhất](https://docs.openaihub.net/api-45209097/)