Bắt đầu nhanh

Chưa sẵn sàng viết code? Hãy thử Playground — kiểm tra bất kỳ model nào trực tiếp trong trình duyệt của bạn, không cần API key.

1. Tạo tài khoản

Đăng ký tại runbase.net bằng Google hoặc email. Không cần thẻ tín dụng — tài khoản mới sẽ nhận được balance miễn phí để bắt đầu.

2. Lấy API key

Đi tới Settings → API Keys và tạo một key mới. Hãy sao chép và lưu ở nơi an toàn — nó bắt đầu bằng sk- và sẽ không được hiển thị lại.

export RUNBASE_API_KEY="sk-your-key-here"

3. Tạo một run

Gửi một POST tới /api/v1/runs với model ID và các tham số đầu vào:

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": {
      "prompt": "A cozy bookshop interior with warm lighting, watercolor style",
      "aspect_ratio": "1:1"
    }
  }'

Phản hồi:

{
  "id": "run_2abc...",
  "model": "google/nano-banana-2",
  "status": "pending",
  "costUsd": 40000
}

costUsd được tính bằng micro-USD (1 USD = 1,000,000). Chi phí 40,000 nghĩa là $0.04.

4. Kiểm tra kết quả

Dùng run ID để kiểm tra trạng thái:

curl -s https://runbase.net/api/v1/runs/run_2abc... \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Khi status là "succeeded", trường output chứa kết quả:

{
  "id": "run_2abc...",
  "status": "succeeded",
  "model": "google/nano-banana-2",
  "costUsd": 40000,
  "output": {
    "urls": [
      "https://runbase.net/files/generated/abc123.png"
    ]
  },
  "createdAt": "2026-06-01T12:00:00.000Z",
  "completedAt": "2026-06-01T12:00:04.200Z"
}

Nếu một run thất bại, status sẽ là "failed" và chi phí sẽ tự động được hoàn lại vào balance của bạn.

5. Tải xuống hình ảnh

Các URL trong output là liên kết trực tiếp đến các hình ảnh hoặc video được tạo ra. Chúng được phục vụ từ một CDN toàn cầu và có sẵn ngay lập tức.

Tiếp theo là gì

• Core Concepts — hiểu vòng đời run, mô hình async, và cơ chế chi phí
• Authentication — thiết lập IP whitelisting và giới hạn chi tiêu cho môi trường production
• Models — khám phá tất cả các model hiện có và thử chúng trong playground
• Billing — nạp tiền và quản lý balance của bạn