Băng hình

1. Tạo nhiệm vụ

Gửi tác vụ và trả về một task ID. Chi phí được ước tính từ thời lượng × giá mỗi giây của mô hình và được quyết toán khi tác vụ được xử lý.

Bất kỳ key nào khác (ví dụ seed, sound) đều được chuyển tiếp nguyên trạng đến nhà cung cấp thượng nguồn — chúng không được xác thực ở đây và mức độ hỗ trợ tùy thuộc vào model.

Ví dụ

Chuyển văn bản thành video

curl https://api.airforce/v1/video/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-2.6",
    "prompt": "A red fox darting across snowy hills at dawn",
    "duration_seconds": 8,
    "aspect_ratio": "16:9",
    "quality": "720p",
    "sound": true
  }'

Chuyển hình ảnh thành video (khung hình đầu tiên)

curl https://api.airforce/v1/video/generations \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-1",
    "mode": "image",
    "prompt": "Camera pulls back as the dragon takes off",
    "duration_seconds": 5,
    "aspect_ratio": "16:9",
    "input_images": [{"url": "https://example.com/dragon.jpg"}]
  }'

Phản ứng

{
  "task_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "queued",
  "model": "wan-2.6",
  "created": 1715000000,
  "expires_at": 1715086400,
  "progress": 0,
  "cost_cents": 320
}

2. Thăm dò trạng thái

Thăm dò ý kiến ​​cứ sau 5–15 giây. Nhiệm vụ thường hoàn thành trong 30 giây - 4 phút tùy thuộc vào thời lượng và kiểu máy. Điểm cuối tương tự trả về URL kết quả khi trạng thái chuyển sang "hoàn thành".

{
  "task_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "status": "completed",
  "progress": 100,
  "result_url": "https://.../video.mp4",
  "model": "wan-2.6",
  "duration_seconds": 8,
  "expires_at": 1715086400,
  "cost_cents": 320
}

2b. Tiến trình truyền phát (tùy chọn)

Bỏ qua vòng bỏ phiếu với luồng Sự kiện do máy chủ gửi. Phát ra một sự kiện cho mỗi thay đổi tiến trình và đóng khi tác vụ ở trạng thái cuối. Hình dạng tải trọng giống như điểm cuối GET.

event: state
data: {"task_id":"f47ac10b-...","status":"processing","progress":12}

event: state
data: {"task_id":"f47ac10b-...","status":"processing","progress":58}

event: state
data: {"task_id":"f47ac10b-...","status":"completed","progress":100,"result_url":"https://.../video.mp4"}

event: done
data: [DONE]

3. Liệt kê và xóa

Trả về các tác vụ gần đây của bạn (mới nhất trước). Hữu ích cho bảng điều khiển để hiển thị chế độ xem lịch sử.

Trả về tối đa 100 task gần nhất của bạn, mới nhất trước, dưới dạng { "data": [ ...tasks ] }. Không có tham số truy vấn — hãy lọc và phân trang ở phía client.

curl https://api.airforce/v1/video/tasks \
  -H "Authorization: Bearer sk-air-YOUR_API_KEY"

Xóa bản ghi tác vụ khỏi lịch sử của bạn.

Idempotent — luôn trả về { "deleted": true }. Thao tác này chỉ xóa bản ghi lịch sử của bạn; nó không xóa riêng phần media đã được lưu trữ.

Chi phí & hạn chế

Mỗi mô hình video hiển thị siêu dữ liệu về khả năng mà bạn có thể đọc từ đó /v1/models:

• Cost is estimated at creation and settled when the job is processed; failed or expired tasks are not charged.
• Max 4 concurrent video tasks per API key.
• Result URLs are pre-signed and stop working at expires_at. Download or copy the MP4 to your own storage if you need it longer.

async function generateVideo(prompt) {
  const create = await fetch('https://api.airforce/v1/video/generations', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'wan-2.6',
      prompt,
      duration_seconds: 8,
      aspect_ratio: '16:9',
      quality: '720p',
    }),
  }).then(r => r.json());

  const { task_id } = create;

  // Poll until done.
  while (true) {
    await new Promise(r => setTimeout(r, 8_000));
    const task = await fetch(
      `https://api.airforce/v1/video/tasks/${task_id}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } },
    ).then(r => r.json());

    if (task.status === 'completed') return task.result_url;
    if (task.status === 'failed' || task.status === 'expired') {
      throw new Error(task.error ?? task.status);
    }
  }
}