# Wandura API v2

> **Tóm tắt** — Chạy một **style** ảnh hoặc video làm sẵn bằng một lệnh HTTPS từ máy chủ của bạn, rồi hỏi kết quả (poll) hoặc nhận webhook có ký. Bạn không chọn model; chỉ trả tiền cho lần chạy có kết quả. Key test (`wdr_test_…`) trả mẫu với giá $0. Base URL: `https://api.wandura.ai`.

Đây là API tạo ảnh và video bằng style của Wandura. (Phát phim có bản quyền trong app là API khác: xem [Delivery API](https://docs.wandura.ai/vi/developers).)

## Chọn đường đi
## Hai cách gọi cùng một động cơ
**Bắt đầu bằng jobs.** Tích hợp mới dùng [Jobs API](https://docs.wandura.ai/vi/developers/api-v2/jobs): một cửa, một bộ chữ cho trạng thái và lỗi. Runs vẫn được hỗ trợ và chạy trên cùng động cơ; những gì bạn đã dựng trên runs không đổi.

|  | Jobs (khuyên dùng) | Runs |
|---|---|---|
| Gửi | `POST /v2/jobs` | `POST /v2/styles/{style}` |
| Kết quả | Một **job**: `job_id`, `GET /v2/jobs/{job_id}`, `webhook_url` có ký | Một **run**: `status_url`, `cancel_url` |
| Trạng thái | `queued`, `processing`, `succeeded`, `failed`, `cancelled`, `timeout` | Cùng bộ chữ đó ở `state` (`status` giữ chữ cũ) |
| Hợp với | Mọi tích hợp mới: app, backend, workflow engine | Tích hợp đã dựng trên runs |
| Giống nhau bên dưới | Key, ví, giá, dự phòng, và không tính tiền lần chạy không có kết quả |  |

**Đang triển khai:** lane Relax (`lane`) và đầu vào riêng của style (`inputs`) trên `POST /v2/jobs`, để style nào chạy được qua runs cũng chạy được thành job (xem [Jobs API](https://docs.wandura.ai/vi/developers/api-v2/jobs#lane-and-inputs)).

## Tham chiếu
- **OpenAPI 3.1** của cả API: [api.wandura.ai/v2/openapi.json](https://api.wandura.ai/v2/openapi.json) (không cần key).
- **Đầu vào của một style**: `GET /v2/public/styles/{style}/openapi.json`.
- **MCP server** cho agent hành động lúc chạy: `https://api.wandura.ai/mcp` (cùng Bearer key).
- Trạng thái và bảo trì: [wandura.instatus.com](https://wandura.instatus.com).