Bỏ qua, đến nội dung chính
RPT AI Video Studio

Mọi trang tài liệu

Tra cứu

Danh mục tool MCP

Sinh tự động từ danh mục tool của MCP server. Danh sách agent thấy trong tools/list ngắn hơn: chỉ gồm các tool mà chế độ và danh sách cho phép của token được dùng.

POST /api/v1/agent/mcp · 159 tool

Tool đọc không thay đổi gì. Tool ghi thay đổi dữ liệu workspace; phần lớn cần request_key. Tool tính phí cần token execute; phần lớn bắt đầu việc tính phí ngay, riêng create_quote chỉ báo giá.

Định hướng

7 tool

  • agent_preflight

    Đọc

    Kiểm tra sản xuất chỉ đọc: điểm chặn, cảnh báo, ngân sách còn lại, mức sẵn sàng của model video và các lời gọi tiếp theo chính xác cho token này.

    Bắt buộc
    project_id

  • agent_continue

    Đọc

    Đánh giá lại dự án và trả về biên nhận bước tiếp theo: trạng thái (ready/needs_human/waiting/blocked/complete), next_call chính xác và các lựa chọn thay thế.

    Bắt buộc
    project_id
    Tùy chọn
    request_key

  • list_video_models

    ĐọcTool cấp workspace

    Liệt kê các model video của workspace cùng mức sẵn sàng, tỉ lệ, độ phân giải, chế độ đầu vào và gợi ý sử dụng (create_quote.resolution phải là một giá trị mà model đã chọn liệt kê).

    Bắt buộc
    workspace_id

  • list_voices

    ĐọcTool cấp workspace

    Liệt kê và lọc giọng TTS (thư viện giọng) theo model giọng, tên, giới tính, độ tuổi, ngôn ngữ, mục đích dùng, vùng và sắc thái; mỗi giọng có metadata age/use_cases và sample_available (có âm thanh nghe thử).

    Bắt buộc
    không có
    Tùy chọn
    voice_model, query, gender, language, region, tone, age, use_case, workspace_id, favorite, limit

  • read_external_context

    Đọc

    Đọc ngữ cảnh dự án đã được ẩn thông tin nhạy cảm, do máy chủ quyết định, cùng schema composition cho một AI client bên ngoài.

    Bắt buộc
    project_id

  • get_project_state

    Đọc

    Đọc tóm tắt hiện tại của dự án.

    Bắt buộc
    project_id

  • get_studio_state

    Đọc

    Đọc các tin nhắn lập kế hoạch, ý định lập kế hoạch và các bản composition.

    Bắt buộc
    project_id

Dự án và thư mục

10 tool

  • create_project

    GhiCần interactiveTool cấp workspace

    Tạo dự án và mở phiên agent của nó từ một brief viết bằng ngôn ngữ tự nhiên.

    Bắt buộc
    workspace_id, title, request_key
    Tùy chọn
    product, brief, duration, ratio, preset, video_model, folder_id

  • clone_project

    GhiCần interactive

    Nhân bản lần chạy READY của một dự án thành dự án nhánh anh em mới với cùng storyboard, tham chiếu và keyframe; có thể đổi mọi cảnh video AI sang video_model khác (cùng tỉ lệ).

    Bắt buộc
    project_id, request_key
    Tùy chọn
    run_id, title, video_model

  • list_workspace_folders

    ĐọcTool cấp workspace

    Liệt kê các thư mục dự án đang dùng hoặc đã lưu trữ trong workspace.

    Bắt buộc
    workspace_id
    Tùy chọn
    archived

  • create_folder

    GhiCần interactiveTool cấp workspace

    Tạo một thư mục bền vững để chứa dự án trong workspace.

    Bắt buộc
    workspace_id, name, request_key

  • rename_folder

    GhiCần interactive

    Đổi tên thư mục dự án mà không ảnh hưởng đến các dự án trong đó.

    Bắt buộc
    folder_id, name, request_key

  • archive_folder

    GhiCần interactiveNgười dùng xác nhận

    Lưu trữ một thư mục dự án an toàn; các dự án vẫn ở trong workspace và có thể chuyển đi sau.

    Bắt buộc
    folder_id, confirmed, request_key

  • restore_folder

    GhiCần interactive

    Khôi phục một thư mục dự án đã lưu trữ.

    Bắt buộc
    folder_id, request_key

  • move_project_to_folder

    GhiCần interactive

    Chuyển một dự án vào thư mục, hoặc đặt folder_id là null để đưa nó ra khỏi thư mục.

    Bắt buộc
    project_id, request_key
    Tùy chọn
    folder_id

  • archive_project

    GhiCần interactiveNgười dùng xác nhận

    Lưu trữ một dự án an toàn thay vì xóa hẳn.

    Bắt buộc
    project_id, confirmed, request_key

  • restore_project

    GhiCần interactive

    Khôi phục một dự án đã lưu trữ về workspace.

    Bắt buộc
    project_id, request_key

Nguồn tham khảo

5 tool

  • list_sources

    Đọc

    Liệt kê các liên kết nguồn của dự án, tài liệu tham chiếu đã tải lên và trạng thái phân tích của chúng.

    Bắt buộc
    project_id

  • create_source

    GhiCần interactive

    Thêm một nguồn: trang web, video hoặc văn bản dán vào.

    Bắt buộc
    project_id, request_key
    Tùy chọn
    url, kind, text, refresh

  • get_source_upload_info

    Đọc

    Lấy đường dẫn tải lên REST có xác thực cho video tham chiếu; không trả về mã bí mật có chữ ký.

    Bắt buộc
    project_id, source_id

  • analyze_source

    Tính phíCần execute

    Phân tích một nguồn đã lấy về trên máy chủ.

    Bắt buộc
    project_id, source_id, request_key
    Tùy chọn
    cap_micros, confirmed

  • select_source_facts

    GhiCần interactive

    Áp dụng các dữ kiện đã được xác nhận rõ ràng và lựa chọn phong cách cấu trúc từ một nguồn đã sẵn sàng vào đầu vào kế hoạch của dự án.

    Bắt buộc
    project_id, source_id, expected_revision, expected_content_hash, request_key
    Tùy chọn
    facts, apply_pacing, apply_visual, apply_tone

Thư viện asset

18 tool

  • list_asset_types

    ĐọcTool cấp workspace

    Liệt kê các loại tài nguyên mở rộng được đăng ký trong workspace.

    Bắt buộc
    workspace_id

  • create_asset_type

    GhiCần interactiveTool cấp workspace

    Đăng ký một loại tài nguyên tùy chỉnh cùng schema, đặc tính và metadata kiểm tra hợp lệ.

    Bắt buộc
    workspace_id, key, label, request_key
    Tùy chọn
    schema_version, schema, traits, validation_rules

  • update_asset_type

    GhiCần interactiveTool cấp workspace

    Sửa một loại tài nguyên tùy chỉnh (nhãn, schema, đặc tính, quy tắc kiểm tra); tăng schema_version.

    Bắt buộc
    workspace_id, type_id, expected_schema_version, request_key
    Tùy chọn
    label, schema, traits, validation_rules

  • delete_asset_type

    GhiCần interactiveTool cấp workspace

    Xóa một loại tài nguyên tùy chỉnh không còn thực thể nào đang dùng.

    Bắt buộc
    workspace_id, type_id, request_key

  • list_asset_entities

    ĐọcTool cấp workspace

    Liệt kê hoặc tìm kiếm các thực thể tài nguyên và phiên bản bất biến hiện tại của chúng. query khớp với tiêu đề và thuộc tính, không phân biệt dấu.

    Bắt buộc
    không có
    Tùy chọn
    workspace_id, project_id, query, type_key, include_archived, limit

  • get_asset_entity

    Đọc

    Đọc một thực thể tài nguyên, định nghĩa loại và phiên bản hiện tại của nó.

    Bắt buộc
    entity_id
    Tùy chọn
    project_id

  • import_asset_entity

    GhiCần interactive

    Tạo thực thể tài nguyên ở dạng NHÁP với thuộc tính được điền tự động từ một phiên bản Library đã duyệt (nhân vật/sản phẩm/thương hiệu) hoặc từ ảnh/video đã sẵn sàng của dự án.

    Bắt buộc
    project_id, request_key
    Tùy chọn
    library_version_id, asset_id, type_key, title

  • create_asset_entity

    GhiCần interactiveTool cấp workspace

    Tạo một phiên bản thực thể tài nguyên từ các thuộc tính có cấu trúc và các tham chiếu media đã sẵn sàng.

    Bắt buộc
    type_key, title, request_key
    Tùy chọn
    workspace_id, project_id, attributes, media_asset_ids, rights, provenance

  • update_asset_entity

    GhiCần interactive

    Tạo phiên bản bất biến kế tiếp của một thực thể tài nguyên.

    Bắt buộc
    entity_id, type_key, title, expected_revision, request_key
    Tùy chọn
    attributes, media_asset_ids, rights, provenance, project_id

  • approve_asset_entity

    GhiCần interactive

    Duyệt phiên bản hiện tại của thực thể tài nguyên sau khi đã xác nhận quyền sử dụng.

    Bắt buộc
    entity_id, expected_revision, request_key
    Tùy chọn
    project_id

  • approve_asset_entities

    GhiCần interactive

    Duyệt nhiều thực thể tài nguyên trong một lời gọi; mỗi thực thể vẫn cần xác nhận quyền sử dụng.

    Bắt buộc
    items, request_key
    Tùy chọn
    project_id

  • archive_asset_entity

    GhiCần interactive

    Xóa (lưu trữ) một thực thể tài nguyên. Lịch sử được giữ lại; thực thể đã lưu trữ không thể ánh xạ hoặc báo giá.

    Bắt buộc
    entity_id, request_key
    Tùy chọn
    project_id

  • restore_asset_entity

    GhiCần interactive

    Khôi phục một thực thể tài nguyên đã lưu trữ.

    Bắt buộc
    entity_id, request_key
    Tùy chọn
    project_id

  • list_scene_asset_bindings

    Đọc

    Đọc các ánh xạ tài nguyên của một bản composition.

    Bắt buộc
    project_id, composition_revision_id

  • suggest_scene_asset_mapping

    Đọc

    Tự động ghép chỉ đọc: tìm các cảnh có lời dẫn, hình ảnh, chủ thể hoặc chữ trên màn hình nhắc đến tiêu đề hoặc bí danh của một tài nguyên.

    Bắt buộc
    project_id, composition_revision_id
    Tùy chọn
    entity_ids

  • preview_scene_asset_mapping

    Đọc

    Xem trước các thay đổi ánh xạ tài nguyên vào cảnh mà không ghi, không gọi nhà cung cấp và không giữ ngân sách.

    Bắt buộc
    project_id, composition_revision_id, mappings

  • apply_scene_asset_mapping

    GhiCần interactive

    Lưu các liên kết tài nguyên xác định vào các cảnh.

    Bắt buộc
    project_id, composition_revision_id, mappings, request_key

  • remove_scene_asset_mapping

    GhiCần interactive

    Gỡ liên kết tài nguyên khỏi một bản composition theo id liên kết hoặc scene_index + role.

    Bắt buộc
    project_id, composition_revision_id, bindings, request_key

Lên storyboard

14 tool

  • get_director_artifacts

    Đọc

    Đọc kịch bản đã kiểm tra, storyboard, danh tính câu chuyện đã duyệt, danh sách tài nguyên và kế hoạch tạo.

    Bắt buộc
    project_id

  • start_planning

    Tính phíCần execute

    Bắt đầu tác vụ lập kế hoạch trên máy chủ. Chạy ngay (không có bước duyệt giá); mức ước tính đã giữ được ghi vào sổ ngân sách.

    Bắt buộc
    project_id, expected_revision, message, request_key
    Tùy chọn
    routing, confirmed

  • submit_external_composition

    Ghi

    Gửi storyboard/composition có kiểu do một AI client bên ngoài soạn.

    Bắt buộc
    project_id, expected_project_revision, expected_composition_revision, context_handle, context_hash, composition, client_task_id, request_key
    Tùy chọn
    provenance, client_kind, external_model

  • propose_storyboard

    GhiCần interactive

    Xem trước một composition sửa đổi hoàn chỉnh kèm lý do; cần người dùng xác nhận, không tạo hay duyệt media.

    Bắt buộc
    project_id, composition, rationale

  • create_draft_change

    GhiCần interactive

    Xem trước một thay đổi nháp của văn bản cảnh; cần người dùng xác nhận.

    Bắt buộc
    project_id, scene_index, field, value

  • get_scene_detail

    Đọc

    Đọc một cảnh từ composition mới nhất.

    Bắt buộc
    project_id, scene_index, composition_id

  • get_plan_nodes

    Đọc

    Đọc trạng thái pipeline theo từng cảnh của kế hoạch: outline -> expanded -> lint -> keyframe -> quoted -> generated -> locked, số lượng theo chương, các cảnh mà một tác vụ AI còn đang viết (busy) và outline đang chờ.

    Bắt buộc
    project_id

  • plan_outline

    Tính phíCần execute

    Giai đoạn 1 của lập kế hoạch phim dài: AI chỉ viết outline (logline, thế giới, dàn nhân vật, các chương và một dòng cho mỗi cảnh), chưa viết các cảnh đầy đủ.

    Bắt buộc
    project_id, expected_revision, message, request_key
    Tùy chọn
    scene_count, confirmed

  • quote_outline_chapters

    Đọc

    Báo giá việc viết các dòng cảnh của một kế hoạch chương, mỗi chương một tác vụ tính phí.

    Bắt buộc
    project_id, intent_id
    Tùy chọn
    chapters

  • write_outline_chapters

    Tính phíCần execute

    Giai đoạn 1b của phim dài: AI viết các dòng cảnh của từng chương trong kế hoạch chương đã duyệt, mỗi chương một tác vụ tính phí.

    Bắt buộc
    project_id, intent_id, request_key
    Tùy chọn
    chapters, cap_micros, confirmed

  • approve_outline

    GhiCần interactiveNgười dùng xác nhận

    Duyệt outline đang chờ (intent_id lấy từ outline.intent_id của get_plan_nodes; với kế hoạch chương thì chỉ khi mọi chương đã có cảnh): tạo khung kế hoạch thành bản composition kế tiếp, mỗi dòng outline một cảnh.

    Bắt buộc
    project_id, intent_id, request_key, confirmed

  • quote_expand

    Đọc

    Báo giá một lần mở rộng: những cảnh nào sẽ được viết, trong bao nhiêu lô và tổng số tiền giữ.

    Bắt buộc
    project_id, expected_revision
    Tùy chọn
    scope, chapter, shot_ids, reexpand

  • expand_scenes

    Tính phíCần execute

    Giai đoạn 2: AI viết các cảnh đầy đủ (hình ảnh, lời dẫn, phụ đề, lời thoại, chỉ đạo) cho các cảnh đã chọn, mỗi lô 5 cảnh là một tác vụ tính phí, lấy thế giới, dàn nhân vật và các cảnh lân cận làm ngữ cảnh.

    Bắt buộc
    project_id, expected_revision, request_key
    Tùy chọn
    scope, chapter, shot_ids, reexpand, cap_micros, confirmed

  • patch_scenes

    GhiCần interactive

    Sửa theo từng trường các cảnh đã có mà không cần gửi lại toàn bộ composition: patches = [{index hoặc shot_id, set: {title, visual, narration, subtitle, overlay, speech_window, director, transition, keyframes}}]. preview=true trả về phần khác biệt và không lưu gì.

    Bắt buộc
    project_id, expected_revision, patches, request_key
    Tùy chọn
    preview

Báo giá và duyệt

3 tool

  • create_quote

    Tính phíCần execute

    Tạo và lưu một báo giá (giá từng cảnh và tổng) từ composition hiện tại; không gửi media.

    Bắt buộc
    project_id, composition_id, request_key
    Tùy chọn
    resolution, candidates, voice, voice_model, image_model, image_size, music_model, music_prompt, subtitles, audio_mode, audio_mix, phase, rendition_ratios, base_run_id, force_nodes, regenerate_reason

  • approve_production

    Tính phíCần execute

    Gửi sản xuất cho một báo giá đã lưu qua outbox bền vững, không có bước duyệt giá: nó bắt đầu ngay.

    Bắt buộc
    project_id, quote_id, expected_content_hash, request_key
    Tùy chọn
    cap_micros, confirmed

  • confirm_tool

    GhiCần interactive

    Thực thi một tool agent đã xem trước trước đó bằng mã xác nhận có thời hạn ngắn.

    Bắt buộc
    session_id, confirmation_token, request_key

Media độc lập

3 tool

  • quote_media_task

    GhiCần interactiveTool cấp workspace

    Báo giá một tác vụ lẻ về giọng nói, nhạc, hiệu ứng âm thanh hoặc ảnh mà không cần storyboard dự án.

    Bắt buộc
    workspace_id, kind, request_key
    Tùy chọn
    duration_seconds, resolution, route, reference_asset_id, text, voice, language, style, prompt, model, size, ratio, operation, source_asset_id, mask_asset_id, reference_asset_ids

  • generate_media_task

    Tính phíCần executeTool cấp workspace

    Chạy một tác vụ giọng nói, nhạc, hiệu ứng âm thanh hoặc ảnh đã báo giá; nó bắt đầu ngay.

    Bắt buộc
    workspace_id, task_id, request_key
    Tùy chọn
    confirmation_digest, cap_micros, confirmed

  • get_media_task

    ĐọcTool cấp workspace

    Đọc một tác vụ lẻ về giọng nói hoặc ảnh: trạng thái, error_code và, khi READY, một download_path có xác thực.

    Bắt buộc
    workspace_id, task_id

Sản xuất

5 tool

  • get_production_state

    Đọc

    Đọc các báo giá, phê duyệt, lần chạy, tác vụ và tiến độ nhà cung cấp của dự án.

    Bắt buộc
    project_id

  • get_run_progress

    Đọc

    Đọc tiến độ của lần chạy mới nhất hoặc lần chạy được chọn.

    Bắt buộc
    project_id
    Tùy chọn
    run_id

  • resume_run

    Tính phíCần execute

    Tiếp tục một lần chạy đã dừng (PAUSED_BUDGET/NEEDS_ATTENTION) theo cùng phê duyệt, tối đa 3 lần thử cho mỗi tác vụ.

    Bắt buộc
    project_id, run_id, approval_id, action, request_key
    Tùy chọn
    confirmed

  • list_available_media

    Đọc

    Liệt kê media đã kiểm tra checksum và đang có sẵn: các video thành phẩm (kind video), gồm cả clip đã hoàn tất của một lần sản xuất chưa xong, đang tạm dừng, thất bại hoặc đang chạy, và các ảnh keyframe đã xong (kind keyframe, ví dụ từ lần chạy KEYFRAMES_READY).

    Bắt buộc
    project_id
    Tùy chọn
    run_id

  • get_media_asset

    Đọc

    Trả về metadata và đường dẫn tải xuống có xác thực cho một video thành phẩm hoặc ảnh keyframe đã được xác minh.

    Bắt buộc
    project_id, artifact_id, name

Review

3 tool

  • get_review_state

    Đọc

    Đọc các vòng duyệt cũ, bình luận và mức sẵn sàng bàn giao của từng lần chạy.

    Bắt buộc
    project_id

  • decide_review

    GhiCần interactiveNgười dùng xác nhận

    Cũ, tùy chọn: ghi một ghi chú approve/request_changes vào vòng duyệt đang mở.

    Bắt buộc
    project_id, run_id, decision, confirmed, request_key
    Tùy chọn
    note, quality_checks

  • save_feedback

    GhiCần interactive

    Xem trước việc lưu phản hồi vào một vòng duyệt đang mở; cần người dùng xác nhận.

    Bắt buộc
    project_id, run_id, text

Bàn giao

4 tool

  • prepare_delivery

    GhiCần interactive

    Chuẩn bị manifest bàn giao cho một lần chạy READY (không có cổng QC thủ công; vòng duyệt tự đóng).

    Bắt buộc
    project_id, run_id, request_key

  • issue_delivery

    GhiCần interactiveNgười dùng xác nhận

    Dựng và phát hành gói bàn giao cho một lần chạy READY qua đường lưu trữ riêng hiện có.

    Bắt buộc
    project_id, run_id, confirmed, request_key

  • list_deliveries

    Đọc

    Liệt kê các bản bàn giao của dự án hiện tại.

    Bắt buộc
    project_id

  • get_delivery_download

    Đọc

    Ghi nhật ký kiểm tra và trả về metadata tải xuống riêng cho một bản bàn giao đã phát hành; không trả về mã bí mật có chữ ký.

    Bắt buộc
    project_id, delivery_id, request_key

Giao diện Studio

2 tool

  • open_workspace_view

    GhiCần interactive

    Chuyển đến một màn hình workspace nằm trong danh sách cho phép.

    Bắt buộc
    project_id, view
    Tùy chọn
    filter, query

  • focus_scene

    GhiCần interactive

    Đưa một cảnh vào tiêu điểm trên Canvas.

    Bắt buộc
    project_id, scene_index

Thư viện thương hiệu và sản phẩm

4 tool

  • list_library

    ĐọcTool cấp workspace

    Liệt kê các mục thư viện thương hiệu/sản phẩm/nhân vật và các phiên bản của chúng trong workspace.

    Bắt buộc
    workspace_id

  • save_library_version

    GhiCần interactiveTool cấp workspace

    Lưu một phiên bản NHÁP mới của một mục thư viện (thương hiệu, sản phẩm hoặc nhân vật).

    Bắt buộc
    workspace_id, kind, content, request_key
    Tùy chọn
    item_id, expected_version

  • approve_library_version

    GhiCần interactiveTool cấp workspace

    Duyệt một phiên bản thư viện sau khi đã xác nhận quyền sử dụng; chỉ phiên bản đã duyệt mới áp dụng được cho dự án.

    Bắt buộc
    workspace_id, version_id, expected_content_hash, request_key

  • apply_library_to_project

    GhiCần interactive

    Gắn tối đa ba phiên bản thư viện đã duyệt (một thương hiệu, một sản phẩm, một nhân vật) vào kế hoạch dự án.

    Bắt buộc
    project_id, expected_revision, version_ids, request_key

Story bible

4 tool

  • list_story_bible

    ĐọcTool cấp workspace

    Liệt kê các thực thể sổ tay câu chuyện (nhân vật, trang phục, đạo cụ, địa điểm, sinh vật, đám đông, giọng nói, phong cách, ràng buộc, thế giới) và các phiên bản.

    Bắt buộc
    workspace_id

  • save_story_bible_version

    GhiCần interactiveTool cấp workspace

    Lưu một phiên bản NHÁP mới của sổ tay câu chuyện (bỏ bible_id để tạo thực thể).

    Bắt buộc
    workspace_id, kind, content, request_key
    Tùy chọn
    bible_id, expected_version

  • approve_story_bible_version

    GhiCần interactiveTool cấp workspace

    Duyệt một phiên bản sổ tay câu chuyện để các cảnh có thể tham chiếu.

    Bắt buộc
    workspace_id, version_id, expected_content_hash, request_key

  • apply_story_bible_to_project

    GhiCần interactive

    Gắn các phiên bản sổ tay câu chuyện đã duyệt vào dự án (thay thế bộ hiện tại).

    Bắt buộc
    project_id, expected_revision, request_key
    Tùy chọn
    version_ids

Dữ liệu dự án và cảnh

15 tool

  • list_projects

    ĐọcTool cấp workspace

    Liệt kê các dự án của một workspace (mới nhất trước), có thể lọc theo thư mục hoặc đã lưu trữ.

    Bắt buộc
    workspace_id
    Tùy chọn
    folder_id, archived

  • update_project

    GhiCần interactive

    Cập nhật tiêu đề, sản phẩm, brief, thời lượng, tỉ lệ, preset, ghi đè/định tuyến/lời thoại của dự án hoặc các tài nguyên đính kèm (asset_ids THAY THẾ bộ đính kèm, không giới hạn theo dự án; dùng list_project_assets để lấy id, kể cả ảnh đã chỉnh sửa).

    Bắt buộc
    project_id, expected_revision, request_key
    Tùy chọn
    title, product, brief, duration, ratio, preset, overrides, routing, speech, asset_ids

  • get_workspace

    ĐọcTool cấp workspace

    Đọc workspace (id, tên, vai trò của bạn).

    Bắt buộc
    workspace_id

  • import_source_image

    GhiCần interactiveNgười dùng xác nhận

    Nhập một ảnh từ bản chụp nguồn đã lấy về (chỉ số 0-11) vào dự án thành một tài nguyên sẵn sàng.

    Bắt buộc
    project_id, source_id, index, expected_revision, request_key, confirmed

  • list_project_assets

    Đọc

    Liệt kê mọi tài nguyên ảnh/video đã sẵn sàng của dự án, dù đã đính kèm hay chưa (id, mime, dung lượng, kích thước, nguồn gốc source_asset_id/operation/params cho ảnh đã chỉnh sửa, cờ attached).

    Bắt buộc
    project_id

  • list_presets

    ĐọcTool cấp workspace

    Liệt kê các preset sáng tạo (định dạng, phong cách) mà dự án có thể bắt đầu từ đó.

    Bắt buộc
    workspace_id

  • get_shot_graph

    Đọc

    Đọc đồ thị cảnh: các cảnh, phụ thuộc, danh tính đã duyệt và liên kết tái sử dụng.

    Bắt buộc
    project_id

  • edit_composition

    GhiCần interactive

    Lưu bản composition kế tiếp của dự án từ một đối tượng Composition đầy đủ (cùng nội dung như trình soạn Canvas).

    Bắt buộc
    project_id, expected_revision, composition, request_key

  • compile_scene_prompt

    Đọc

    Miễn phí, chỉ đọc: biên dịch một cảnh của composition thành đúng prompt mà một báo giá sẽ đóng băng.

    Bắt buộc
    project_id, composition_id, scene_index

  • import_scene_prompt

    Đọc

    Miễn phí, chỉ đọc, không dùng AI: đọc prompt thủ công được dán của một cảnh thành các trường cảnh có cấu trúc.

    Bắt buộc
    project_id, composition_id, scene_index
    Tùy chọn
    raw_prompt, shot

  • add_scene

    GhiCần interactive

    Thêm một cảnh trống vào kế hoạch (bản composition mới; không tạo tác vụ tính phí). index = vị trí của cảnh mới (0 = đầu, bỏ trống = thêm cuối); cảnh mới thuộc chương của cảnh đứng trước và sao chép loại, model và thời lượng của cảnh đó.

    Bắt buộc
    project_id, expected_revision, request_key
    Tùy chọn
    index, title

  • duplicate_scene

    GhiCần interactive

    Nhân đôi cảnh `index` ngay sau chính nó (bản composition mới; không tạo tác vụ tính phí).

    Bắt buộc
    project_id, expected_revision, index, request_key
    Tùy chọn
    title

  • delete_scene

    GhiCần interactive

    Xóa cảnh `index` (bản composition mới; bản trước vẫn nằm trong lịch sử).

    Bắt buộc
    project_id, expected_revision, index, request_key

  • get_run_script

    Đọc

    Đọc bản chụp kịch bản/storyboard đã duyệt mà một lần sản xuất được dựng từ đó.

    Bắt buộc
    project_id, run_id

  • get_run_provenance

    Đọc

    Đọc hồ sơ nguồn gốc của một lần chạy (model, prompt, nguồn, quyền sử dụng).

    Bắt buộc
    project_id, run_id

Thư viện media

8 tool

  • list_media_library

    ĐọcTool cấp workspace

    Liệt kê thư viện media của workspace: ảnh, video, âm thanh và tài liệu kèm cờ yêu thích, đã nâng độ phân giải và đã lưu trữ.

    Bắt buộc
    workspace_id
    Tùy chọn
    scope, kind, favorite, upscaled, archived, resolution, ratio, project_id, created_from, created_to, q, sort, limit, offset

  • mark_media

    GhiCần interactiveTool cấp workspace

    Đánh dấu/bỏ đánh dấu yêu thích hoặc lưu trữ/bỏ lưu trữ tối đa 100 mục thư viện media (hoàn tác được, miễn phí).

    Bắt buộc
    workspace_id, media_ids, action, request_key

  • set_voice_favorite

    GhiCần interactiveTool cấp workspace

    Đánh dấu hoặc bỏ đánh dấu yêu thích một giọng của thư viện giọng (tên lấy từ list_voices) cho người dùng đang gọi.

    Bắt buộc
    workspace_id, voice, favorite, request_key

  • add_media_to_project

    GhiCần interactive

    Đính kèm media của thư viện (id lấy từ list_media_library) vào dự án thành tài nguyên.

    Bắt buộc
    project_id, media_ids, request_key

  • list_videos

    ĐọcTool cấp workspace

    Liệt kê thư viện Videos của workspace: mọi video đã tạo (bản dựng, clip, chỉnh sửa, tác vụ), mới nhất trước, kèm tiêu đề, prompt, dự án, model, kích thước, trạng thái (active|delivered|deleted), in_use (lý do delete_videos sẽ từ chối ngay lúc này) và days_left cho các video đã xóa.

    Bắt buộc
    workspace_id
    Tùy chọn
    project_id, model, kind, status, created_from, created_to, q, cursor, limit

  • delete_videos

    GhiCần interactiveNgười dùng xác nhậnTool cấp workspace

    Xóa mềm tối đa 100 video (id lấy từ list_videos).

    Bắt buộc
    workspace_id, ids, request_key, confirmed

  • restore_videos

    GhiCần interactiveTool cấp workspace

    Khôi phục các video đã xóa (id từ list_videos với status=deleted) trong thời hạn 7 ngày của chúng.

    Bắt buộc
    workspace_id, ids, request_key

  • create_asset_element

    GhiCần interactiveTool cấp workspace

    Tạo nhanh một phần tử: các tài nguyên media đã sẵn sàng cùng một @tên duy nhất và mô tả; rights_confirmed là quyết định của con người.

    Bắt buộc
    workspace_id, name, media_asset_ids, request_key
    Tùy chọn
    description, type_key, rights_confirmed

Khám phá

4 tool

  • list_explore_items

    ĐọcTool cấp workspace

    Explore: các video đã hoàn thành của workspace dưới dạng thẻ, cùng các thẻ kỹ năng.

    Bắt buộc
    workspace_id
    Tùy chọn
    category, sub_category, q, limit

  • get_explore_board

    Đọc

    Đọc bảng hậu trường của một dự án đã hoàn thành: ảnh tham chiếu, các cảnh storyboard theo thứ tự và video cuối.

    Bắt buộc
    project_id

  • reverse_source_video

    Đọc

    Đảo ngược một nguồn video tham chiếu đã phân tích thành bảng cảnh (các nhịp với loại cảnh, máy quay, bố cục, chuyển cảnh, kiểu chữ), phong cách hook/nhịp/bảng màu/phụ đề/âm thanh/CTA và các dữ kiện phát hiện được.

    Bắt buộc
    project_id, source_id

  • create_project_from_reverse

    GhiCần interactive

    Bắt đầu một dự án mới trong cùng workspace từ bảng nguồn đã đảo ngược: brief = dàn ý cảnh, tỉ lệ/thời lượng của video, phong cách nguồn (nhịp, hình ảnh, giọng điệu) được chọn sẵn.

    Bắt buộc
    project_id, source_id, request_key
    Tùy chọn
    title

Các bản quay

5 tool

  • list_takes

    Đọc

    Liệt kê các lượt dựng đã tạo cho từng cảnh cùng điểm số, khóa và các lô đang mở.

    Bắt buộc
    project_id

  • assess_take

    GhiCần interactive

    Chấm một lượt dựng từ 0-5 về nhận dạng, khung hình, chuyển động, ánh sáng và âm thanh kèm bằng chứng bằng lời.

    Bắt buộc
    project_id, artifact_id, scores, evidence, request_key

  • lock_take

    GhiCần interactive

    Khóa lượt dựng đã chọn của một cảnh (artifact_id) vào một bản composition, hoặc null để mở khóa.

    Bắt buộc
    project_id, composition_id, expected_revision, shot, artifact_id, request_key

  • prepare_take_batch

    GhiCần interactive

    Đóng băng giá của các lượt dựng bổ sung (1-3) cho một cảnh.

    Bắt buộc
    project_id, quote, shot, reason, request_key
    Tùy chọn
    takes

  • approve_take_batch

    Tính phíCần execute

    Gửi ngay một lô lượt dựng đã chuẩn bị (các lượt dựng bổ sung).

    Bắt buộc
    project_id, batch_id, expected_hash, request_key
    Tùy chọn
    cap_micros, confirmed

Bình luận review

4 tool

  • add_review_comment

    GhiCần interactive

    Thêm một bình luận duyệt vào một lần chạy, có thể ghim vào một cảnh và mốc thời gian.

    Bắt buộc
    project_id, run_id, text, request_key
    Tùy chọn
    shot, timestamp_ms

  • resolve_review_comment

    GhiCần interactive

    Đánh dấu một bình luận duyệt là đã xử lý.

    Bắt buộc
    project_id, comment_id, request_key

  • reopen_review_comment

    GhiCần interactive

    Mở lại một bình luận duyệt đã xử lý.

    Bắt buộc
    project_id, comment_id, request_key

  • reopen_review_round

    GhiCần interactive

    Mở lại vòng duyệt của một lần chạy sau khi đã duyệt để có thể yêu cầu chỉnh sửa tiếp.

    Bắt buộc
    project_id, run_id, request_key

Kho bàn giao

5 tool

  • revoke_delivery

    GhiCần interactiveNgười dùng xác nhận

    Thu hồi một bản bàn giao đã phát hành để gói của nó không thể tải xuống nữa.

    Bắt buộc
    project_id, delivery_id, reason, request_key, confirmed

  • search_deliveries

    ĐọcTool cấp workspace

    Tìm trong thư viện bàn giao của workspace (bộ lọc: search, project_id, sku, branch_id, date_from/date_to YYYY-MM-DD, status, ratio).

    Bắt buộc
    workspace_id
    Tùy chọn
    page, page_size, search, project_id, sku, branch_id, date_from, date_to, status, ratio

  • list_delivery_options

    ĐọcTool cấp workspace

    Liệt kê các bản bàn giao có thể gộp vào một gói theo lô.

    Bắt buộc
    workspace_id

  • list_delivery_batches

    ĐọcTool cấp workspace

    Liệt kê các gói bàn giao theo lô gồm nhiều bản đã phát hành.

    Bắt buộc
    workspace_id

  • create_delivery_batch

    GhiCần interactiveTool cấp workspace

    Gộp tối đa 50 bản bàn giao đã phát hành thành một gói theo lô có thể tải xuống.

    Bắt buộc
    workspace_id, title, delivery_ids, request_key

Nhánh dự án

6 tool

  • list_project_branches

    Đọc

    Liệt kê các nhánh của một dự án (chính + biến thể). project_id là dự án GỐC của họ nhánh.

    Bắt buộc
    project_id

  • create_project_branch

    GhiCần interactive

    Tạo một nhánh từ một lần chạy đã xong: bản sao kế hoạch của nó với các chỉnh sửa cảnh để trả lời các bình luận duyệt còn mở. project_id là dự án GỐC của họ nhánh. edits = [{shot, title?, visual?, narration?, subtitle?, overlay?}].

    Bắt buộc
    project_id, parent_branch_id, parent_run_id, name, comment_ids, edits, request_key

  • rename_project_branch

    GhiCần interactive

    Đổi tên một nhánh. project_id là dự án GỐC của họ nhánh.

    Bắt buộc
    project_id, branch_id, name, request_key

  • archive_project_branch

    GhiCần interactiveNgười dùng xác nhận

    Lưu trữ một nhánh (lịch sử được giữ lại). project_id là dự án GỐC của họ nhánh.

    Bắt buộc
    project_id, branch_id, request_key, confirmed

  • restore_project_branch

    GhiCần interactive

    Khôi phục một nhánh đã lưu trữ. project_id là dự án GỐC của họ nhánh.

    Bắt buộc
    project_id, branch_id, request_key

  • promote_project_branch

    GhiCần interactiveNgười dùng xác nhận

    Đặt một nhánh làm nhánh chính của họ dự án. project_id là dự án GỐC của họ nhánh.

    Bắt buộc
    project_id, branch_id, request_key, confirmed

Kéo dài và dịch

4 tool

  • prepare_extension

    GhiCần interactive

    Chuẩn bị phần nối dài của một lần chạy đã xong: lấy khung hình cuối của clip cuối làm ranh giới liên tục.

    Bắt buộc
    project_id, parent_run_id, expected_content_hash, request_key

  • get_extension

    Đọc

    Đọc một phần nối dài đã chuẩn bị (intent) cùng metadata khung hình ranh giới và kết quả.

    Bắt buộc
    project_id, intent_id

  • create_extension

    GhiCần interactive

    Tạo dự án nối dài từ một intent đã chuẩn bị: một cảnh mới 3-10 giây tiếp nối từ khung hình ranh giới. boundary_confirmed là việc con người đã kiểm tra khung hình.

    Bắt buộc
    project_id, intent_id, name, title, visual, duration_ms, video_model, continuity_notes, request_key
    Tùy chọn
    narration, boundary_confirmed

  • create_locale

    GhiCần interactive

    Tạo phiên bản bản địa hóa (lời dẫn/phụ đề đã dịch, giọng mới) của một lần chạy đã xong thành một dự án mới. shots = [{shot, narration, subtitle, speech_window?}].

    Bắt buộc
    project_id, parent_run_id, expected_content_hash, name, language, shots, request_key
    Tùy chọn
    voice, voice_model, transcript_confirmed

Giọng đọc và nhập bảng tính

6 tool

  • quote_voice_sample

    ĐọcTool cấp workspace

    Giá của một lần nghe thử giọng (mức trần cố định).

    Bắt buộc
    workspace_id

  • create_voice_sample

    Tính phíCần executeTool cấp workspace

    Tạo một mẫu nghe thử TTS ngắn (<=240 ký tự).

    Bắt buộc
    workspace_id, voice, text, request_key
    Tùy chọn
    language, style, pronunciations, cap_micros, confirmed

  • get_voice_sample

    ĐọcTool cấp workspace

    Đọc một mẫu giọng: trạng thái (QUEUED, READY, FAILED...) và, khi READY, đường dẫn âm thanh của nó.

    Bắt buộc
    workspace_id, sample_id

  • get_import_template

    ĐọcTool cấp workspace

    Trả về mẫu Excel (các cột + .xlsx dạng base64) cho yêu cầu video hàng loạt.

    Bắt buộc
    workspace_id

  • preview_import

    ĐọcTool cấp workspace

    Phân tích một workbook Excel đã điền (base64, <=4 MB, <=100 dòng) thành các dòng mà không tạo gì.

    Bắt buộc
    workspace_id, xlsx_base64

  • import_project_row

    GhiCần interactiveTool cấp workspace

    Tạo một dự án từ một dòng Excel đã xem trước (các trường như preview_import trả về) và tải về image_urls công khai của nó. rights_confirmed là xác nhận của con người rằng họ được phép dùng văn bản và hình ảnh.

    Bắt buộc
    workspace_id, fields, rights_confirmed, request_key
    Tùy chọn
    image_urls

Tải ảnh tham chiếu

4 tool

  • create_asset_upload_intent

    GhiCần interactive

    Đăng ký một lần tải ảnh/video lên cho dự án (không giới hạn số tệp; mỗi ảnh <=50 MB).

    Bắt buộc
    project_id, filename, mime, size, sha256, request_key

  • upload_asset_content

    GhiCần interactive

    Tải lên các byte (base64, đúng dung lượng đã đăng ký) của một tài nguyên đã đăng ký.

    Bắt buộc
    project_id, asset_id, content_base64, request_key

  • finalize_asset_upload

    GhiCần interactive

    Kiểm tra các byte đã tải lên (checksum, dung lượng, media giải mã được) và đánh dấu tài nguyên sẵn sàng sử dụng. attach=true còn THÊM nó vào các tham chiếu đính kèm của dự án (giữ nguyên các tham chiếu khác; không cần expected_revision) và trả về attached, project_revision và asset_ids.

    Bắt buộc
    project_id, asset_id, request_key
    Tùy chọn
    attach

  • abandon_asset_upload

    GhiCần interactive

    Hủy một lần tải lên chưa được đính kèm vào kế hoạch dự án.

    Bắt buộc
    project_id, asset_id, request_key

Chỉnh ảnh

2 tool

  • edit_image

    GhiCần interactive

    Chỉnh sửa ảnh dự án miễn phí, tức thì (cắt, xoay, lật, đổi kích thước, chia thành lưới) tạo ra một tài nguyên mới; ảnh nguồn không bao giờ bị ghi đè.

    Bắt buộc
    project_id, asset_id, operation, params, request_key

  • save_media_task_as_asset

    GhiCần interactiveTool cấp workspace

    Đăng ký ảnh đã xong của một tác vụ media READY (get_media_task state=READY) thành tài nguyên dự án mới.

    Bắt buộc
    workspace_id, task_id, request_key
    Tùy chọn
    project_id, filename

Chỉnh video

11 tool

  • edit_trim

    GhiCần interactive

    Chỉ giữ đoạn start_s..end_s của video (giây).

    Bắt buộc
    project_id, request_key
    Tùy chọn
    asset_id, run_id, params, executor

  • edit_reframe

    GhiCần interactive

    Đổi tỉ lệ khung hình: fill cắt quanh focus_x/focus_y (0..1), fit thêm viền đen.

    Bắt buộc
    project_id, request_key
    Tùy chọn
    asset_id, run_id, params, executor

  • edit_color

    GhiCần interactive

    Màu sắc: preset cùng độ phơi sáng (-1..1), tương phản (0.5..1.5), độ bão hòa (0..2).

    Bắt buộc
    project_id, request_key
    Tùy chọn
    asset_id, run_id, params, executor

  • edit_loudness

    GhiCần interactive

    Chuẩn hóa độ lớn âm thanh về target_lufs với trần true-peak (EBU R128 hai lượt).

    Bắt buộc
    project_id, request_key
    Tùy chọn
    asset_id, run_id, params, executor

  • edit_speed

    GhiCần interactive

    Phát toàn bộ video nhanh hơn hoặc chậm hơn (0.5..2x), giữ nguyên cao độ âm thanh.

    Bắt buộc
    project_id, request_key
    Tùy chọn
    asset_id, run_id, params, executor

  • edit_fade

    GhiCần interactive

    Hiện dần hình và tiếng từ màu đen ở đầu và/hoặc mờ dần ở cuối.

    Bắt buộc
    project_id, request_key
    Tùy chọn
    asset_id, run_id, params, executor

  • edit_text_overlay

    GhiCần interactive

    In một dòng chữ (trên, giữa hoặc dưới) cho cả video hoặc đoạn start_s..end_s.

    Bắt buộc
    project_id, request_key
    Tùy chọn
    asset_id, run_id, params, executor

  • measure_media

    GhiCần interactive

    Đo thời lượng, kích thước, độ lớn (LUFS, true peak) và các đoạn đen/im lặng; không tạo tệp mới.

    Bắt buộc
    project_id, request_key
    Tùy chọn
    asset_id, run_id, params, executor

  • get_edit_options

    ĐọcTool cấp workspace

    Liệt kê các tool chỉnh sửa video (params_schema, cost_class, executors) và những executor đang trực tuyến cho bạn: cloud_ffmpeg luôn trực tuyến; craft_local liệt kê các ứng dụng Local Studio đang mở của bạn. queued_for_local đếm các việc của bạn đang chờ một ứng dụng.

    Bắt buộc
    workspace_id

  • get_edit_job

    Đọc

    Đọc một việc chỉnh sửa: trạng thái QUEUED|RUNNING|READY|FAILED, executor, error_code và, khi READY, kết quả {asset_id, diff, before, after, previews}.

    Bắt buộc
    project_id, job_id

  • list_edit_jobs

    Đọc

    Liệt kê 30 việc chỉnh sửa mới nhất của dự án, mới nhất trước.

    Bắt buộc
    project_id

Lô clip

3 tool

  • create_media_batch

    Tính phíCần executeTool cấp workspace

    Tạo nhiều clip video từ một bảng (văn bản CSV, .xlsx dạng base64, hoặc rows = danh sách đối tượng {cột: giá trị}), tối đa 100 dòng. template dùng biến {{column}}; không có template thì cột prompt của mỗi dòng là prompt.

    Bắt buộc
    workspace_id, request_key
    Tùy chọn
    csv, xlsx_base64, rows, template, route, duration_seconds, ratio, resolution, reference_asset_id, project_id, start

  • get_media_batch

    ĐọcTool cấp workspace

    Đọc một lô clip: trạng thái (draft, running, paused, completed, cancelled), số lượng theo trạng thái (pending, queued, running, ready, attention, cancelled), tiến độ, mức ước tính đã lưu và, khi đã có clip sẵn sàng, một download_path đến tệp ZIP.

    Bắt buộc
    workspace_id, batch_id

  • list_media_batch_items

    ĐọcTool cấp workspace

    Liệt kê các mục của một lô clip theo thứ tự dòng: row, task_id, state (pending, queued, running, ready, needs_attention, cancelled), error_code, prompt và giá từng mục; mục đã sẵn sàng còn có download_path.

    Bắt buộc
    workspace_id, batch_id
    Tùy chọn
    state, limit, offset