Tạo video

Hỗ trợ tạo video từ văn bản, tạo video từ hình ảnh và Video-to-Video Remix.

POST/v1/video/generations

Tạo tác vụ tạo video Grok, hỗ trợ tạo video từ văn bản, tạo video từ hình ảnh và Video-to-Video Remix.

Ví dụ ID mô hình là grok-imagine-video. Các ví dụ dùng MODEL_ID; mô hình khả dụng thực tế tùy thuộc vào danh sách mô hình mà API Key hiện tại trả về.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Yêu cầu tạo video Grok.

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

model*string

ID mô hình video Grok, ví dụ grok-imagine-video. Mô hình khả dụng thực tế tùy thuộc vào danh sách mô hình mà API Key hiện tại trả về.

Độ dài1 <= length

prompt*string

Mô tả nội dung video muốn tạo hoặc vẽ lại.

Độ dài1 <= length

duration?integer

Thời lượng video, tính bằng giây, chỉ áp dụng cho tạo video từ văn bản/hình ảnh. Phạm vi là 1–15, mặc định là 5. Chế độ Remix không hỗ trợ trường này; thời lượng đầu ra bằng đầu vào và tối đa 8.7 giây.

Phạm vi1 <= value <= 15

Giá trị mặc định5

images?array<string>

Danh sách hình ảnh đầu vào để tạo video từ hình ảnh. Chọn trường này hoặc image.

image?string

Một hình ảnh để tạo video từ hình ảnh, có thể là URL công khai hoặc Base64 Data URI. Chọn trường này hoặc images.

metadata?

Tham số mở rộng truyền tới upstream. Đối tượng này có thể chuyển tiếp các tham số nâng cao khác mà Grok hỗ trợ, như seed, negative_prompt và fps.

Nền tảng tính mức tiêu thụ hạn mức động theo tham số yêu cầu. Ứng dụng nên lưu cả metadata để hỗ trợ đối soát và tái hiện.

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Một thành phố cyberpunk trên mây",    "duration": 5,    "image": "https://example.com/init-frame.png",    "metadata": {      "resolution": "720p"    }  }'

{
  "id": "xai-task-12345"
}

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`