Nhiệm vụ tạo video

Tổng quan giao diện

Tạo video là thao tác bất đồng bộ:

1. Gọi POST /v1/videos/tasks gửi tác vụ
2. Lưu ID tác vụ công khai trong phản hồi
3. Gọi GET /v1/tasks/{task_id} tra cứu trạng thái và kết quả

Base URL là https://api.rokoapi.com/v1. Tất cả các yêu cầu phải kèm theo Authorization: Bearer $API_KEY.

Các mô hình đã hỗ trợ

Phạm vi khả dụng thực tế dựa trên /v1/models, cấu hình kênh trên bảng điều khiển và nhóm của khóa API. Người dùng chỉ chọn mô hình sản phẩm; RokoAPI tự động chọn tuyến văn bản sang video, hình ảnh sang video, tham chiếu sang video hoặc chỉnh sửa của EvoLink dựa trên generation_type và các trường tài liệu để tự động chọn tuyến EvoLink tạo video từ văn bản, hình ảnh, video tham chiếu hoặc chỉnh sửa.

Tạo video từ văn bản

curl https://api.rokoapi.com/v1/videos/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "generation_type": "text",
    "prompt": "A cinematic sunrise over snow mountains",
    "duration": 8,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

Tạo video từ hình ảnh và tham chiếu

Thông thường, truyền tài liệu có thể tải trực tiếp từ mạng công khai qua image_urls, video_urls và audio_urls :

{
  "model": "seedance-2.0",
  "generation_type": "reference",
  "prompt": "Keep the character identity and create a slow camera orbit",
  "image_urls": ["https://example.com/character.png"],
  "video_urls": ["https://example.com/motion.mp4"],
  "duration": 6,
  "quality": "720p",
  "aspect_ratio": "16:9"
}

Ngoại lệ: Tạo video từ hình ảnh của Wan 2.7 sử dụng image_start và tùy chọn image_end; Grok 1.5 tự động chọn chế độ dựa trên số lượng image_urls (0 ảnh là văn bản sang video, 1 ảnh là hình ảnh sang video, 2–7 ảnh là tham chiếu sang video), không nhận aspect_ratio.

Chỉnh sửa video

{
  "model": "wan-2.7",
  "generation_type": "edit",
  "prompt": "Change the background to a rainy neon street",
  "video_urls": ["https://example.com/input.mp4"],
  "image_urls": ["https://example.com/style.png"],
  "duration": 0,
  "quality": "720p"
}

Trong chỉnh sửa của Wan 2.7, duration: 0 có nghĩa là theo video đầu vào. Chỉnh sửa Gemini Omni theo video đầu vào, không gửi duration hoặc aspect_ratio.

Giới hạn tham số

Các tham số mô hình bổ sung trong yêu cầu sẽ được truyền nguyên cấu trúc JSON qua EvoLink, bao gồm negative_prompt, generate_audio, content_filter, sound, prompt_extend và model_params. RokoAPI sẽ kiểm tra trước các giới hạn đã biết như thời lượng, chất lượng hình ảnh, tỷ lệ khung hình, số lượng tài liệu, địa chỉ callback. Giao diện video không hỗ trợ n.

Callback và truy vấn

Tùy chọn callback_url phải là địa chỉ HTTPS công khai, tối đa 2048 ký tự, không được trỏ đến localhost hoặc IP nội bộ. Ngay cả khi cấu hình callback, vẫn nên giữ polling làm cơ chế dự phòng:

curl https://api.rokoapi.com/v1/tasks/task_public_id \
  -H "Authorization: Bearer $API_KEY"

Các trạng thái phổ biến bao gồm queued, in_progress, completed và failed. Liên kết kết quả có thể có thời hạn, môi trường sản xuất nên tải xuống và lưu trữ kịp thời.

Hướng dẫn tính phí

Mô hình áp dụng biểu thức tính phí USD v2 thống nhất, có thể kết hợp số giây đầu ra, số giây video tham chiếu đầu vào, số lượng hình ảnh đầu vào, công tắc âm thanh, độ phân giải, chất lượng, phương thức tạo và mức sử dụng Token trong một công thức. Khi gửi, sẽ tạm trừ theo tham số đã kiểm tra; sau khi hoàn thành, sẽ thanh toán theo Token thực tế hoặc thời lượng đầu ra.

Dưới đây là ảnh chụp giá cố định ngày 2026-08-20, đã bao gồm phí dịch vụ 10% trên giá thành EvoLink công bố, đơn vị đều là USD. Giá không thay đổi theo điểm tích lũy của nhà cung cấp; quản trị viên sẽ cập nhật bảng này và biểu thức backend sau khi xem xét điều chỉnh giá.

Dòng Seedance 2.0

Giá khuyến mãi của Fast và Mini đến từ điều chỉnh giá EvoLink ngày 2026-08-07, sau khi kết thúc sự kiện sẽ không tự động thay đổi giá RokoAPI, khi đó sẽ dựa trên ảnh chụp mới đã được phê duyệt từ backend.

Các mô hình video tính theo giây khác

Kling O3 tính phí đồng thời theo độ phân giải và công tắc âm thanh:

Dòng Sora 2

Giá Token Gemini Omni

Thời lượng video tham chiếu chỉ được tính vào hóa đơn cuối cùng sau khi hệ thống hoàn tất kiểm tra metadata phương tiện hoặc có được lượng tin cậy. Giá đầy đủ dựa trên trang định giá và cấu hình hiện tại trên bảng điều khiển. Nguồn giá từ nhà cung cấp có thể tham khảo Danh mục mô hình EvoLink và trang phát triển của từng mô hình.