> ## Documentation Index > Fetch the complete documentation index at: https://docs.aiid.edu.kg/llms.txt > Use this file to discover all available pages before exploring further. # Truy vấn tác vụ（Seedance） > Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết [Định dạng tương thích với Sora tạo video](/api-reference/vi/tao-video-dinh-dang-tuong-thich-sora/tao-video)). Được dùng để tạo tác vụ tạo video và truy vấn trạng thái cũng như kết quả thông qua ID tác vụ. Các trường cốt lõi để tạo tác vụ: - `model`: Bắt buộc, tên mô hình. - `prompt`: Bắt buộc, mô tả chính để tạo video. - `content`: tùy chọn, mảng content của Volcano Ark, trộn văn bản, hình ảnh, video và âm thanh. - `function_mode`: Tùy chọn, thường dùng cho các chế độ nâng cao như tham chiếu toàn năng. Các tham số đầu vào tương thích: Các trường sau chủ yếu dùng để tương thích với client cũ và giao thức cũ. Với tích hợp mới, vui lòng ưu tiên dùng định dạng chuẩn trong “Ví dụ yêu cầu” trên trang này: văn bản và tài liệu tham chiếu sử dụng mảng `content`, còn cấu hình sinh sử dụng các trường cấp cao nhất `duration`, `ratio`, `resolution`, `fps`, v.v. - `mode`：`t2v / i2v / i2v_first_last / reference_images / reference_material` - `image_url / image_urls / input_reference` - `end_image_url / last_image_url` - `video_urls / audio_urls` - `seconds / duration` - `aspect_ratio / ratio / size` - `quality / resolution` - `fps` - `generate_audio / watermark` Chi tiết gọi API: - Khi là `mode=reference_material` hoặc `function_mode=omni_reference`, nên truyền văn bản và tài liệu tham chiếu thông qua `content`. - `content` mục văn bản được viết theo dạng `{ "type": "text", "text": "测试文字" }`. - `content` các mục tài nguyên hình ảnh, video, âm thanh lần lượt dùng cú pháp đối tượng `image_url`, `video_url`, `audio_url`, ví dụ `{ "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }`. - `role` có thể dùng để xác định mục đích của tài nguyên, `name` có thể được tham chiếu theo tên trong prompt. - `ratio`, `duration`, `resolution`, `fps` sẽ ảnh hưởng đến cấu hình tạo cuối cùng. Gọi Gemini Omni: - `gemini-omni` cũng có thể được gọi thông qua giao diện tác vụ Seedance này. - `mode=t2v` dùng cho tạo video từ văn bản, `mode=r2v` dùng cho tạo bằng ảnh tham chiếu/tài nguyên tham chiếu, `mode=edit` dùng cho chỉnh sửa video. - Văn bản có thể đặt trong mục `text` của `prompt` hoặc `content`; hình ảnh có thể đặt trong `image_url / image_urls / reference_images / input_reference / content`; video có thể đặt trong `video_urls / content`. - Trường thời lượng có thể dùng `duration` hoặc `seconds`, hệ thống sẽ tự động khớp với các mức 4 / 6 / 8 / 10 giây. MiniMax / Hailuo gọi: - `minimax-h3` có thể được gọi thông qua API tác vụ này, hỗ trợ tạo video từ văn bản, tham chiếu ảnh và tham chiếu âm thanh; văn bản có thể đặt trong mục văn bản `prompt` hoặc `content`, dữ liệu có thể đặt trong các trường như `content`, `image_urls`, `audio_urls`. - `hailuo-2.3` có thể được gọi thông qua API tác vụ này, cần ảnh khung hình đầu tiên; khuyến nghị truyền mục `image_url` của `role=first_frame` trong `content`. - `minimax-h3` thường dùng `duration=5~15`, `resolution=1440p`; `hailuo-2.3` thường dùng `duration=6` hoặc `10`, `resolution=768p`. Các trường cần lưu ý trong kết quả truy vấn: - `items[].status` - `items[].content.video_url` hoặc `items[].video_url` - `items[].error` - `items[].progress` Error fields: `error.code`, `error.message`. ```json { "error": { "code": "invalid_request_error", "message": "requires at least one image in `images`" } } ``` ## OpenAPI ````yaml api-reference/vi/openapi.json GET /api/v3/contents/generations/tasks/{task_id} openapi: 3.0.0 info: title: Tài liệu tham khảo API của 出海营 version: 1.0.0 description: Public AI Gateway API Reference servers: - url: https://api.aiid.edu.kg security: - BearerAuth: [] tags: - name: Định dạng OpenAI (Chat) - name: Định dạng OpenAI (Responses) - name: Định dạng Gemini cho tạo ảnh - name: Tạo hình ảnhOpenAI định dạng DALL-E - name: Lấy danh sách mô hình - name: Tạo video HappyHorse và Wan - name: Định dạngKling tạo video - name: Định dạng Video Generation Omni và Veo - name: Tạo video Seedance - name: Định dạng tương thích Sora cho tạo video - name: Tạo video Vidu - name: Định dạng tác vụ tạo nhạc paths: /api/v3/contents/generations/tasks/{task_id}: get: tags: - Tạo video Seedance summary: Truy vấn tác vụ（Seedance） description: >- Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết [Định dạng tương thích với Sora tạo video](/api-reference/vi/tao-video-dinh-dang-tuong-thich-sora/tao-video)). Được dùng để tạo tác vụ tạo video và truy vấn trạng thái cũng như kết quả thông qua ID tác vụ. Các trường cốt lõi để tạo tác vụ: - `model`: Bắt buộc, tên mô hình. - `prompt`: Bắt buộc, mô tả chính để tạo video. - `content`: tùy chọn, mảng content của Volcano Ark, trộn văn bản, hình ảnh, video và âm thanh. - `function_mode`: Tùy chọn, thường dùng cho các chế độ nâng cao như tham chiếu toàn năng. Các tham số đầu vào tương thích: Các trường sau chủ yếu dùng để tương thích với client cũ và giao thức cũ. Với tích hợp mới, vui lòng ưu tiên dùng định dạng chuẩn trong “Ví dụ yêu cầu” trên trang này: văn bản và tài liệu tham chiếu sử dụng mảng `content`, còn cấu hình sinh sử dụng các trường cấp cao nhất `duration`, `ratio`, `resolution`, `fps`, v.v. - `mode`：`t2v / i2v / i2v_first_last / reference_images / reference_material` - `image_url / image_urls / input_reference` - `end_image_url / last_image_url` - `video_urls / audio_urls` - `seconds / duration` - `aspect_ratio / ratio / size` - `quality / resolution` - `fps` - `generate_audio / watermark` Chi tiết gọi API: - Khi là `mode=reference_material` hoặc `function_mode=omni_reference`, nên truyền văn bản và tài liệu tham chiếu thông qua `content`. - `content` mục văn bản được viết theo dạng `{ "type": "text", "text": "测试文字" }`. - `content` các mục tài nguyên hình ảnh, video, âm thanh lần lượt dùng cú pháp đối tượng `image_url`, `video_url`, `audio_url`, ví dụ `{ "type": "image_url", "image_url": { "url": "https://example.com/ref.png" }, "role": "reference_image", "name": "1" }`. - `role` có thể dùng để xác định mục đích của tài nguyên, `name` có thể được tham chiếu theo tên trong prompt. - `ratio`, `duration`, `resolution`, `fps` sẽ ảnh hưởng đến cấu hình tạo cuối cùng. Gọi Gemini Omni: - `gemini-omni` cũng có thể được gọi thông qua giao diện tác vụ Seedance này. - `mode=t2v` dùng cho tạo video từ văn bản, `mode=r2v` dùng cho tạo bằng ảnh tham chiếu/tài nguyên tham chiếu, `mode=edit` dùng cho chỉnh sửa video. - Văn bản có thể đặt trong mục `text` của `prompt` hoặc `content`; hình ảnh có thể đặt trong `image_url / image_urls / reference_images / input_reference / content`; video có thể đặt trong `video_urls / content`. - Trường thời lượng có thể dùng `duration` hoặc `seconds`, hệ thống sẽ tự động khớp với các mức 4 / 6 / 8 / 10 giây. MiniMax / Hailuo gọi: - `minimax-h3` có thể được gọi thông qua API tác vụ này, hỗ trợ tạo video từ văn bản, tham chiếu ảnh và tham chiếu âm thanh; văn bản có thể đặt trong mục văn bản `prompt` hoặc `content`, dữ liệu có thể đặt trong các trường như `content`, `image_urls`, `audio_urls`. - `hailuo-2.3` có thể được gọi thông qua API tác vụ này, cần ảnh khung hình đầu tiên; khuyến nghị truyền mục `image_url` của `role=first_frame` trong `content`. - `minimax-h3` thường dùng `duration=5~15`, `resolution=1440p`; `hailuo-2.3` thường dùng `duration=6` hoặc `10`, `resolution=768p`. Các trường cần lưu ý trong kết quả truy vấn: - `items[].status` - `items[].content.video_url` hoặc `items[].video_url` - `items[].error` - `items[].progress` Error fields: `error.code`, `error.message`. ```json { "error": { "code": "invalid_request_error", "message": "requires at least one image in `images`" } } ``` operationId: query__seedance__task parameters: - name: task_id in: path required: true schema: type: string description: Task ID responses: '200': description: Truy vấn thành công content: application/json: schema: type: object properties: id: type: string description: ID của tác vụ. model: type: string status: type: string description: Trạng thái nhiệm vụ. enum: - queued - running - succeeded - failed error: type: object nullable: true properties: code: type: string message: type: string created_at: type: integer description: Thời gian tạo (giây Unix). updated_at: type: integer content: type: object properties: video_url: type: string last_frame_url: type: string usage: type: object properties: completion_tokens: type: integer total_tokens: type: integer items: type: string items: type: object properties: id: type: string description: ID của tác vụ. status: type: string description: >- Trạng thái tác vụ, thường là `queued`, `running`, `succeeded`, `failed`. content: type: object properties: video_url: type: string description: Địa chỉ kết quả video. video_url: type: string description: Địa chỉ kết quả video. error: type: string description: Thông báo lỗi khi thất bại. progress: type: string description: Tiến độ tác vụ. security: - BearerAuth: [] components: securitySchemes: BearerAuth: type: http scheme: bearer description: |- Sử dụng xác thực Bearer Token. Định dạng: `Authorization: Bearer sk-xxxxxx` ````