DEV Community: Sebastian Petrus

Cách Sử Dụng Seedance 2.0 API Năm 2026

Sebastian Petrus — Sat, 04 Apr 2026 13:03:47 +0000

Tóm tắt

API Seedance 2.0 ra mắt ngày 2/4/2026, cung cấp qua Volcengine Ark. Bạn gửi yêu cầu POST để tạo video, sau đó thăm dò endpoint GET cho đến khi trạng thái là "succeeded". API hỗ trợ nhiều kiểu đầu vào: chuyển văn bản/hình ảnh thành video, kiểm soát khung hình đầu-cuối, đa phương thức và âm thanh gốc. Video 1080p 5 giây giá khoảng $0,93. Tải video trong 24 giờ, sau đó URL sẽ hết hạn.

Hypereal AI

Thử Hypereal AI

Thử Apidog ngay hôm nay

Giới thiệu

Ngày 2/4/2026, Volcengine Ark (ByteDance) phát hành chính thức API Seedance 2.0. Trước đó, bạn chỉ có thể tạo video Seedance 2.0 qua web UI. Bài viết này hướng dẫn cách sử dụng API thực cho các workflow tự động, kiểm thử, và tích hợp trực tiếp vào sản phẩm.

💡 API Seedance tuân theo mô hình tác vụ không đồng bộ: Gửi POST tạo tác vụ, nhận ID, thăm dò GET cho đến khi hoàn tất. Hãy thử nghiệm workflow từ đầu đến cuối trước khi tích hợp thực tế. Apidog hỗ trợ chuỗi kiểm thử: gửi POST, lấy ID tác vụ, thăm dò GET liên tục, xác nhận phản hồi cuối cùng chứa URL video hợp lệ. Xem phần hướng dẫn kiểm thử chi tiết với Apidog bên dưới.

Bài viết tập trung vào cách tạo các loại đầu vào, đọc chi phí từ phản hồi, xử lý lỗi thực tế, và các ví dụ code cụ thể.

Seedance 2.0 là gì?

Seedance 2.0 là mô hình tạo video AI của ByteDance trên Volcengine Ark. ID mô hình: doubao-seedance-2-0-260128 (chuẩn) và doubao-seedance-2-0-fast-260128 (nhanh hơn, chất lượng thấp hơn).

So với phiên bản 1.5, bản 2.0 hỗ trợ:

Khung hình đầu-cuối (cung cấp cả hai ảnh)
Đầu vào đa phương thức: ảnh, video, âm thanh cùng lúc
Âm thanh gốc (đối thoại, hiệu ứng, nhạc, môi trường)
Lip sync > 8 ngôn ngữ
Điều khiển chuyển động camera bằng ngôn ngữ tự nhiên
Video tối đa 15 giây, độ phân giải đến 2K

Video xuất ra 24fps, chọn được tỷ lệ khung hình và độ phân giải trong mỗi request.

Hướng dẫn API chính thức khác gì hướng dẫn cũ?

Các bài trước như hướng dẫn tháng 2/2026 chỉ mô tả thao tác trên web. Giờ đây, với API chính thức, bạn có thể tự động hóa quy trình, gọi từ mọi ngôn ngữ, tích hợp vào hệ thống riêng – phù hợp với mọi use case của developer.

Điều kiện tiên quyết

Tạo tài khoản Volcengine: volcengine.com
Vào bảng điều khiển Ark:

   https://console.volcengine.com/ark/region:ark+cn-beijing/apikey

Tạo API Key và xuất thành biến môi trường:

   export ARK_API_KEY="your-api-key-here"

Khi gọi API, dùng header:

   Authorization: Bearer YOUR_ARK_API_KEY

Tài khoản mới có credit miễn phí (~8 video 15 giây 1080p).

Chuyển văn bản thành video: Yêu cầu đầu tiên

Base URL Seedance API:

https://ark.cn-beijing.volces.com/api/v3

Gửi POST tới: /v1/contents/generations/tasks

Ví dụ cURL

curl -X POST "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {
        "type": "text",
        "text": "A golden retriever running through a sunlit wheat field, wide tracking shot, cinematic"
      }
    ],
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 5,
    "watermark": false
  }'

Phản hồi:

{"id": "cgt-2025xxxxxxxx-xxxx"}

Ví dụ Python (SDK chính thức)

Cài SDK:

pip install volcenginesdkarkruntime

Gửi tác vụ:

import os
from volcenginesdkarkruntime import Ark

client = Ark(api_key=os.environ.get("ARK_API_KEY"))
resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "A golden retriever running through a sunlit wheat field, wide tracking shot, cinematic"
        }
    ],
    resolution="1080p",
    ratio="16:9",
    duration=5,
    watermark=False,
)
print(resp.id)

Lưu ID tác vụ để thăm dò ở bước tiếp theo.

Mô hình tác vụ không đồng bộ: Gửi, thăm dò, tải xuống

Video tạo không tức thời; ví dụ, 5 giây 1080p mất ~60-120 giây. Quy trình:

queued -> running -> succeeded
                -> failed
                -> expired
                -> cancelled

Thăm dò endpoint GET cho đến khi trạng thái không còn là queued/running.

Vòng lặp thăm dò Python hoàn chỉnh

import os
import time
import requests
from volcenginesdkarkruntime import Ark

client = Ark(api_key=os.environ.get("ARK_API_KEY"))

# Bước 1: Gửi tác vụ
resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {"type": "text", "text": "Aerial shot of a mountain lake at sunrise, slow dolly forward"}
    ],
    resolution="1080p",
    ratio="16:9",
    duration=5,
    watermark=False,
)

task_id = resp.id
print(f"Task submitted: {task_id}")

# Bước 2: Thăm dò với exponential backoff
wait = 10
while True:
    result = client.content_generation.tasks.get(task_id=task_id)
    status = result.status
    print(f"Status: {status}")

    if status == "succeeded":
        video_url = result.content.video_url
        print(f"Video URL: {video_url}")
        break
    elif status in ("failed", "expired", "cancelled"):
        print(f"Task ended with status: {status}")
        break

    time.sleep(wait)
    wait = min(wait * 2, 60)  # tối đa 60 giây

# Bước 3: Tải về ngay lập tức
if status == "succeeded":
    response = requests.get(video_url, stream=True)
    with open("output.mp4", "wb") as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)
    print("Downloaded: output.mp4")

Lưu ý: Exponential backoff giúp tránh bị giới hạn đồng thời, bảo vệ tài nguyên API.

Chuyển hình ảnh thành video (I2V): Tạo hoạt ảnh từ ảnh tĩnh

Để tạo hoạt ảnh từ ảnh tĩnh, thêm đối tượng image_url vào mảng content cùng prompt văn bản. Ảnh sẽ là khung hình đầu tiên.

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "The woman slowly turns her head and smiles at the camera"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/portrait.jpg"}
        }
    ],
    ratio="adaptive",
    duration=5,
    watermark=False,
)

ratio: "adaptive" sẽ dùng tỷ lệ gốc của ảnh, tránh crop hoặc viền đen.
Mỗi ảnh <30MB, tối đa 9 ảnh/lần.

Khung hình đầu và cuối: Kiểm soát điểm bắt đầu và kết thúc

Cung cấp 2 ảnh (đầu-cuối) và prompt văn bản:

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "The flower blooms from bud to full open, macro lens, soft light"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/flower-bud.jpg"}
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/flower-open.jpg"}
        }
    ],
    ratio="adaptive",
    duration=8,
    watermark=False,
)

2 ảnh + prompt = chế độ đầu-cuối.
Có thể dùng return_last_frame: true để lấy khung hình cuối từ 1 clip, dùng làm đầu vào cho clip tiếp theo (nối chuỗi).

Tham chiếu đa phương thức: Kết hợp ảnh, video, âm thanh

Seedance 2.0 cho phép đa dạng đầu vào cùng lúc: ảnh, video, audio, text.

{"type": "text", "text": "..."}
{"type": "image_url", "image_url": {"url": "..."}}
{"type": "video_url", "video_url": {"url": "..."}}
{"type": "audio_url", "audio_url": {"url": "..."}}

Giới hạn:

Tối đa 9 ảnh (<30MB/ảnh)
Tối đa 3 video (2-15s, <50MB/clip)
Tối đa 3 audio (mp3, <15MB/file)

Ví dụ:

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "Match the visual style of the reference clip and add the provided background audio"
        },
        {
            "type": "image_url",
            "image_url": {"url": "https://example.com/style-reference.jpg"}
        },
        {
            "type": "video_url",
            "video_url": {"url": "https://example.com/motion-reference.mp4"}
        },
        {
            "type": "audio_url",
            "audio_url": {"url": "https://example.com/background-music.mp3"}
        }
    ],
    duration=10,
    ratio="16:9",
    watermark=False,
)

Lưu ý: Có video reference thì giá giảm còn 3,90$/triệu token.

Tạo âm thanh gốc

Thêm generate_audio: true để tạo audio đồng bộ với nội dung video, bao gồm đối thoại, nhạc, hiệu ứng, tiếng môi trường.

resp = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-260128",
    content=[
        {
            "type": "text",
            "text": "A street musician plays guitar outside a cafe in Paris, crowds passing by, city sounds"
        }
    ],
    resolution="1080p",
    ratio="16:9",
    duration=10,
    generate_audio=True,
    watermark=False,
)

Việc này tăng nhẹ số token tiêu thụ, lưu ý khi tính chi phí.

Kiểm soát độ phân giải, tỷ lệ, thời lượng

resolution: "480p", "720p", "1080p", "2K" (mặc định: "1080p")
ratio: "16:9", "9:16", "4:3", "3:4", "21:9", "1:1", "adaptive"
duration: số nguyên 4-15 (giây, mặc định 5)

Mô hình fast cho chất lượng thấp hơn, hoàn thành nhanh hơn (thích hợp thử nghiệm).

Chọn Seedance 2.0 khi:

Cần audio gốc đồng bộ
Kiểm soát khung hình đầu-cuối
Đầu vào đa phương thức

Nếu chỉ cần text-to-video đơn giản, chọn model fast với 480p để tiết kiệm chi phí.

Đọc chi phí từ phản hồi

Sau khi task thành công, trường usage trả về số token:

{
  "usage": {
    "completion_tokens": 246840,
    "total_tokens": 246840
  }
}

Tham khảo:

1080p, 15 giây: ~308.880 token
1080p, 5 giây: ~102.960 token

Giá T2V/I2V 1080p: 46 NDT/triệu token (~6,40$/triệu token).

Ước tính:

5 giây: ~102.960 token ≈ 0,93$
10 giây: ~205.920 token ≈ 1,97$

V2V (có video reference): 28 NDT/triệu token (~3,90$).

Tích hợp theo dõi chi phí trong app: lấy completion_tokens * đơn giá.

Quan trọng: Tải video trong vòng 24 giờ

Trường video_url sẽ hết hạn sau 24 giờ kể từ khi task thành công. Sau đó URL trả về 403, file bị xóa.

Luôn tải về ngay sau khi trạng thái là "succeeded".

Trường execution_expires_after chỉ thời gian lưu record (thường 48h), nhưng URL video vẫn chỉ 24h.

Task history chỉ giữ 7 ngày gần nhất.

Cách kiểm thử API Seedance bằng Apidog

Workflow bất đồng bộ cần chuỗi nhiều request.

Apidog cho phép tự động hóa và xác nhận từng bước.

Thiết lập kiểm thử Apidog

Tạo Kịch bản Kiểm thử
- Vào module Tests, tạo mới "Tạo video Seedance 2.0"
- Đặt biến môi trường ARK_API_KEY trong Apidog
Thêm bước gửi POST
- POST tới https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks
- Header: Authorization: Bearer {{ARK_API_KEY}}
- Body: JSON model, content
Extract Variable
- Sau bước POST, dùng Extract Variable lấy $.id lưu vào TASK_ID
Wait
- Thêm bước Wait 30 giây
Vòng lặp thăm dò GET
- For loop tối đa 20 lần:
  - GET tới /contents/generations/tasks/{{TASK_ID}}
  - Wait 10 giây
  - Break If: $.status == "succeeded" hoặc "failed"
Assertion
- Kiểm tra: $.status == "succeeded"
- Kiểm tra: $.content.video_url không rỗng

Chạy kịch bản, Apidog sẽ log chi tiết từng bước, giúp bạn debug workflow và kiểm soát toàn bộ quy trình tạo video.

Tip: Có thể import cURL trực tiếp vào Apidog để nhanh chóng tạo các request.

Phân tích chi phí: Giá video 10 giây

Seedance API tính phí theo token sử dụng, không giới hạn user/tháng ngoài credit thử.

Loại tác vụ	Giá (triệu token)
T2V / I2V ở 1080p	46 NDT (~6,40$)
V2V (video reference)	28 NDT (~3,90$)

Ước tính chi phí phổ biến 1080p:

Thời lượng	Token ước tính	Chi phí (T2V/I2V)
5 giây	~103.000	~0,66 NDT / ~0,93$
10 giây	~206.000	~9,48 NDT / ~1,32$
15 giây	~309.000	~14,21 NDT / ~1,97$

Tài khoản mới có credit đủ thử nghiệm ~8 video 15 giây 1080p.

Độ phân giải thấp hơn giảm chi phí đáng kể, nên phát triển ở 720p, chỉ nâng lên 1080p khi cần.

Các lỗi thường gặp và cách khắc phục

429 Quá nhiều yêu cầu:

Đạt giới hạn đồng thời. Dùng exponential backoff (bắt đầu 10s, nhân đôi, tối đa 60s).

Trạng thái "failed":

Model không thể tạo video. Kiểm tra prompt, ảnh đầu vào, dung lượng file, hoặc tham số.

Trạng thái "expired":

Task chờ quá lâu không hoàn thành (thường do cao điểm). Gửi lại request mới.

Lỗi 403 trên video_url:

URL đã hết hạn (quá 24h). Phải tạo lại video (dùng seed nếu muốn kết quả giống).

Khả năng tái tạo Seed:

Lưu lại giá trị seed để truyền lại cho các request sau, giúp tái tạo video giống hệt (nếu cùng tham số).

Kết luận

Seedance 2.0 cho phép developer tạo video AI đa phương thức, audio gốc, kiểm soát khung hình đầu-cuối thông qua API bất đồng bộ đơn giản: POST → nhận ID → thăm dò GET → tải ngay.

Luôn kiểm thử workflow với Apidog trước khi triển khai thực tế để phát hiện lỗi logic, thiếu extract, hoặc hết hạn URL.

Câu hỏi thường gặp

Sự khác biệt giữa doubao-seedance-2-0-260128 và doubao-seedance-2-0-fast-260128?

Bản chuẩn cho chất lượng cao, dùng cho sản xuất. Bản fast nhanh hơn, chất lượng thấp hơn, phù hợp test hoặc lặp prompt.

Tôi có thể sử dụng Seedance 2.0 ngoài Trung Quốc không?

API đặt tại Bắc Kinh, có thể gọi từ nước ngoài nhưng latency cao hơn. Xem điều khoản Volcengine về giới hạn địa lý.

Nối nhiều clip thành video dài hơn thế nào?

Dùng return_last_frame: true để lấy ảnh cuối, dùng làm đầu vào cho task tiếp theo, sau đó ghép các clip lại.

Tạo âm thanh gốc có tốn nhiều chi phí hơn không?

Có, tăng số token tiêu thụ một chút. So sánh completion_tokens để tính toán.

Có thể dùng webhook thay vì thăm dò không?

Có. Truyền thêm callback_url khi gửi task. API sẽ POST kết quả khi xong.

Vượt quá giới hạn 9 ảnh sẽ ra sao?

API trả về lỗi 400, cần giảm số lượng ảnh <=9.

Seed có đảm bảo kết quả giống hệt không?

Seed tăng khả năng tái tạo, nhưng không đảm bảo tuyệt đối nếu tham số hoặc model server thay đổi.

Theo dõi chi phí nhiều task như thế nào?

Đọc completion_tokens từ từng phản hồi, nhân với giá token. Lưu lại vào database riêng để tracking, vì API không có dashboard chi tiêu sẵn.

Hướng dẫn đầy đủ cách sử dụng Grok Text to Video API

Sebastian Petrus — Fri, 03 Apr 2026 08:46:04 +0000

TÓM TẮT

API chuyển văn bản thành video của Grok cho phép bạn tạo video từ một lời nhắc văn bản. Quy trình gồm gọi POST /v1/videos/generations để lấy ngay request_id, sau đó lặp truy vấn GET /v1/videos/{request_id} tới khi trạng thái là "done". Sử dụng model grok-imagine-video với giá khởi điểm $0.05/giây (480p). SDK Python của xAI giúp tự động hóa quy trình truy vấn trạng thái.

Dùng thử Apidog ngay hôm nay

Giới thiệu

xAI đã tạo ra 1.2 tỷ video chỉ trong tháng đầu triển khai API chuyển văn bản thành video (28/1/2026). Model này dẫn đầu bảng xếp hạng chuyển văn bản thành video, thể hiện khả năng mở rộng và tin cậy.

Hướng dẫn này cung cấp các bước thực tế: gửi yêu cầu đầu tiên, truy vấn kết quả, tinh chỉnh tham số, tối ưu prompt, sử dụng hình ảnh tham chiếu, mở rộng/chỉnh sửa video, và xác định khi nào nên áp dụng chuyển văn bản thành video.

💡 API này là bất đồng bộ: Giao diện của bạn không thể chờ video sẵn sàng mới hiển thị kết quả. Nếu bạn xây dựng UI tạo video, nên phát triển theo luồng truy vấn mà không tốn chi phí thử nghiệm thực tế. Sử dụng Smart Mock của Apidog để mô phỏng cả endpoint tạo video lẫn truy vấn trạng thái. Bạn có thể xây dựng UI video player song song với backend. Dùng thử Apidog miễn phí để kiểm thử theo hướng dẫn.

API chuyển văn bản thành video của Grok là gì?

API này thuộc bộ công cụ tạo media của xAI tại https://api.x.ai. Bạn gửi prompt dạng text, model grok-imagine-video sẽ tạo video từ đầu (không cần ảnh gốc).

API đồng hành với endpoint tạo ảnh đồng bộ (POST /v1/images/generations, model grok-imagine-image, $0.02/ảnh). Ngoài ra còn có endpoint mở rộng và chỉnh sửa video.

Điểm khác biệt so với chuyển hình ảnh thành video: endpoint chuyển văn bản thành video chỉ cần text, toàn bộ cảnh và chuyển động được model tạo dựa trên mô tả của bạn. Nếu bạn cần hoạt họa từ ảnh gốc, xem hướng dẫn API chuyển hình ảnh thành video của Grok.

Cách hoạt động của tính năng tạo video từ văn bản

Thông thường, API đồng bộ trả về kết quả sau khi xử lý xong. Tuy nhiên, tạo video có thể mất vài giây đến vài phút, nên API này sử dụng mô hình bất đồng bộ.

Luồng thực tế:

Gửi POST với prompt.
API trả về request_id ngay (dưới 1 giây).
Máy chủ xAI xử lý tạo video.
Bạn liên tục truy vấn GET với request_id.
Khi trạng thái đổi từ "processing" sang "done", phản hồi trả về URL video.

Luồng này giúp giữ cho kết nối HTTP ngắn, chủ động kiểm tra tiến độ. UI cần xử lý trạng thái chờ, hiển thị loading indicator cho tới khi có link video.

Điều kiện tiên quyết

Trước khi code, bạn cần:

Tài khoản xAI: Đăng ký tại console.x.ai. Thêm thông tin thanh toán để kích hoạt quyền tạo video.
API Key: Truy cập mục API Keys trong console xAI để tạo key mới. Lưu key an toàn và dùng nó làm Bearer token trong header mỗi request.

Thiết lập biến môi trường:

export XAI_API_KEY="your_api_key_here"

Cài đặt SDK Python (nếu muốn):

pip install xai-sdk

Yêu cầu tạo video từ văn bản đầu tiên

Endpoint: POST https://api.x.ai/v1/videos/generations. Chỉ cần trường model và prompt.

Sử dụng curl

curl -X POST https://api.x.ai/v1/videos/generations \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "Một chú chó Golden Retriever chạy qua những chiếc lá mùa thu trong chuyển động chậm, ánh sáng điện ảnh"
  }'

Phản hồi (gần như ngay lập tức):

{
  "request_id": "d97415a1-5796-b7ec-379f-4e6819e08fdf"
}

Sử dụng Python với requests

import requests
import os

API_KEY = os.environ["XAI_API_KEY"]
BASE_URL = "https://api.x.ai"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "model": "grok-imagine-video",
    "prompt": "Một chú chó Golden Retriever chạy qua những chiếc lá mùa thu trong chuyển động chậm, ánh sáng điện ảnh"
}

response = requests.post(
    f"{BASE_URL}/v1/videos/generations",
    headers=headers,
    json=payload
)

data = response.json()
request_id = data["request_id"]
print(f"Bắt đầu tạo. Request ID: {request_id}")

Truy vấn kết quả video

Sau khi có request_id, truy vấn GET /v1/videos/{request_id} lặp lại cho tới khi status bằng "done".

Các trạng thái:

processing: đang tạo
done: hoàn thành, có URL video
failed: tạo thất bại

Vòng lặp truy vấn trạng thái bằng Python:

import requests
import time
import os

API_KEY = os.environ["XAI_API_KEY"]
BASE_URL = "https://api.x.ai"

headers = {
    "Authorization": f"Bearer {API_KEY}"
}

def poll_video(request_id: str, interval: int = 5, max_attempts: int = 60) -> dict:
    url = f"{BASE_URL}/v1/videos/{request_id}"

    for attempt in range(max_attempts):
        response = requests.get(url, headers=headers)
        data = response.json()

        status = data.get("status")
        progress = data.get("progress", 0)
        print(f"Thử lần {attempt + 1}: status={status}, progress={progress}%")

        if status == "done":
            return data
        elif status == "failed":
            raise RuntimeError(f"Tạo video thất bại: {data}")

        time.sleep(interval)

    raise TimeoutError(f"Video chưa sẵn sàng sau {max_attempts} lần thử")

def generate_video(prompt: str) -> str:
    response = requests.post(
        f"{BASE_URL}/v1/videos/generations",
        headers={**headers, "Content-Type": "application/json"},
        json={"model": "grok-imagine-video", "prompt": prompt}
    )
    request_id = response.json()["request_id"]
    print(f"Request ID: {request_id}")

    result = poll_video(request_id)
    video_url = result["video"]["url"]
    print(f"Video đã sẵn sàng: {video_url}")
    return video_url

video_url = generate_video(
    "Một đoạn thời gian trôi của đường chân trời thành phố lúc hoàng hôn chuyển sang ban đêm, góc nhìn từ trên không"
)

Phản hồi hoàn tất:

{
  "status": "done",
  "video": {
    "url": "https://vidgen.x.ai/....mp4",
    "duration": 8,
    "respect_moderation": true
  },
  "progress": 100,
  "usage": {
    "cost_in_usd_ticks": 500000000
  }
}

Sử dụng SDK Python của xAI

SDK tự động xử lý truy vấn trạng thái. Hàm client.video.generate() chờ đến khi video hoàn tất.

from xai_sdk import Client
import os

client = Client(api_key=os.environ["XAI_API_KEY"])

result = client.video.generate(
    model="grok-imagine-video",
    prompt="Một chú chó Golden Retriever chạy qua những chiếc lá mùa thu trong chuyển động chậm",
    duration=8,
    resolution="720p",
    aspect_ratio="16:9"
)

print(f"URL video: {result.video.url}")
print(f"Thời lượng: {result.video.duration}s")

SDK phù hợp khi bạn cần thực thi đơn giản. Nếu muốn kiểm soát logic retry, cập nhật progress hoặc interval truy vấn, dùng phương pháp request thuần.

Viết prompt hiệu quả để tạo video

Mô tả cảnh: Chủ thể + bối cảnh, càng cụ thể càng tốt.
Chuyển động: Chỉ ra cái gì di chuyển, hướng, tốc độ.
Phong cách máy quay: Dùng thuật ngữ điện ảnh: "cận cảnh", "theo dõi", "góc drone", "dolly zoom"...
Ánh sáng & tâm trạng: "giờ vàng", "u ám", "neon", "sáng studio"... kết hợp mood và lighting.
Tham chiếu phong cách: Nêu tên style nếu có: "điện ảnh", "anime", "hyperlapse", "stop-motion"...

Mẫu prompt tối ưu:

Một phi hành gia đơn độc trôi qua Trạm Vũ trụ Quốc tế,
dây buộc trôi phía sau họ. Máy quay theo dõi chậm rãi
bên cạnh, hiển thị Trái đất bên dưới. Điện ảnh, chất lượng IMAX,
ánh sáng mặt trời mọc ấm áp phản chiếu trên tấm che mặt.

Kiểm soát độ phân giải, thời lượng và tỷ lệ khung hình

Thời lượng: 1-15 giây (default: 6). Video dài hơn tốn nhiều chi phí.
Độ phân giải: "480p" (default, dùng test/dev), "720p" (dùng sản xuất).
Tỷ lệ khung hình: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3.

Tỷ lệ	Tốt nhất cho
16:9	Desktop, YouTube, trình chiếu
9:16	TikTok, Instagram Reels, mobile
1:1	Instagram feed, social card
4:3	Video cổ điển, trình chiếu
3:4	Nội dung di động dọc
3:2	Ảnh tiêu chuẩn
2:3	Ảnh chân dung

Ví dụ đầy đủ:

curl -X POST https://api.x.ai/v1/videos/generations \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "Một thị trấn ven biển lúc bình minh, sóng vỗ nhẹ nhàng vào bờ đá",
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Sử dụng hình ảnh tham chiếu để định hướng phong cách video

Dùng trường reference_images (tối đa 7 ảnh, dạng URL) để định hướng visual style và content mà không trở thành subject chính.

{
  "model": "grok-imagine-video",
  "prompt": "Một thị trấn ven biển lúc bình minh, sóng vỗ nhẹ nhàng vào bờ đá",
  "reference_images": [
    {"url": "https://example.com/my-style-reference.jpg"},
    {"url": "https://example.com/color-palette-reference.jpg"}
  ]
}

Chọn bộ ảnh nhất quán về thẩm mỹ, tránh mix quá nhiều style khác nhau.

Khác biệt: Hình ảnh tham chiếu chỉ ảnh hưởng style, không giống endpoint chuyển hình ảnh thành video (ảnh nguồn = frame đầu tiên).

Mở rộng và chỉnh sửa video đã tạo

xAI cung cấp hai endpoint:

Mở rộng: POST /v1/videos/extensions: Truyền request_id của video gốc + prompt mới để thêm cảnh quay, vượt giới hạn 15s.
Chỉnh sửa: POST /v1/videos/edits: Thay đổi style, cảnh, hiệu ứng bằng prompt mới.

Cả hai đều trả về request_id, bạn truy vấn như quy trình tạo video chính.

Đọc chi phí từ phản hồi API

Phản hồi chứa trường usage:

"usage": {
  "cost_in_usd_ticks": 500000000
}

Chia cho 10,000,000 để ra USD:

cost_in_usd = result["usage"]["cost_in_usd_ticks"] / 10_000_000
print(f"Chi phí: ${cost_in_usd:.4f}")
# Output: Chi phí: $0.0500

Bảng giá:

Độ phân giải	Giá/giây	Clip 10 giây
480p	$0.05	$0.50
720p	$0.07	$0.70

Theo dõi trường cost_in_usd_ticks để quản lý chi phí và xây dựng dashboard theo dõi sử dụng.

Cách kiểm tra API video Grok với Apidog

Mô hình bất đồng bộ gây khó khăn khi kiểm thử UI: bạn cần kiểm thử cả 3 trạng thái (loading, success, error) mà không tốn chi phí API thực. Smart Mock của Apidog giúp bạn mô phỏng endpoint và lược đồ phản hồi dễ dàng.

Case 1: Smart Mock cho phát triển giao diện

Mô phỏng endpoint tạo video:

Tạo POST /v1/videos/generations trong Apidog project.
Lược đồ phản hồi chỉ cần 1 trường string request_id.

{
  "request_id": "d97415a1-5796-b7ec-379f-4e6819e08fdf"
}

Mô phỏng endpoint truy vấn trạng thái:

Tạo GET /v1/videos/{request_id}.
Lược đồ gồm status, video.url, video.duration, progress, usage.cost_in_usd_ticks.
Custom mock trả về "status": "done" và URL placeholder.

{
  "status": "done",
  "video": {
    "url": "https://vidgen.x.ai/mock-video-12345.mp4",
    "duration": 8,
    "respect_moderation": true
  },
  "progress": 100,
  "usage": {
    "cost_in_usd_ticks": 400000000
  }
}

UI developer có thể test toàn bộ player, trạng thái loading, success, error mà không tốn chi phí API.

Case 2: Kịch bản kiểm thử vòng lặp truy vấn trạng thái

Bước 1: Thêm yêu cầu POST tạo video. Sau khi gửi, extract request_id bằng JSONPath $.request_id sang biến videoRequestId.
Bước 2: Thêm GET /v1/videos/{{videoRequestId}} vào vòng lặp For. Thoát khi response.body.status == "done". Thêm wait 5 giây mỗi lượt.
Bước 3: Assertion kiểm tra $.video.url không rỗng sau khi hoàn tất.

Kịch bản này giúp kiểm thử CI/CD tự động, phát hiện lỗi logic truy vấn bất đồng bộ.

Chuyển văn bản thành video vs chuyển hình ảnh thành video

Cùng dùng model grok-imagine-video nhưng mục đích khác nhau:

Chuyển văn bản thành video: Khi cần tạo nội dung gốc, không có ảnh nguồn, muốn model tự do sáng tạo.
Chuyển hình ảnh thành video: Khi có ảnh sản phẩm, artwork, muốn giữ chi tiết gốc, làm animation cho ảnh sẵn có.

Xác định loại đầu vào: nếu có ảnh, dùng POST /v1/images/generations; nếu chỉ có text, dùng POST /v1/videos/generations.

Xem thêm hướng dẫn API chuyển hình ảnh thành video của Grok.

Các lỗi thường gặp và cách khắc phục

401 Unauthorized: API key sai/hết hạn. Kiểm tra header Authorization dạng Bearer YOUR_XAI_API_KEY.
429 Too Many Requests: Quá giới hạn tốc độ (60 req/phút, 1 req/giây). Chèn delay 5 giây khi polling.
status: "failed": Prompt bị kiểm duyệt. Kiểm tra trường respect_moderation, sửa prompt cho rõ ràng/hợp lệ.
URL video 404: Link video hết hạn nhanh. Tải video về ngay sau khi nhận được URL.
Video trống/đóng băng: Prompt quá mơ hồ, thiếu mô tả chuyển động. Hãy bổ sung chi tiết chuyển động.
Thời gian truy vấn chậm: Video 720p hoặc dài mất nhiều thời gian hơn. Dùng 480p, thời lượng ngắn khi dev/test.

Kết luận

API chuyển văn bản thành video của Grok đơn giản hóa quy trình: gửi prompt, nhận request_id, truy vấn tới khi xong, lấy file MP4. Hiểu rõ mô hình bất đồng bộ là chìa khóa. Khi đã có vòng lặp truy vấn ổn định, các tham số còn lại (thời lượng, độ phân giải, tỷ lệ, ảnh tham chiếu) rất dễ điều chỉnh.

Triển khai thực tế nên theo dõi chi phí qua cost_in_usd_ticks. Sử dụng Apidog để giả lập endpoint và tạo test scenario, giúp frontend không bị chậm tiến độ chờ backend. Test Scenarios giúp đảm bảo logic truy vấn luôn chuẩn khi tích hợp.

Câu hỏi thường gặp

Tôi sử dụng tên mô hình nào để tạo video từ văn bản?

Dùng grok-imagine-video làm trường model trong POST /v1/videos/generations.

Tạo video mất bao lâu?

Tùy thời lượng/độ phân giải. Clip 480p ngắn: <30 giây; 720p dài: vài phút. Poll mỗi 5-10 giây.

Có thể tạo video dài hơn 15 giây không?

Không thể trong một request. Dùng POST /v1/videos/extensions để nối thêm.

Làm sao tải video đã tạo?

Dùng URL từ result.video.url khi truy vấn xong, tải về ngay vì link sẽ hết hạn.

Nếu prompt bị kiểm duyệt thì sao?

Job trả về status: "failed", trường respect_moderation: true. Sửa prompt và thử lại.

API video có free tier không?

xAI tính phí theo số giây video. Không có free tier riêng cho video, nhưng có thể có credit cho tài khoản mới (xem tại console.x.ai).

reference_images khác gì với ảnh nguồn?

Ảnh tham chiếu chỉ định hướng style cho chuyển văn bản thành video, không phải khung hình đầu. Ảnh nguồn dùng cho chuyển hình ảnh thành video sẽ là frame đầu tiên.

Cách kiểm thử vòng lặp truy vấn tiết kiệm nhất?

Dùng Smart Mock của Apidog để mô phỏng cả endpoint tạo video lẫn truy vấn trạng thái, định nghĩa schema và response cho "processing" và "done", giúp code truy vấn hoạt động mà không tốn chi phí API thực.

Hướng Dẫn Từng Bước Sử Dụng API Grok Chuyển Ảnh Thành Video

Sebastian Petrus — Fri, 03 Apr 2026 08:41:31 +0000

Tóm tắt

API chuyển đổi hình ảnh thành video của Grok sử dụng mô hình grok-imagine-video để chuyển hóa một ảnh tĩnh thành một đoạn video động. Bạn chỉ cần gửi (POST) URL hình ảnh, một prompt mô tả, cùng các tham số tuỳ chọn đến https://api.x.ai/v1/videos/generations. API trả về request_id ngay lập tức; tiếp theo, bạn truy vấn (poll) endpoint GET /v1/videos/{request_id} cho đến khi status chuyển thành "done". Video có thể có độ dài từ 1 đến 15 giây, chi phí bắt đầu từ 0.05 USD/giây cho đầu ra 480p.

Dùng thử Apidog ngay hôm nay

Giới thiệu

Ngày 28/01/2026, xAI công bố mô hình grok-imagine-video qua API công khai. Chỉ trong tháng đầu, mô hình đã tạo 1.2 tỷ video và dẫn đầu bảng xếp hạng chuyển đổi văn bản thành video của Artificial Analysis. Chuyển đổi hình ảnh thành video là một trong các năng lực nổi bật: bạn cung cấp ảnh và prompt, API sẽ tạo hoạt ảnh và xuất ra video MP4 sẵn sàng tải về.

Luồng bất đồng bộ (async flow) này – gửi tác vụ rồi phải poll để biết hoàn thành – chính là thách thức kiểm thử thường bị bỏ qua. Việc tích hợp chỉ thực sự hoàn thiện khi bạn xác nhận vòng lặp polling xử lý đúng các trạng thái "processing", "done", "failed" trong các điều kiện mạng thực tế.

Kịch bản kiểm thử của Apidog giúp giải quyết trực tiếp: bạn có thể tạo chuỗi tuần tự gồm gửi POST /v1/videos/generations, trích xuất request_id, lặp poll cho đến khi status == "done", rồi assert URL video có mặt.

API Grok chuyển đổi hình ảnh thành video là gì?

API này thuộc bộ sản phẩm video của xAI, sử dụng mô hình grok-imagine-video. Bạn cung cấp hình ảnh để làm khung bắt đầu cho video. API phân tích nội dung ảnh, prompt, rồi tạo chuyển động tự nhiên.

Endpoint:

  POST https://api.x.ai/v1/videos/generations

Header xác thực:

  Authorization: Bearer YOUR_XAI_API_KEY

Lấy API key tại bảng điều khiển xAI.

API cũng hỗ trợ chuyển văn bản thành video, mở rộng và chỉnh sửa video.

Quá trình chuyển đổi hình ảnh thành video hoạt động như thế nào

Tham số image chỉ định khung hình đầu tiên của video. Mô hình sẽ dự đoán chuyển động tiếp theo dựa trên prompt.

Ví dụ:

Ảnh: Hồ núi lúc bình minh
Prompt: "những gợn sóng nhẹ lan tỏa trên mặt nước khi sương mù buổi sáng trôi qua."
Khung đầu là ảnh bạn cung cấp, các khung sau thể hiện chuyển động theo prompt.

Khi nào nên dùng image-to-video:

Có sẵn ảnh sản phẩm, phong cảnh, chân dung cần thêm motion
Cần đồng nhất nhận diện hình ảnh ở khung đầu tiên
Muốn motion dựa trên bối cảnh thực

Khi nào nên dùng text-to-video:

Không có hình ảnh tham chiếu, muốn mô hình tự tạo cảnh
Ưu tiên tốc độ lặp hơn độ chính xác khung hình đầu

Điều kiện tiên quyết

Cần chuẩn bị:

Tài khoản xAI: console.x.ai
API Key: Không hardcode, lưu vào biến môi trường.
Python 3.8+ hoặc Node.js 18+.
URL ảnh công khai hoặc ảnh base64 dạng data URI.

export XAI_API_KEY="your_key_here"

Cài SDK Python nếu cần:

pip install xai-sdk

Gọi HTTP thô chỉ cần requests (Python) hoặc fetch (Node.js).

Thực hiện yêu cầu chuyển hình ảnh thành video đầu tiên

Sử dụng curl

curl -X POST https://api.x.ai/v1/videos/generations \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "Gentle waves move across the surface, morning mist rises slowly",
    "image": {
      "url": "https://upload.wikimedia.org/wikipedia/commons/thumb/1/1a/24701-nature-natural-beauty.jpg/1280px-24701-nature-natural-beauty.jpg"
    },
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Phản hồi:

{
  "request_id": "d97415a1-5796-b7ec-379f-4e6819e08fdf"
}

Video chưa sẵn sàng. Cần poll để lấy kết quả.

Sử dụng Python (yêu cầu thô)

import os
import requests

api_key = os.environ["XAI_API_KEY"]

payload = {
    "model": "grok-imagine-video",
    "prompt": "Gentle waves move across the surface, morning mist rises slowly",
    "image": {
        "url": "https://upload.wikimedia.org/wikipedia/commons/thumb/1/1a/24701-nature-natural-beauty.jpg/1280px-24701-nature-natural-beauty.jpg"
    },
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
}

headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.post(
    "https://api.x.ai/v1/videos/generations",
    json=payload,
    headers=headers
)

data = response.json()
request_id = data["request_id"]
print(f"Job started: {request_id}")

Sử dụng hình ảnh base64

Nếu ảnh cục bộ hoặc không công khai, mã hóa thành data URI:

import base64

with open("my_image.jpg", "rb") as f:
    encoded = base64.b64encode(f.read()).decode("utf-8")

payload["image"] = {
    "url": f"data:image/jpeg;base64,{encoded}"
}

Truy vấn kết quả

Tạo video diễn ra bất đồng bộ. Truy vấn endpoint:

GET https://api.x.ai/v1/videos/{request_id}

Các trạng thái:

Trạng thái	Ý nghĩa
`"processing"`	Video đang render
`"done"`	Video hoàn tất, có URL
`"failed"`	Có lỗi xảy ra

Phản hồi mẫu:

{
  "status": "done",
  "video": {
    "url": "https://vidgen.x.ai/....mp4",
    "duration": 6
  },
  "progress": 100
}

Vòng lặp truy vấn Python hoàn chỉnh

import time

def poll_video(request_id: str, api_key: str, interval: int = 5) -> dict:
    url = f"https://api.x.ai/v1/videos/{request_id}"
    headers = {"Authorization": f"Bearer {api_key}"}

    while True:
        response = requests.get(url, headers=headers)
        data = response.json()
        status = data.get("status")

        print(f"Status: {status} | Progress: {data.get('progress', 0)}%")

        if status == "done":
            return data["video"]
        elif status == "failed":
            raise RuntimeError(f"Video generation failed for {request_id}")

        time.sleep(interval)

# Sử dụng
video = poll_video(request_id, api_key)
print(f"Video URL: {video['url']}")
print(f"Duration: {video['duration']}s")

Khuyến nghị để polling interval tối thiểu 5 giây để tránh vượt giới hạn 60 requests/phút.

Sử dụng xAI Python SDK

Thư viện xai-sdk tự động hóa polling và xử lý lỗi:

from xai_sdk import Client
import os

client = Client(api_key=os.environ["XAI_API_KEY"])

video = client.video.generate(
    model="grok-imagine-video",
    prompt="Gentle waves move across the surface, morning mist rises slowly",
    image={"url": "https://example.com/landscape.jpg"},
    duration=6,
    resolution="720p",
    aspect_ratio="16:9"
)

print(f"Video URL: {video.url}")
print(f"Duration: {video.duration}s")

Sử dụng SDK để có code sạch, không cần tự viết vòng lặp truy vấn. Nếu cần kiểm soát chi tiết hơn về retry, logging hoặc interval, dùng phương pháp HTTP thô.

Kiểm soát độ phân giải, thời lượng và tỷ lệ khung hình

Thời lượng

Tham số duration: 1–15 giây (mặc định 6).

"duration": 10

Video dài hơn = chi phí cao hơn.

Độ phân giải

Giá trị	Mô tả
`"480p"`	Mặc định, rẻ và nhanh hơn
`"720p"`	Chất lượng cao, $0.07/giây (vs $0.05/giây)

"resolution": "720p"

Tỷ lệ khung hình

Giá trị	Trường hợp sử dụng
`"16:9"`	Mặc định, cảnh quay ngang
`"9:16"`	Dọc, cho mobile/story
`"1:1"`	Hình vuông, Instagram, thumbnail
`"4:3"`	Ảnh cổ điển, trình chiếu
`"3:4"`	Chân dung
`"3:2"`	Cắt ảnh tiêu chuẩn
`"2:3"`	Chân dung cao

Nếu cung cấp image, aspect_ratio sẽ mặc định khớp tỉ lệ ảnh nguồn. Đặt rõ ràng để override/crop.

Sử dụng hình ảnh tham chiếu để định hướng phong cách

Tham số reference_images KHÁC với image:

image: Khung hình đầu tiên của video, được animate.
reference_images: (tối đa 7) Định hướng style, context – KHÔNG là khung hình output.

Ví dụ kết hợp:

{
  "model": "grok-imagine-video",
  "prompt": "A product rotating slowly on a clean white surface",
  "image": {
    "url": "https://example.com/product-shot.jpg"
  },
  "reference_images": [
    {"url": "https://example.com/brand-style-reference-1.jpg"},
    {"url": "https://example.com/lighting-reference.jpg"}
  ],
  "duration": 6,
  "resolution": "720p"
}

Bạn có thể chỉ dùng reference_images (không cần image) nếu muốn text-to-video nhưng vẫn kiểm soát style.

Mở rộng và chỉnh sửa video

Mở rộng video

POST /v1/videos/extensions nhận video sẵn có và tạo thêm thời lượng (tối đa 15 giây/lần call).

curl -X POST https://api.x.ai/v1/videos/extensions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "video_id": "your_original_request_id",
    "prompt": "The mist continues to lift as sunlight breaks through",
    "duration": 5
  }'

Phản hồi cũng trả về request_id để bạn poll giống như tạo mới.

Chỉnh sửa video

POST /v1/videos/edits cho phép prompt chỉnh sửa nội dung/motion video có sẵn.

curl -X POST https://api.x.ai/v1/videos/edits \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "video_id": "your_original_request_id",
    "prompt": "Change the sky to a dramatic sunset with deep orange tones"
  }'

Cả hai action đều bất đồng bộ, cần poll để lấy kết quả.

Phân tích giá: chi phí của một video 10 giây

Thành phần	Chi phí
Hình ảnh input	$0.002/ảnh
480p	$0.05/giây
720p	$0.07/giây

Ví dụ:

10 giây, 720p: 0.002 + 10 × 0.07 = 0.702 USD
6 giây, 480p: 0.002 + 6 × 0.05 = 0.302 USD

Phí hình ảnh tính cho mỗi lần tạo, kể cả lặp lại cùng URL. Chuyển text-to-video (bỏ qua image) sẽ không tính phí input 0.002 USD.

Cách kiểm thử tích hợp API video Grok với Apidog

Async pattern đòi hỏi kiểm thử chuỗi gồm:

Tạo, lấy request_id
Poll trạng thái "processing"
Khi "done", assert URL video không rỗng

Hướng dẫn kiểm thử với Apidog:

Bước 1: Tạo Kịch bản kiểm thử mới

Vào module Tests, nhấn +, đặt tên "Luồng bất đồng bộ Grok image-to-video".

Bước 2: Thêm yêu cầu tạo

POST: https://api.x.ai/v1/videos/generations
Header: Authorization: Bearer {{xai_api_key}}
Body:

{
  "model": "grok-imagine-video",
  "prompt": "Gentle mist rises from the water as light filters through the trees",
  "image": {
    "url": "https://example.com/your-test-image.jpg"
  },
  "duration": 6,
  "resolution": "480p"
}

Bước 3: Trích xuất request_id

Extract Variable:
- Tên: video_request_id
- Nguồn: Response body
- JSONPath: $.request_id

Bước 4: Xây dựng vòng lặp truy vấn

Thêm vòng lặp For
Bên trong, gửi GET: https://api.x.ai/v1/videos/{{video_request_id}}
Header: Authorization: Bearer {{xai_api_key}}
Trích xuất video_status: JSONPath $.status
Thêm Wait 5000ms để tránh rate limit
Điều kiện Break If: {{video_status}} == "done"

Bước 5: Xác nhận URL video

Sau vòng lặp, GET cuối cùng, assert trường $.video.url Is not empty

Chạy kịch bản: Nhấn Run, Apidog sẽ tự động thực hiện POST, poll, assert. Báo cáo thể hiện trạng thái từng bước.

Tích hợp CI/CD với CLI:

apidog run --scenario grok-video-async-flow --env production

Lỗi thường gặp và cách khắc phục

401 Unauthorized: Thiếu/sai API Key. Kiểm tra header Authorization.
422 Unprocessable Entity: Body sai format; kiểm tra trường model, prompt, image.url.
Ảnh không truy cập được: Đảm bảo URL public hoặc dùng data URI.
Status "processing" mãi không đổi: Nếu quá 10 phút, thử lại bằng request mới.
429 Rate limit: 60 requests/phút, 1 request/giây. Thêm delay giữa các polling.
Tải lên base64 lỗi: Đảm bảo data URI đúng prefix, ví dụ data:image/jpeg;base64,.
Aspect_ratio không khớp: Nếu aspect_ratio lệch nhiều so với ảnh, model sẽ crop/letterbox. Khuyến nghị khớp tỷ lệ.

Kết luận

API Grok image-to-video cho phép chuyển ảnh tĩnh thành video động chỉ qua một vài bước API: POST ảnh và prompt, nhận request_id, poll cho đến khi hoàn tất, tải về MP4. Mô hình grok-imagine-video đã chứng minh khả năng với hơn 1 tỷ video trong tháng đầu ra mắt.

Async polling là nơi tích hợp dễ gặp lỗi. Kịch bản kiểm thử Apidog giúp tự động hóa extract, loop, assert – tăng độ tin cậy tích hợp trước khi đưa vào sản xuất.

Bắt đầu xây dựng tích hợp với Apidog miễn phí. Không cần thẻ tín dụng.

Câu hỏi thường gặp

Tôi sử dụng tên mô hình nào cho API Grok chuyển đổi hình ảnh thành video?

Tên model là grok-imagine-video. Truyền vào trường model trong body POST.

Khác biệt giữa image và reference_images?

image: khung hình đầu tiên của video, animate từ đây.

reference_images: định hướng style, không xuất hiện trong video, tối đa 7 ảnh.

Tạo video mất bao lâu?

6 giây 480p: 1–3 phút. 15 giây 720p: 4–8 phút. Poll mỗi 5 giây là tối ưu.

Dùng file cục bộ làm ảnh nguồn được không?

Được. Mã hóa thành data URI base64, truyền vào image.url.

Không chỉ định aspect_ratio thì sao?

Nếu có image, mặc định lấy tỷ lệ ảnh nguồn. Nếu text-to-video, mặc định 16:9.

Video 10 giây 720p giá bao nhiêu?

0.002 + 10 × 0.07 = 0.702 USD.

Rate limit là gì?

60 requests/phút, 1 request/giây (bao gồm cả POST/GET).

Có thể mở rộng video quá 15 giây không?

Có. Dùng endpoint POST /v1/videos/extensions, mỗi lần mở rộng tối đa 15 giây, poll như bình thường.

Giá API SMS Bird năm 2026 là bao nhiêu?

Sebastian Petrus — Fri, 03 Apr 2026 07:10:47 +0000

Tóm tắt

API SMS của Bird có giá khởi điểm $0.00331 cho mỗi tin nhắn SMS gửi đi tại Hoa Kỳ và $0.003 cho mỗi tin nhắn SMS đến tại Hoa Kỳ. Đây là một trong những mức giá thấp nhất trong các nhà cung cấp API SMS hiện nay. Bạn có thể dùng thử với gói miễn phí (5 SMS/ngày), hoặc chọn gói Pro ($49/tháng, 1.000 tín dụng SMS).

Dùng thử Apidog ngay hôm nay

Giới thiệu

MessageBird đổi tên thành Bird vào năm 2023, đồng thời tập trung mạnh vào giao tiếp đa kênh (SMS, WhatsApp, email, thoại) trên cùng một nền tảng, hỗ trợ AI. Giá chuyển sang mô hình trả theo mức sử dụng, giúp chi phí SMS cơ bản của Bird thấp hơn Twilio, Vonage và hầu hết các đối thủ lớn.

💡 Nếu bạn đang xây dựng tích hợp SMS, bạn cần: dữ liệu giá chính xác và công cụ kiểm thử API nhanh chóng. Apidog cho phép bạn thiết kế request API của Bird, chạy test case, kiểm tra phản hồi mà không cần code. Dùng thử Apidog miễn phí và kiểm tra tích hợp SMS Bird chỉ trong vài phút.

Bài viết này tập trung vào cách tính chi phí SMS của Bird (2025–2026), các yếu tố ảnh hưởng đến hóa đơn, và so sánh thực tế với các nhà cung cấp khác.

Tổng quan về giá SMS của Bird

Bird sử dụng cấu trúc giá gồm:

Phí gói nền tảng (đăng ký hàng tháng)
Phí theo tin nhắn (trả thêm khi vượt ngưỡng gói)

Gói	Chi phí/tháng	SMS đi kèm
Miễn phí	$0	5 SMS/ngày
Pro	$49	1.000 SMS/tháng
Enterprise	Tuỳ chỉnh	Khối lượng tuỳ chỉnh

Sau khi vượt số SMS trong gói, bạn trả phí lẻ. Ví dụ cho số US:

SMS gửi đi: $0.00331/tin
SMS đến: $0.003/tin

Bảng giá đầy đủ: bird.com/en/pricing/sms (lưu ý phí nhà mạng và tỷ giá có thể thay đổi).

Phân tích giá: SMS, MMS, WhatsApp và email

SMS

SMS gửi đi tại Hoa Kỳ: $0.00331/tin.
Giá thay đổi nhiều tuỳ quốc gia.

Quốc gia	Giá gửi đi (xấp xỉ)
Hoa Kỳ	~$0.00331
Vương quốc Anh	~€0.036
Úc	~€0.009
Đức	~€0.056
Ấn Độ	thay đổi
Brazil	~€0.047

Lưu ý: Tin nhắn US/Canada sẽ có thêm phí nhà mạng (10DLC, số miễn phí) ngoài mức phí cơ bản.

MMS

Hỗ trợ cho US/Canada.
Phí thường gấp 3–5 lần SMS.
Giá cụ thể từng quốc gia: bird.com/en/pricing/sms.

Phí xử lý của Bird (trên mỗi 1.000 tin nhắn):

Khối lượng	Phí/1.000 tin
1–1.000	$0.001
1.001–100.000	$0.005
100.001–500.000	$0.0045
500.001+	$0.004

Phí của Meta (theo loại cuộc trò chuyện, quốc gia):

US: Marketing $0.0250, Utility $0.0034, Authentication $0.0034

Bird chuyển tiếp phí Meta, không cộng thêm phí.

Email

Từ $0.001/email (khối lượng thấp).
Gói Pro: 10.000 email/tháng.

Thoại

Giá dựa trên quốc gia.
US call-out: ~$0.013–$0.015/phút.
Liên hệ sales để có giá khối lượng lớn.

Các yếu tố ảnh hưởng đến hóa đơn Bird

1. Quốc gia và định tuyến mạng

SMS US: $0.00331/tin (rẻ).
Đức: ~€0.056, Bangladesh: ~€0.208, Burundi: ~€0.269 — cao hơn US từ 10–80 lần.
Luôn kiểm tra giá từng nước trước khi gửi quốc tế.

2. Loại số điện thoại

10DLC: số US tiêu chuẩn, cần đăng ký thương hiệu/campaign (TCR).
Mã ngắn: 5–6 số, thông lượng cao, phí thuê cao ($500–$1.000/tháng).
Số miễn phí: phí thuê từ $2–$3/tháng.

Phí thuê số tính riêng ngoài phí tin nhắn.

3. Độ dài tin nhắn & mã hóa

SMS chuẩn: 160 ký tự (GSM-7).
Vượt 160 ký tự = chia phân đoạn, tính phí theo số phân đoạn.
Dùng Unicode (có dấu, emoji) chỉ còn 70 ký tự/phân đoạn.

4. Kết hợp kênh

Nếu workflow tự động chuyển sang WhatsApp khi SMS fail, bạn sẽ phát sinh thêm phí WhatsApp.
Nên mô hình hóa chi phí khi sử dụng multi-channel.

5. Khối lượng gửi

Bird không công bố giảm giá theo cấp SMS.
Gửi số lượng rất lớn nên liên hệ sales để đàm phán giá enterprise.

Các loại phí ẩn

Phí nhà mạng US (10DLC)

Đăng ký thương hiệu: $4–$44 (một lần)
Đăng ký chiến dịch: ~$10/tháng/campaign
Phụ phí nhà mạng: thêm vài xu/tin so với giá cơ bản

Tất cả phụ phí này là do nhà mạng US đặt ra, Bird thu đúng giá gốc.

Thuê số điện thoại

10DLC: $1–$2/tháng
Số miễn phí: $2–$3/tháng
Mã ngắn: $500–$1.000/tháng (dùng chung hay riêng & nhà mạng quyết định)

Webhook đến & xử lý

SMS đến bị tính phí ($0.003/tin US).
Nếu có auto-reply, từ chối, help: các tin trả lời đó cũng bị tính phí đến.

Phí nền tảng

Gói Pro: $49/tháng — cố định.
Nếu gửi ít thì quan tâm phí lẻ/tin, gửi nhiều thì 1.000 SMS trong gói chỉ là phần nhỏ.

So sánh giá Bird với các API SMS lớn

Nhà cung cấp	SMS gửi đi US	SMS đến US	Ghi chú
Bird	$0.00331	$0.003	Giá cơ bản thấp nhất, đa kênh
Twilio	$0.0079	$0.0079	Giá cao, hệ sinh thái lớn
Telnyx	~$0.004	~$0.001	Giá cạnh tranh, kết nối trực tiếp
Plivo	$0.0055	$0.0005	SMS đến rẻ, nền tảng đơn giản

Bird rẻ nhất về SMS gửi đi US.
Twilio đắt gấp đôi ở giá khởi điểm (nhưng có chiết khấu lớn).
Nếu bạn chỉ cần API SMS đơn giản, Telnyx/Plivo có thể phù hợp hơn.
Nếu cần đa kênh và workflow tự động, Bird có lợi thế về tích hợp và giá.

Cách bắt đầu với Bird

Tạo tài khoản miễn phí tại bird.com. Gói miễn phí: 5 SMS/ngày, không cần thẻ.
Đăng ký thương hiệu/campaign qua dashboard để tuân thủ 10DLC (US).
Thuê số điện thoại: có thể lấy số US 10DLC qua API Numbers hoặc dashboard.
Gửi SMS đầu tiên qua API. Bird dùng REST API với JSON.

Ví dụ request gửi SMS (cấu trúc mẫu):

POST https://rest.bird.com/messages
Content-Type: application/json
Authorization: AccessKey {API_KEY}

{
  "originator": "+11234567890",
  "recipients": [
    "+10987654321"
  ],
  "body": "Xin chào từ Bird API!"
}

Xem chi tiết tài liệu, SDK Node.js/Python/PHP/Go/Java/Ruby, webhook tại docs.bird.com.

Kết luận

API SMS của Bird có phí cơ bản thấp nhất hiện nay — $0.00331/SMS gửi đi US.
Gói miễn phí phù hợp test API, gói Pro $49/tháng cho nhóm nhỏ.
Lưu ý các loại phí không nằm trong headline price: phí 10DLC, thuê số, cước quốc tế.
Nên mô hình hóa chi phí kỹ trước khi triển khai thật.
Dùng Apidog để kiểm thử tích hợp API từ đầu đến cuối — xây dựng request, biến môi trường, test chain, xác nhận phân phối ngay trên nền tảng.

Câu hỏi thường gặp

Giá API SMS của Bird mỗi tin nhắn tại Hoa Kỳ là bao nhiêu?

$0.00331/SMS gửi đi, $0.003/SMS đến (chưa gồm phí nhà mạng 10DLC).

Bird có giống với MessageBird không?

Có, MessageBird đổi tên thành Bird từ 2023. API cũ và tài liệu vẫn có thể xuất hiện tên MessageBird.

Bird có tính phí SMS đến không?

Có, $0.003/SMS đến US. Reply từ chối/help cũng bị tính phí đến.

Gói miễn phí của Bird gồm gì?

5 SMS/ngày, 10 email/ngày, 15 agent AI/ngày. Có API public, không cần thẻ.

Giá SMS của Bird so với Twilio thế nào?

Bird: $0.00331/SMS gửi đi US. Twilio: $0.0079 — Bird rẻ hơn ~2 lần ở mức cơ bản.

Có phí ẩn nào với SMS Bird không?

Có: phí đăng ký thương hiệu/campaign (10DLC), phụ phí nhà mạng, phí thuê số, cước quốc tế đắt hơn US nhiều lần.

Kiểm thử API SMS Bird mà không gửi thật được không?

Dùng Smart Mock của Apidog để mô phỏng response API Bird trong quá trình dev. Ngoài ra, có thể gửi test đến số xác minh qua sandbox của Bird. Apidog cho phép xâu chuỗi request, validate response mà không cần dùng production.

Chi phí API SMS Twilio: Bảng giá chi tiết năm 2026

Sebastian Petrus — Fri, 03 Apr 2026 03:58:48 +0000

Tóm tắt

SMS mã dài của Hoa Kỳ (gửi đi và nhận vào): $0.0083 mỗi tin nhắn
MMS gửi đi: $0.022 mỗi tin nhắn; MMS nhận vào: $0.0165 mỗi tin nhắn
SMS tổng đài miễn phí: $0.0083 mỗi tin nhắn cộng với phụ phí nhà mạng
Thuê mã ngắn: $1.000/tháng cho mã ngẫu nhiên; $1.500/tháng cho mã tùy chỉnh
Đăng ký thương hiệu 10DLC: $4.50 phí một lần (cập nhật tháng 8 năm 2025); chiến dịch từ $1.50 đến $10/tháng
Số điện thoại (mã dài): $1.15/tháng; tổng đài miễn phí: $2.15/tháng
Phí nhà mạng áp dụng chồng lên tất cả các mức giá cơ bản
Giảm giá theo khối lượng tự động áp dụng khi đạt 150.000 tin nhắn mỗi tháng
Có bản dùng thử miễn phí; không yêu cầu thẻ tín dụng để bắt đầu

Dùng thử Apidog ngay hôm nay

Giới thiệu

Twilio là API SMS phổ biến với tài liệu đầy đủ, REST API mạnh và thời gian hoạt động ổn định. Tuy nhiên, khi chuyển từ dự án phụ sang sản phẩm thực tế, chi phí SMS tăng nhanh với nhiều loại phí khác nhau: phí tin nhắn, phí nhà mạng, phí số điện thoại, phí đăng ký 10DLC.

💡 Mẹo: Trước khi xây dựng tích hợp SMS, hãy kiểm thử tự động luồng webhook Twilio với Apidog. Apidog giúp bạn xác thực mã trạng thái, lược đồ phản hồi và kiểm thử hợp đồng (contract testing) trong CI/CD. Hãy dùng thử Apidog miễn phí để xác thực quy trình SMS của bạn trước khi triển khai thực tế.

Bài viết này phân tích chi tiết bảng giá Twilio, các loại phí tiềm ẩn và so sánh với các lựa chọn thay thế để tối ưu hóa chi phí SMS của dự án.

Tổng quan về giá SMS của Twilio

Twilio sử dụng mô hình giá trả theo mức sử dụng. Bạn trả phí cho mỗi phân đoạn tin nhắn, thuê số điện thoại hằng tháng và các tính năng hoặc đăng ký bổ sung nếu có. Không có hợp đồng bắt buộc hoặc mức chi tiêu tối thiểu (trừ khi bạn đàm phán giảm giá cho volume lớn).

SMS mã dài (US): $0.0083/phân đoạn (gửi đi & nhận vào)
Mức giá chưa bao gồm phí nhà mạng, thuê số, đăng ký tuân thủ
Giảm giá tự động khi vượt 150.000 tin nhắn/tháng/loại số

Chi tiết giá: SMS, MMS, tổng đài miễn phí và mã ngắn

SMS mã dài (số 10 chữ số)

Dùng để gửi A2P tại Mỹ.

Loại tin nhắn	Giá mỗi phân đoạn
SMS gửi đi	$0.0083
SMS nhận vào	$0.0083
MMS gửi đi	$0.022
MMS nhận vào	$0.0165

Lưu ý: Twilio tính tiền theo phân đoạn, không phải tin nhắn.

GSM-7: 160 ký tự/phân đoạn
Unicode: 70 ký tự/phân đoạn VD: 200 ký tự GSM-7 = 2 phân đoạn.

Số tổng đài miễn phí

Giá SMS: $0.0083/phân đoạn (gửi & nhận)
MMS gửi đi: $0.022; MMS nhận vào: $0.02
Không cần 10DLC nhưng cần xác minh tổng đài để đạt throughput tối đa.

Mã ngắn (short code: 5-6 số)

Dùng cho thông lượng cực lớn.

Loại mã ngắn	Chi phí hàng tháng
Mã ngắn ngẫu nhiên	$1.000/tháng (thanh toán quý)
Mã ngắn tùy chỉnh	$1.500/tháng (thanh toán quý)
Mang theo mã tùy chỉnh của bạn	$500/tháng (thanh toán quý)

Bật MMS: phí setup một lần $500.

Giảm giá theo khối lượng

Số tin nhắn/tháng	Giá mỗi phân đoạn
1 - 150.000	$0.0083
150.001 - 300.000	$0.0081
300.001 - 500.000	$0.0079
500.001 - 750.000	$0.0077
750.001 - 1.000.000	$0.0075
Trên 1.000.000	$0.0073

Mỗi loại số tính khối lượng riêng, không cộng dồn.

Các yếu tố ảnh hưởng đến hóa đơn Twilio

Loại số điện thoại

Mỗi loại số (mã dài, tổng đài miễn phí, mã ngắn) có bảng giá và bậc volume riêng. Chia đều traffic có thể làm bạn không đạt ngưỡng giảm giá.

Phân đoạn tin nhắn

Tin nhắn dài hoặc chứa Unicode sẽ tốn nhiều phân đoạn hơn.

Mẹo: Kiểm soát nội dung SMS để tối ưu chi phí.

Phí nhà mạng

Ngoài giá Twilio, mỗi nhà mạng US cộng thêm phí:

Nhà mạng	Phí gửi đi (SMS mã dài)
AT&T	$0.0035
T-Mobile	$0.0045
Verizon	$0.004
US Cellular	$0.005
Khác	$0.004

MMS: phí còn cao hơn (AT&T +$0.009, T-Mobile +$0.01).
VD: SMS gửi AT&T = $0.0083 + $0.0035 = $0.0118/phân đoạn.

Quốc gia đích

Giá quốc tế chênh lệch rất lớn:

UK: $0.04/tin nhắn
Ấn Độ: $0.0029
Brazil: $0.075

Kiểm tra chi tiết bằng file CSV giá Twilio.

Đăng ký 10DLC

Bắt buộc cho SMS A2P US trên mã dài, không đăng ký sẽ bị chặn.

Chi phí và phụ phí ẩn

Phí đăng ký 10DLC

Cập nhật tháng 8/2025:

Đăng ký thương hiệu:
- Cá nhân/Low Volume: $4.50 (một lần)
- Tiêu chuẩn: $46 (một lần)
Đăng ký chiến dịch:
- Kiểm tra: $15/lần
- Phí hàng tháng: $1.50 - $10 tuỳ loại

Loại chiến dịch	Phí hàng tháng
Cá nhân/Hộ kinh doanh	$2
Hỗn hợp khối lượng thấp	$1.50
Tiêu chuẩn	$10
Từ thiện/501(c)(3)	$3
Dịch vụ khẩn cấp	$5

Kiểm tra tiêu chuẩn: $41.50, kháng nghị: $11, thử lại xác thực Plus: $12.50/lần.

Phí số điện thoại

Mã dài: $1.15/tháng
Tổng đài miễn phí: $2.15/tháng

Dùng nhiều số sẽ tăng chi phí.

Phí xử lý tin nhắn thất bại

$0.001/tin nhắn "Failed". Nên kiểm tra log thường xuyên để tránh phát sinh phí không cần thiết.

Các tiện ích tính năng tùy chọn

Bộ Công cụ Tương tác (rút gọn link): $0.015/tin nhắn sau 1.000 tin miễn phí
Bộ Công cụ Tuân thủ (compliance): $0.015/tin nhắn

Các gói hỗ trợ

Developer Support: từ $250/tháng
Hỗ trợ miễn phí giới hạn, nên cân nhắc trả phí nếu ứng dụng phụ thuộc SMS.

So sánh Twilio với các lựa chọn thay thế

Nhà cung cấp	SMS gửi đi US	SMS nhận vào US	Số điện thoại	Yêu cầu 10DLC
Twilio	$0.0083 + phí nhà mạng	$0.0083 + phí nhà mạng	$1.15/tháng	Có
Plivo	$0.005	$0.00035	$0.80/tháng	Có
Telnyx	$0.004	$0.004	$1.00/tháng	Có
Bird (MessageBird)	~$0.007	~$0.007	Thay đổi	Có

Plivo, Telnyx có giá tốt hơn, đặc biệt là SMS nhận vào.
Twilio vượt trội về tài liệu, hỗ trợ, tích hợp hệ sinh thái.
Nếu ưu tiên chi phí và volume lớn, nên thử Telnyx/Plivo.

Hướng dẫn kiểm thử Twilio miễn phí

Twilio cung cấp tài khoản trial miễn phí, không cần thẻ tín dụng.

Các bước thực hiện:

Đăng ký trial account tại Twilio.
Nhận số điện thoại thử nghiệm.
Gửi và nhận SMS qua API để kiểm thử.
Kiểm thử webhook nhận tin nhắn.
Xem log và quản lý trên Twilio Console.

Lưu ý: Tin nhắn gửi đến số chưa xác minh sẽ bị chèn tiền tố "Sent from your Twilio trial account". Để bỏ, nâng cấp lên account trả phí.

Kiểm thử tích hợp SMS Twilio với Apidog

Sau khi đã cấu hình Twilio và webhook, nên tự động hóa kiểm thử tích hợp để đảm bảo hoạt động chính xác và phát hiện lỗi lược đồ.

Các bước thực tiễn với Apidog:

Nhập đặc tả API Twilio vào Apidog.
Tạo kịch bản kiểm thử:
- Thêm các bước: gửi SMS, nhận phản hồi gửi, xử lý webhook trả lời.
- Sắp xếp lại các bước bằng chế độ sắp xếp.
- Truyền dữ liệu giữa các bước với cú pháp {{$.stepId.response.body.field}} (dùng để xâu chuỗi SID tin nhắn).
Kiểm thử hợp đồng (Contract Testing):
- Xác thực mã trạng thái HTTP khớp tài liệu.
- Kiểm tra lược đồ body, kiểu dữ liệu, trường bắt buộc.
- Đảm bảo không có trường ngoài lược đồ nếu không cho phép.

Ví dụ kiểm thử hợp đồng:

// Định nghĩa lược đồ OpenAPI cho webhook
{
  "type": "object",
  "properties": {
    "MessageSid": { "type": "string" },
    "From": { "type": "string" },
    "To": { "type": "string" },
    "Body": { "type": "string" }
  },
  "required": ["MessageSid", "From", "To", "Body"]
}

Bắt đầu ngay:

Tải Apidog miễn phí
Nhập đặc tả API, định nghĩa lược đồ webhook, tạo kịch bản kiểm thử cho luồng gửi/nhận SMS.

Kết luận

Giá SMS Twilio (US) bắt đầu từ $0.0083/phân đoạn, nhưng chi phí thực tế bao gồm phí nhà mạng, thuê số, phí 10DLC,... Ví dụ: SMS gửi AT&T là ~$0.0118/phân đoạn. Chiến dịch 10DLC tiêu chuẩn: thêm $10/tháng/campaign.

Twilio rõ ràng, giảm giá tự động, nhưng cần dự trù mọi loại phí khi ước tính chi phí vận hành.

Sau khi xác định chi phí, hãy tự động hóa kiểm thử tích hợp với Apidog để chắc chắn luồng webhook Twilio khớp với đặc tả API mà không cần viết mã kiểm thử thủ công.

Câu hỏi thường gặp

Hỏi: Giá cơ bản cho một tin nhắn SMS gửi đi tại Hoa Kỳ trên Twilio là bao nhiêu?

Đáp: $0.0083/phân đoạn (mã dài). Phí nhà mạng cộng thêm. Gửi AT&T = $0.0118/phân đoạn.

Hỏi: Twilio có tính phí SMS nhận vào không?

Đáp: Có. $0.0083/phân đoạn (mã dài, tổng đài miễn phí). Phí nhà mạng có thể áp dụng.

Hỏi: 10DLC là gì và có phải trả tiền không?

Đáp: 10DLC là đăng ký nhắn tin A2P từ số 10 chữ số tại US, bắt buộc cho doanh nghiệp. Đăng ký thương hiệu: $4.50 (một lần), phí campaign: $1.50-$10/tháng.

Hỏi: Giá một mã ngắn Twilio là bao nhiêu?

Đáp: Mã ngắn ngẫu nhiên: $1.000/tháng; mã tùy chỉnh: $1.500/tháng (thanh toán quý). Bật MMS: phí setup $500.

Hỏi: Twilio có giảm giá theo khối lượng không?

Đáp: Có, tự động áp dụng từ 150.000 tin nhắn/tháng/loại số, xuống thấp nhất $0.0073/phân đoạn với volume lớn.

Hỏi: Twilio có bản dùng thử miễn phí không?

Đáp: Có. Đăng ký trial, nhận số test, gửi/nhận SMS thực không cần thẻ tín dụng.

Hỏi: Nhà cung cấp SMS nào rẻ hơn Twilio?

Đáp: Plivo ($0.005 gửi/US, $0.00035 nhận/US), Telnyx ($0.004 gửi/US). Cả hai đều yêu cầu đăng ký 10DLC cho A2P.

Tối ưu chi phí, tự động hóa kiểm thử, và kiểm soát luồng SMS hiệu quả – hãy tích hợp Apidog vào quy trình phát triển của bạn!

Giá API SMS Vonage là bao nhiêu? (Bảng giá 2026)

Sebastian Petrus — Fri, 03 Apr 2026 03:52:19 +0000

Tóm tắt

Giá API Vonage SMS bắt đầu từ $0.00809 cho mỗi tin nhắn đi và $0.00649 cho mỗi tin nhắn đến tại Hoa Kỳ. Không có mức tối thiểu hàng tháng, bạn chỉ trả tiền cho những gì mình gửi và nhận. Giá quốc tế thay đổi theo quốc gia, có thể vượt $1.00/tin ở một số thị trường. Khi phát triển hoặc kiểm thử tích hợp Vonage SMS, Apidog giúp bạn kiểm thử, xác thực phản hồi, phát hiện lỗi trước khi triển khai.

Dùng thử Apidog ngay hôm nay

Giới thiệu

Nếu bạn từng biết Nexmo, bạn đã biết Vonage. Vonage đã mua lại Nexmo năm 2016, tích hợp vào nền tảng API truyền thông. Đến 2022, Ericsson tiếp tục mua lại Vonage, giữ nguyên thương hiệu cho mảng API.

Vonage hiện phục vụ hơn 100.000 doanh nghiệp và 1,6 triệu nhà phát triển toàn cầu. Họ cung cấp mô hình pay-as-you-go, không hợp đồng, phủ sóng 190+ quốc gia.

💡 Lưu ý: Trước khi tích hợp, hãy chuẩn bị công cụ kiểm thử API tốt. Apidog cho phép xây dựng kịch bản kiểm thử cho Vonage SMS, xác thực phản hồi, xâu chuỗi nhiều lệnh gọi API chỉ trong một workflow. Dùng thử miễn phí, không cần thẻ tín dụng.

Tổng quan về giá Vonage SMS

Vonage áp dụng mô hình trả theo mức sử dụng cho API SMS. Không phí nền tảng, không đăng ký tháng, bạn trả tiền cho từng tin nhắn dựa trên quốc gia đích và loại số.

Bảng giá tại Hoa Kỳ:

Loại tin nhắn	Giá mỗi tin nhắn
SMS đi (US LVN)	$0.00809
SMS đến (US LVN)	$0.00649
SMS đi (số miễn phí của Hoa Kỳ)	Liên hệ bán hàng
SMS đến (số miễn phí của Hoa Kỳ)	Miễn phí

LVN = Local Virtual Number (10DLC). Giá được tính real-time dựa trên mức sử dụng, từng quốc gia, từng loại số. Bảng giá đầy đủ tải ở dashboard Vonage/Nexmo.

Phân tích giá: tin nhắn đi, tin nhắn đến, MMS và WhatsApp

SMS đi

Tin nhắn từ ứng dụng tới người dùng cuối. Giá tại Mỹ: $0.00809/tin gửi từ số ảo cục bộ (LVN).

SMS đến

Nhận SMS trên số Vonage đã thuê. Giá tại Mỹ: $0.00649/tin. Một số số miễn phí nhận SMS miễn phí, cần xác minh trên tài khoản.

Giá MMS

Vonage hỗ trợ MMS qua Messages API nhưng không công khai giá cố định. Cần liên hệ sales, do giá MMS phụ thuộc từng nhà mạng.

WhatsApp qua Vonage

Vonage hỗ trợ WhatsApp qua Messages API, gồm 2 loại phí:

Phí của WhatsApp (Meta): Phí theo danh mục cuộc trò chuyện, xem chi tiết tại trang giá WhatsApp Meta.
Phí nền tảng của Vonage: Từ $0.00015/tin, thay đổi theo danh mục và số lượng.

Facebook Messenger

Vonage hỗ trợ Messenger với giá $0.0011/tin gửi thành công qua Messages API.

RCS (Dịch vụ liên lạc đa phương tiện)

Vonage hỗ trợ RCS với giá từng nhà mạng Mỹ:

Nhà mạng	RCS Rich (văn bản)	RCS Rich Media
T-Mobile	$0.00620	$0.01250
Verizon	$0.00400	$0.00600
AT&T	$0.00450	$0.01000
US Cellular	$0.00620	$0.01350

Phí thiết lập quốc gia một lần: $600/quốc gia cho RCS.

Điều gì ảnh hưởng đến hóa đơn Vonage của bạn

Các yếu tố chính quyết định chi phí sử dụng:

Quốc gia đích

Quyết định lớn nhất. SMS về Mỹ rẻ, các thị trường khó ở Châu Phi/Đông Nam Á có thể $0.50+/tin.

Loại số

Ba loại số:

10DLC (mã dài): Số cục bộ, phù hợp P2P, A2P, giá rẻ nhất.
Số miễn phí: Thông lượng cao, tin nhắn đến thường miễn phí.
Mã ngắn: Marketing khối lượng lớn, cần đăng ký/phê duyệt.

Phí thuê số

Thuê số ảo Vonage có phí riêng. Số cục bộ Mỹ vài $/tháng, số miễn phí/mã ngắn cao hơn.

Mã hóa tin nhắn

SMS GSM-7: 160 ký tự. Unicode/emoji: 70 ký tự/tin. Tin dài sẽ bị tách thành nhiều SMS, tăng chi phí.

Phụ phí nhà mạng

Nhà mạng Mỹ áp thêm phụ phí, đặc biệt với tin nhắn A2P/10DLC. Vonage chuyển phí này cho bạn, hiển thị trên hóa đơn.

Chi phí ẩn cần lưu ý

Các cấp hỗ trợ

Gói miễn phí: diễn đàn, tài liệu cơ bản. Hỗ trợ doanh nghiệp/trả phí: $3.300/tháng cho 24/7, người quản lý tài khoản chuyên biệt.

API bổ trợ

Một số API tính phí hàng tháng:

Bổ trợ	Chi phí hàng tháng
API kiểm toán	$550/tháng
Tự động gỡ bỏ	$1.100/tháng
API báo cáo	$495/tháng (hoặc $0.00049/CDR)

Chi phí API Xác minh

Sử dụng API Xác minh trả $0.0572/lần xác minh thành công (cộng phí tin nhắn, cuộc gọi cho lần thử).

Đăng ký số (US 10DLC)

Gửi SMS A2P Mỹ bằng mã dài cần đăng ký với TCR:

Đăng ký thương hiệu: phí một lần
Đăng ký chiến dịch: phí hàng tháng/chiến dịch

Không đăng ký = tin nhắn bị chặn.

Vonage so với các lựa chọn thay thế

Đối chiếu giá SMS đi tại Mỹ:

Nhà cung cấp	SMS đi	SMS đến	Dùng thử miễn phí	Hỗ trợ
Vonage	$0.00809	$0.00649	Có (chỉ số đã xác minh)	Trả phí; $3.300/tháng 24/7
Twilio	$0.0079	$0.0075	Có ($15 credit)	Trả phí từ $250/tháng
Plivo	$0.0055	$0.0005	Có	Miễn phí cơ bản; trả phí
Telnyx	$0.004	$0.002	Có ($5 credit)	Email 24/7 miễn phí; ĐT trả phí

Lưu ý:

Telnyx rẻ nhất cho SMS Mỹ, nhưng nền tảng mới, support nhỏ.
Plivo giá tin nhắn đến cạnh tranh, uy tín.
Twilio hệ sinh thái lớn nhất, trả phí cao hơn.
Vonage ở tầm trung, mạnh về mối quan hệ nhà mạng nhờ Ericsson.

Giá không phải yếu tố duy nhất, hãy cân nhắc tỷ lệ gửi thành công, hỗ trợ tuân thủ, công cụ dev, khả năng nhận trợ giúp khi gặp sự cố.

Cách dùng thử Vonage miễn phí

Vonage cung cấp tài khoản dùng thử miễn phí.

Bạn nhận được gì

1 số ảo Vonage để gửi/nhận tin nhắn test
API credentials (API key, secret) dùng ngay
Toàn bộ tài liệu, SDK cho dev
Tín dụng thử nghiệm số lượng tin giới hạn

Những gì bị hạn chế

Chỉ gửi tin tới số đã xác minh trên tài khoản. Không gửi được tới số ngẫu nhiên cho tới khi nâng cấp trả phí.

Hướng dẫn bắt đầu

Truy cập dashboard.nexmo.com hoặc vonage.com/communications-apis
Đăng ký tài khoản miễn phí bằng email
Xác minh số điện thoại
Lấy API key/secret trên dashboard
Thực hiện lệnh gọi API đầu tiên với REST API hoặc SDK chính thức

SDK hỗ trợ: Node.js, Python, PHP, Ruby, Java, .NET, Go. Bạn cũng có thể gọi trực tiếp REST API bằng bất kỳ HTTP client nào.

Cách kiểm tra tích hợp Vonage SMS với Apidog

Sau khi có API key/secret Vonage, bạn cần kiểm thử tích hợp trước khi chạy thực tế. Apidog được xây dựng cho mục đích này.

Tính năng Kịch bản kiểm thử của Apidog cho phép xâu chuỗi nhiều request API thành luồng kiểm thử tự động - phù hợp quy trình gửi SMS, kiểm tra trạng thái, xử lý lỗi.

Thiết lập một kịch bản kiểm thử

Vào module Tests trong Apidog, tạo kịch bản mới.
Thêm bước từ:
- Nhập OpenAPI spec endpoint Vonage SMS (nếu có)
- Thêm request tùy chỉnh tới endpoint Vonage REST API
- Nhập cURL command từ tài liệu Vonage

Ví dụ kiểm thử gửi SMS cơ bản:

Tạo request POST tới https://rest.nexmo.com/sms/json
Truyền api_key, api_secret, số gửi, số nhận, nội dung tin nhắn dưới dạng form params

Xác thực phản hồi

Apidog xác thực phản hồi dựa trên schema định nghĩa. Với Vonage SMS API, phản hồi thành công trả về JSON có mảng messages, mỗi item có trường status (0 = thành công).

Khai báo xác nhận:

HTTP status = 200
messages[0].status = "0"
messages[0].message-id không rỗng

Nếu có lỗi (status khác 0), bước kiểm thử sẽ fail, Apidog highlight đỏ, trả về đầy đủ nội dung để debug.

Truyền dữ liệu giữa các yêu cầu

Apidog cho phép truyền data giữa các request qua cú pháp {{$.stepId.response.body.field}}. Ví dụ: gửi SMS lấy message-id từ response bước 1, tự động truyền qua request kiểm tra trạng thái ở bước 2.

Chạy kiểm thử trong CI/CD

Apidog tích hợp GitHub Actions, GitLab CI, Jenkins. Xuất kịch bản kiểm thử, chạy tự động trên mỗi pull request bằng Apidog CLI. Phát hiện lỗi hồi quy SMS trước khi code lên production.

Dùng thử miễn phí tại apidog.com. Không cần thẻ tín dụng.

Kết luận

API Vonage SMS trả theo mức dùng, không phí nền tảng tháng. SMS đi Mỹ giá $0.00809/tin, SMS đến $0.00649. Chi phí tăng theo quốc gia đích, loại số, mã hóa tin nhắn. Các tính năng cao cấp (API kiểm toán, gỡ PII, hỗ trợ 24/7) thêm phí hàng tháng - cần lên ngân sách trước.

Telnyx/Plivo giá thấp hơn, Twilio mạnh về hệ sinh thái. Vonage phù hợp nếu cần độ tin cậy cấp nhà mạng, phạm vi toàn cầu nhờ Ericsson.

Trước khi triển khai, hãy dùng Apidog để xây dựng kịch bản kiểm thử cho tích hợp Vonage. Kiểm tra mọi luồng tin nhắn, xác thực phản hồi, phát hiện lỗi ở giai đoạn dev thay vì production.

Câu hỏi thường gặp

Vonage có giống Nexmo không?

Có. Vonage đã mua Nexmo năm 2016. Nhiều API endpoint vẫn dùng domain nexmo.com, tài liệu vẫn trên developer.vonage.com.

Vonage có tính phí hàng tháng cho SMS không?

Không có phí nền tảng tháng cho SMS. Chỉ trả theo tin nhắn gửi/nhận, cộng phí thuê số. API bổ trợ như kiểm toán, gỡ PII tính phí hàng tháng riêng.

Một số điện thoại Vonage có giá bao nhiêu?

Số ảo cục bộ Mỹ (10DLC): vài $/tháng. Số miễn phí, mã ngắn cao hơn. Kiểm tra giá thuê số trên dashboard Vonage.

Vonage SMS hỗ trợ những quốc gia nào?

Hỗ trợ SMS tại 190+ quốc gia, giá thay đổi mạnh. Một số quốc gia có thể $0.50+/tin. Xem bảng giá toàn cầu trên dashboard.

Vonage có giảm giá theo số lượng không?

Có. Gửi số lượng lớn có thể đàm phán giá riêng. Liên hệ sales để thương lượng. Mặc định áp dụng giá pay-as-you-go.

Tôi có thể nhận SMS đến miễn phí không?

Số miễn phí Mỹ thường nhận SMS không mất phí. Số mã dài Mỹ: $0.00649/tin nhận. Xem bảng giá từng quốc gia.

Vonage so sánh với Twilio về SMS như thế nào?

Vonage gửi SMS đi Mỹ giá $0.00809, Twilio $0.0079. Twilio hệ sinh thái lớn hơn, nhiều tích hợp. Vonage mạnh về hạ tầng cấp nhà mạng nhờ Ericsson, thường cạnh tranh ở thị trường quốc tế. Sự khác biệt giá nhỏ, nên cân nhắc trải nghiệm developer, chất lượng hỗ trợ khi chọn.

Cursor 3 có ý nghĩa gì đối với nhà phát triển API?

Sebastian Petrus — Fri, 03 Apr 2026 03:47:05 +0000

TL;DR: Cursor 3 ra mắt ngày 2/4/2026, chuyển đổi trọng tâm từ giao diện IDE sang không gian làm việc ưu tiên tác nhân (agent). Đối với dev API, các thay đổi đáng chú ý gồm: thực thi tác nhân song song, đầu ra công cụ MCP có cấu trúc, và hỗ trợ chuyển giao từ đám mây sang cục bộ. Kết hợp Cursor 3 với MCP Server của Apidog, tác nhân AI sẽ đọc trực tiếp thông số kỹ thuật API, sinh mã sát schema mà không cần copy-paste.

Dùng thử Apidog ngay hôm nay

Sự thay đổi bạn có thể cảm nhận

AI code editor tiến hóa mạnh trong hai năm qua, nhưng Cursor 3 là cuộc đại tu toàn diện - không chỉ là bản cập nhật nhỏ. Trước đây, bạn làm việc kiểu IDE truyền thống: mở file, nhờ tác nhân hỗ trợ, xem diff, tiếp tục code. Tác nhân chỉ là phụ tá theo yêu cầu.

Cursor 3 đảo ngược hoàn toàn: tác nhân chính là đơn vị công việc. Bạn tạo nhiều tác nhân như mở tab trình duyệt, chạy song song, kiểm tra output và chọn kết quả tốt nhất.

Cho dev API, đây là thay đổi lớn. Việc phát triển API luôn cần phối hợp nhiều tác vụ: viết endpoint, kiểm thử hợp đồng, cập nhật tài liệu, xử lý lỗi schema... Tất cả diễn ra song song. Giờ đây, công cụ của bạn đã phù hợp thực tế làm việc đó.

💡

Cursor 3 không tự biết thông số kỹ thuật API của bạn. MCP Server của Apidog giúp tác nhân Cursor kéo schema OpenAPI, endpoint, kịch bản kiểm thử trực tiếp từ Apidog. Tác nhân ngừng "bịa" tên trường, mã sinh ra bám sát spec ngay lần đầu.

Bài viết này đi sâu vào các thay đổi của Cursor 3, tác động thực tế với dev API, và hướng dẫn quy trình kết nối Cursor 3 với MCP Server từ Apidog.

Có gì mới trong Cursor 3

Cursor 3 ra mắt chính thức ngày 2/4/2026. Nổi bật nhất là giao diện Agents Window, cùng nhiều tính năng mới hữu ích cho dev API.

Agents Window

Bạn có thể chạy nhiều tác nhân song song trên nhiều repo (cục bộ, git worktree, cloud của Cursor, SSH remote). Truy cập: Cmd+Shift+P → Agents Window. Có thể mở song song với IDE truyền thống.

Ví dụ thực tế: Tác nhân A scaffold endpoint mới, tác nhân B sửa lỗi thư viện dùng chung. Theo dõi cả hai, can thiệp khi cần, duyệt diff khi hoàn thành.

Chế độ thiết kế (Design Mode)

Trong Agents Window, Design Mode cho phép annotate UI trực tiếp trên trình duyệt: chọn phần tử, highlight vùng, thêm vào ngữ cảnh tác nhân mà không cần mô tả thủ công. Rất hữu ích khi kiểm thử giao diện web dựa trên API.

Bật/tắt: Cmd+Shift+D
Chọn vùng: Shift+drag
Thêm phần tử: Cmd+L

Ứng dụng MCP: đầu ra nội dung có cấu trúc

Các ứng dụng MCP trong Cursor 3 giờ hỗ trợ đầu ra có cấu trúc. Trước đây, chỉ trả về text thuần, giờ là dữ liệu JSON, object... Dev API sẽ nhận phản hồi schema, endpoint, kết quả kiểm thử đúng định dạng - tác nhân Cursor phân tích dễ dàng hơn.

Đặc biệt, MCP Server của Apidog trả về dữ liệu đúng kiểu giúp tác nhân đọc API spec chính xác, thay vì phải tự diễn giải text lộn xộn.

Worktrees, best-of-n và sự cô lập

Cursor 3 có hai lệnh mới:

/worktree: tạo git worktree tách biệt, thử nghiệm mà không ảnh hưởng thư mục chính.
/best-of-n: chạy cùng tác vụ trên nhiều mô hình AI (Claude, GPT-4o, Gemini...) song song, mỗi mô hình trên một worktree riêng, sau đó so sánh output và chọn giải pháp tốt nhất.

Dev API có thể đánh giá nhiều giải pháp triển khai endpoint phức tạp từ các mô hình khác nhau.

Chuyển giao từ đám mây sang cục bộ

Tác nhân di chuyển linh hoạt giữa môi trường cloud Cursor và máy local: bắt đầu task dài trên cloud, kéo về local để kiểm thử, hoặc đẩy session lên cloud để task tiếp tục chạy khi shutdown laptop.

Ý nghĩa với phát triển API

Dev API thường phải chuyển đổi giữa nhiều tool: spec, Apidog, code editor, terminal, tài liệu... Mỗi tool chỉ biết một phần dự án. Cursor 3 giải quyết bằng cách làm tác nhân bền bỉ, song song, đặc biệt khi kết hợp lớp MCP.

Phát triển endpoint song song

Làm REST API với nhiều endpoint? Không cần code tuần tự từng cái một. Mô tả mục tiêu cho từng endpoint, tạo nhiều tác nhân riêng biệt, cho chạy song song, review output, merge những cái đạt yêu cầu. Rút ngắn thời gian từ "cần endpoint" đến "có code nháp để review".

Sinh code nhận biết schema

Tác nhân không có access OpenAPI spec sẽ đoán tên trường, kiểu dữ liệu... Dễ sai! Khi kết nối Apidog với Cursor qua MCP, tác nhân kéo đúng schema. Ví dụ: POST /orders cần customerId (string), items (array có productId, quantity). Mã sinh ra chuẩn, không phải sửa nhiều.

Kiểm thử hợp đồng ngay trong editor

Tác nhân Cursor 3 chạy lệnh terminal. Kết hợp Apidog CLI, bạn có thể tự động hóa kiểm thử hợp đồng ngay trong vòng lặp chỉnh sửa:

Bạn mô tả endpoint bằng ngôn ngữ tự nhiên → tác nhân tạo code → chạy apidog run --scenario <test-id> kiểm thử trên local mock server → nếu fail, tác nhân tự fix code theo output kiểm thử.

Gần nhất với "AI pair programmer vừa code vừa test" mà dev API từng có.

Tài liệu luôn đồng bộ

Endpoint đổi nhưng tài liệu không kịp cập nhật? Tác nhân Cursor 3 đọc doc Apidog qua MCP, so sánh với code, tự động gắn cờ chỗ không nhất quán để bạn review và sửa ngay trong vòng lặp phát triển.

Điều chưa thay đổi

Cursor 3 không thay thế hệ thống QA/API testing chuyên sâu. Nó không tự kiểm thử xác thực, throttling, performance... Bạn vẫn cần tool chuyên dụng cho phần này. Đầu ra MCP có cấu trúc chỉ hoạt động với server hỗ trợ; MCP Server của Apidog đã hỗ trợ đầy đủ.

Cursor 3 + Apidog MCP Server: Quy trình làm việc thực tế

Dưới đây là quy trình thực tế ứng dụng tính năng mới Cursor 3 cùng MCP Server của Apidog. Tập trung vào tích hợp tool chứ không chỉ "dùng AI viết code" chung chung.

Thiết lập

Kết nối Apidog MCP Server với Cursor để expose endpoint, schema, environment, test scenario thành các công cụ mà tác nhân gọi được. Thêm vào file cấu hình MCP của Cursor:

{
  "mcpServers": {
    "apidog": {
      "command": "npx",
      "args": ["-y", "@apidog/mcp-server@latest"],
      "env": {
        "APIDOG_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

Lấy mã token từ Apidog (Account Settings → API Access Token). Sau khi kết nối, tác nhân Cursor có thể gọi các lệnh như get_endpoint_detail, list_endpoints, get_schema... trực tiếp trên dự án.

Quy trình: Tạo endpoint mới từ thông số kỹ thuật

Ví dụ: Đã thêm endpoint mới POST /invoices vào Apidog, định nghĩa body, response schema, gắn test scenario. Để triển khai:

Mở phiên tác nhân mới ở Agents Window, mô tả: "Tìm endpoint POST /invoices trong dự án Apidog. Đọc schema request/response. Tạo handler Node.js/Express chuẩn spec. Chạy test scenario xác minh."
Tác nhân gọi get_endpoint_detail (qua MCP) lấy spec.
Sinh code handler từ schema thật.
Chạy apidog run --scenario invoice-creation-test --env staging kiểm thử.
Nếu fail, tác nhân tự sửa code theo output.

Bạn review diff cuối cùng, code luôn bám sát spec vì tác nhân đọc trực tiếp spec chứ không dựa mô tả thủ công.

Tận dụng /best-of-n cho endpoint phức tạp

Đối với endpoint nhiều logic, dùng /best-of-n để cho 3 mô hình AI sinh giải pháp độc lập, mỗi giải pháp dùng chung Apidog schema qua MCP, so sánh các worktree, chọn giải pháp tối ưu về logic/xử lý lỗi/clean code.

Đầu ra MCP có cấu trúc đảm bảo mọi tác nhân đều dùng chung data schema, khác biệt đến từ AI, không phải do hiểu sai spec.

Giữ tài liệu đồng bộ

Sau khi code xong endpoint, cho tác nhân thứ hai chạy tác vụ:

"Kiểm tra tài liệu Apidog cho POST /invoices. So sánh với mã trong invoices.js. Gắn cờ sự khác biệt. Nếu response trong code khác spec, cập nhật spec Apidog cho khớp."

Tác nhân đọc cả hai nguồn, so sánh, đề xuất update doc hoặc code. Bạn duyệt. Quản lý trôi dạt tài liệu trở thành bước chủ động trong review, không còn là hậu kiểm.

Bạn có thể tìm hiểu thêm về Tổng quan Apidog MCP Server và bắt đầu với Apidog CLI.

Thiết lập thực tế: Bắt đầu sử dụng

Các bước triển khai Cursor 3 cùng Apidog MCP Server:

Bước 1: Nâng cấp Cursor

Tải bản mới nhất từ cursor.com. Sau khi cài, mở Cmd+Shift+P, chọn "Agents Window" xác nhận đang dùng Cursor 3.

Bước 2: Tạo mã token truy cập Apidog

Đăng nhập Apidog, vào Account Settings → API Access Token, tạo token mới (read access). Sao chép token cho bước tiếp theo.

Bước 3: Thêm MCP Server của Apidog vào Cursor

Vào Cursor Settings → MCP, thêm cấu hình server:

{
  "mcpServers": {
    "apidog": {
      "command": "npx",
      "args": ["-y", "@apidog/mcp-server@latest"],
      "env": {
        "APIDOG_ACCESS_TOKEN": "your_token_here",
        "APIDOG_PROJECT_ID": "your_project_id"
      }
    }
  }
}

ID project lấy từ URL trên Apidog khi mở dự án. Lưu, khởi động lại Cursor.

Bước 4: Xác minh kết nối

Mở Agents Window, tạo phiên mới, gõ: "Liệt kê các endpoint trong dự án Apidog của tôi." Nếu tác nhân trả về danh sách endpoint, kết nối đã thành công.

Bước 5: Cài đặt & cấu hình Apidog CLI

Cài Apidog CLI để chạy kiểm thử tự động:

npm install -g apidog-cli

Kiểm tra apidog -v. Trong Apidog, mở test scenario → tab CI/CD, copy lệnh CLI chứa thông tin project & scenario. Chạy lệnh này trực tiếp từ terminal Cursor, hoặc để tác nhân thực thi lệnh trong workflow.

Bước 6: Chạy tác vụ MCP đầu tiên

Trong Agents Window, mô tả tác vụ yêu cầu hiểu spec, ví dụ: "Tìm schema cho đối tượng User trong Apidog. Tạo interface TypeScript đúng chuẩn." So sánh output với schema thực tế. Nếu đúng, tích hợp đã thành công.

Bạn có thể xây dựng quy trình phức tạp hơn: đọc spec → sinh code → kiểm thử tự động, chỉ với một phiên tác nhân.

Tóm lại

Cursor 3 thay đổi cách làm việc với AI trong phát triển phần mềm, đặc biệt với dev API. Chuyển trọng tâm từ code editor sang agent phù hợp với xu hướng phối hợp đa endpoint, đa dịch vụ, đa môi trường.

Đầu ra MCP có cấu trúc là cải tiến cực kỳ hữu ích cho API dev: tác nhân nhận dữ liệu đúng kiểu từ tool API, code sinh ra chuẩn hơn, ít phải sửa.

Kết hợp Cursor 3 với MCP Server & CLI của Apidog, bạn có workflow mà AI agent thực sự hiểu API của bạn: đọc spec, sinh code, chạy test xác thực - áp dụng thực tế hàng ngày, không chỉ là demo.

Các câu hỏi thường gặp

Cursor 3 có thay thế giao diện IDE hiện tại không?

Không. Agents Window là giao diện bổ sung. Có thể dùng song song hoặc chuyển đổi tự do giữa IDE truyền thống và Agents Window.

Cursor 3 khác gì so với phiên bản trước?

Cấu trúc kiến trúc chuyển từ editor-centric (tác nhân là phụ trợ) sang agent-centric (editor chỉ là công cụ review file). Agents Window bổ sung thực thi song song, chuyển giao cloud-local, Design Mode, lệnh /worktree và /best-of-n.

Kết nối MCP Server của Apidog với Cursor 3 như thế nào?

Thêm MCP Server Apidog vào Cursor Settings. Apidog expose dữ liệu API thành công cụ mà tác nhân Cursor gọi được (endpoint, schema, test scenario...). Cursor 3 hỗ trợ đầu ra có cấu trúc nên tác nhân nhận dữ liệu đúng kiểu, không phải text thuần.

Các tác nhân Cursor 3 có tự động chạy test scenario của Apidog không?

Có, qua Apidog CLI. Tác nhân thực thi lệnh terminal trong workflow. Cấu hình CLI và lệnh test phù hợp, tác nhân sẽ chạy test, đọc output, tự sửa code nếu test fail. Tạo vòng lặp feedback chặt chẽ giữa code-gen và test hợp đồng API.

Agents Window có miễn phí không?

Agents Window có trên tất cả gói Cursor 3. Tuy nhiên, thực thi agent trên cloud (chạy tác nhân khi offline) cần gói trả phí. Thực thi local miễn phí. Xem chi tiết tại cursor.com/pricing.

Cách Chạy Gemma 4 Làm API Backend

Sebastian Petrus — Fri, 03 Apr 2026 02:39:05 +0000

TL;DR: Google đã phát hành Gemma 4 vào tháng 4 năm 2026, một dòng gồm bốn mô hình mã nguồn mở được cấp phép theo Apache 2.0, vượt trội hơn các mô hình lớn gấp 20 lần về kích thước trên các điểm chuẩn tiêu chuẩn. Bạn có thể gọi API Gemma 4 thông qua Google AI Studio, Vertex AI, hoặc chạy cục bộ với Ollama và vLLM. Kết hợp nó với Smart Mock của Apidog để tự động tạo phản hồi API thực tế từ các schema OpenAPI của bạn mà không cần viết bất kỳ quy tắc giả lập nào.

Dùng thử Apidog ngay hôm nay

Giới thiệu

Hầu hết các mô hình AI mã nguồn mở buộc bạn phải lựa chọn: khả năng thô hay khả năng triển khai. Bạn có thể có một mô hình quá lớn để chạy trên máy tính xách tay của mình, hoặc một mô hình nhỏ không thể xử lý suy luận nhiều bước. Gemma 4 đã phá vỡ sự đánh đổi đó.

Gemma 4 là dòng mô hình mã nguồn mở có khả năng nhất của Google DeepMind cho đến nay. Mô hình 31B Dense xếp hạng #3 trong số tất cả các mô hình mã nguồn mở trên bảng xếp hạng của Arena AI, đánh bại các đối thủ lớn gấp 20 lần. Mô hình 26B Mixture of Experts (MoE) giữ vị trí #6. Cả hai đều chạy trên một GPU 80GB duy nhất. Các mô hình E2B và E4B nhẹ có thể chạy hoàn toàn ngoại tuyến trên điện thoại và thiết bị biên.

Đối với các nhà phát triển API, điều này cực kỳ quan trọng. Gemma 4 hỗ trợ gọi hàm, đầu ra JSON có cấu trúc và cửa sổ ngữ cảnh 256K. Điều này làm cho nó trở thành một lựa chọn thực tế để xây dựng các công cụ API hỗ trợ AI, từ tạo dữ liệu kiểm thử đến viết mock và phân tích phản hồi API.

💡 Nếu bạn đang xây dựng với Gemma 4 và cần xác thực các phản hồi được tạo bởi AI đó dựa trên đặc tả OpenAPI của mình, công cụ Smart Mock của Apidog có thể tự động tạo các phản hồi giả lập phù hợp với schema từ định nghĩa API của bạn. Bạn không cần phải viết từng quy tắc mock; Smart Mock đọc schema của bạn và tạo dữ liệu phù hợp với ngữ cảnh ngay lập tức. Tải Apidog miễn phí và kết nối nó với quy trình làm việc API Gemma 4 của bạn.

Gemma 4 là gì và có gì mới

Gemma 4 là thế hệ thứ tư của các mô hình ngôn ngữ mở của Google DeepMind. Tên "Gemma" xuất phát từ tiếng Latin có nghĩa là đá quý. Dòng sản phẩm này bắt đầu vào đầu năm 2024 và kể từ khi ra mắt, các nhà phát triển đã tải xuống các mô hình Gemma hơn 400 triệu lần. Cộng đồng đã xây dựng hơn 100.000 biến thể, tạo thành cái mà Google gọi là "Gemmaverse."

Gemma 4 ra mắt dưới giấy phép Apache 2.0, một sự thay đổi đáng kể so với các thế hệ trước sử dụng chính sách sử dụng tùy chỉnh. Điều này cho phép sử dụng, sửa đổi và phân phối Gemma 4 cho mục đích thương mại mà không bị hạn chế.

Điểm nổi bật trong Gemma 4 là "trí thông minh trên mỗi tham số." Mô hình 31B Dense mang lại khả năng tiên tiến với chi phí tính toán thấp hơn nhiều so với các mô hình như GPT-4 hoặc Claude 3 Sonnet. Theo bảng xếp hạng văn bản Arena AI (tháng 4/2026), Gemma 4 31B vượt trội hơn các mô hình với hơn 600B tham số.

Những điểm mới so với Gemma 3:

Đầu vào đa phương thức tự nhiên: Cả bốn mô hình Gemma 4 đều xử lý hình ảnh, video và (ở E2B/E4B) cả âm thanh.
Cửa sổ ngữ cảnh dài hơn: E2B/E4B hỗ trợ 128K token, 26B/31B lên tới 256K token.
Hỗ trợ quy trình tác nhân: Gọi hàm tự nhiên, đầu ra JSON có cấu trúc, hướng dẫn hệ thống.
Suy luận nâng cao: 31B cải thiện rõ rệt các tác vụ toán học, tuân thủ lệnh nhiều bước.
Hỗ trợ 140+ ngôn ngữ: Gemma 4 được huấn luyện tự nhiên đa ngữ, không chỉ chỉnh sửa từ tiếng Anh.
Giấy phép Apache 2.0: Loại bỏ rào cản pháp lý cho mục đích thương mại.

Các biến thể và khả năng của mô hình Gemma 4

Gemma 4 có bốn kích thước, tối ưu cho từng cấp phần cứng:

Mô hình	Tham số	Tham số hoạt động (suy luận)	Ngữ cảnh	Tốt nhất cho
E2B	2B hiệu quả	~2B	128K	Di động, IoT, thiết bị biên
E4B	4B hiệu quả	~4B	128K	Điện thoại, Raspberry Pi, Jetson
26B MoE	Tổng 26B	~3.8B	256K	Tác vụ máy chủ, độ trễ thấp
31B Dense	31B	31B	256K	Chất lượng cao, tinh chỉnh, nghiên cứu

E2B/E4B dùng kiến trúc MoE, chỉ kích hoạt một phần nhỏ tham số, tiết kiệm pin và RAM, chạy hoàn toàn offline trên Android (AICore).
26B MoE kích hoạt 3.8B tham số trong quá trình suy luận, lý tưởng cho server latency-sensitive.
31B Dense cho chất lượng đầu ra tốt nhất, phù hợp tinh chỉnh hoặc các trường hợp yêu cầu chất lượng cao.
Cả bốn đều có bản "hướng dẫn" (IT) và "cơ sở" (base), đều hỗ trợ gọi hàm và JSON output.

Thiết lập API Gemma 4: từng bước một

Bạn có ba lựa chọn chính để gọi Gemma 4: Google AI Studio, Vertex AI, hoặc triển khai cục bộ với Ollama/vLLM.

Tùy chọn 1: Google AI Studio (khuyên dùng cho tạo mẫu nhanh)

Đăng ký tài khoản miễn phí tại Google AI Studio.
Tạo khóa API.
Cài đặt SDK:
```
pip install google-genai
```

Thực hiện gọi API đầu tiên:

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY")

model = genai.GenerativeModel("gemma-4-31b-it")

response = model.generate_content(
    "Generate a JSON object for a user account with id, email, and created_at fields."
)

print(response.text)

Để xuất JSON có cấu trúc, sử dụng tham số response_mime_type:

import google.generativeai as genai
import json

genai.configure(api_key="YOUR_API_KEY")

model = genai.GenerativeModel(
    "gemma-4-31b-it",
    generation_config={"response_mime_type": "application/json"}
)

prompt = """
Generate 3 sample user objects for an e-commerce API. 
Each user should have: id (integer), email (string), username (string), 
created_at (ISO 8601 timestamp), and subscription_tier (free|pro|enterprise).
Return as a JSON array.
"""

response = model.generate_content(prompt)
users = json.loads(response.text)
print(json.dumps(users, indent=2))

Tùy chọn 2: Triển khai cục bộ với Ollama

Cài đặt Ollama từ ollama.com.
Tải mô hình:
```
ollama pull gemma4
```
Chạy máy chủ mô hình:
```
ollama serve
```

Gọi API tương thích OpenAI:

import requests
import json

response = requests.post(
    "http://localhost:11434/api/chat",
    json={
        "model": "gemma4",
        "messages": [
            {
                "role": "user",
                "content": "Generate a valid JSON response for a REST API /products endpoint. Include id, name, price, and stock fields."
            }
        ],
        "stream": False
    }
)

result = response.json()
print(result["message"]["content"])

Tùy chọn 3: Gọi hàm để điều phối API

Gemma 4 hỗ trợ gọi hàm tự nhiên, cho phép bạn định nghĩa các công cụ mà mô hình có thể gọi trực tiếp:

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY")

tools = [
    {
        "function_declarations": [
            {
                "name": "get_api_schema",
                "description": "Retrieve the OpenAPI schema for a given endpoint path",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "endpoint_path": {
                            "type": "string",
                            "description": "The API endpoint path, e.g. /users/{id}"
                        },
                        "method": {
                            "type": "string",
                            "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"]
                        }
                    },
                    "required": ["endpoint_path", "method"]
                }
            }
        ]
    }
]

model = genai.GenerativeModel("gemma-4-31b-it", tools=tools)

response = model.generate_content(
    "I need to test the GET /users/{id} endpoint. What schema should the response follow?"
)

if response.candidates[0].content.parts[0].function_call:
    fc = response.candidates[0].content.parts[0].function_call
    print(f"Model called function: {fc.name}")
    print(f"With args: {dict(fc.args)}")

Xây dựng mock API hỗ trợ AI với Gemma 4

Bạn có thể tận dụng Gemma 4 để tạo dữ liệu mock thực tế cho API chỉ từ schema OpenAPI. Ví dụ:

import google.generativeai as genai
import json

genai.configure(api_key="YOUR_API_KEY")

model = genai.GenerativeModel(
    "gemma-4-31b-it",
    generation_config={"response_mime_type": "application/json"}
)

schema = {
    "type": "object",
    "properties": {
        "id": {"type": "integer"},
        "order_number": {"type": "string", "pattern": "^ORD-[0-9]{6}$"},
        "status": {"type": "string", "enum": ["pending", "shipped", "delivered", "cancelled"]},
        "total": {"type": "number", "minimum": 0},
        "items": {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "product_id": {"type": "integer"},
                    "quantity": {"type": "integer", "minimum": 1},
                    "unit_price": {"type": "number"}
                }
            }
        },
        "created_at": {"type": "string", "format": "date-time"}
    }
}

prompt = f"""
Generate 5 realistic mock responses for an order management API.
Each response must conform exactly to this JSON Schema:
{json.dumps(schema, indent=2)}

Make the data realistic: use realistic prices, product IDs, and varied statuses.
Return as a JSON array of 5 order objects.
"""

response = model.generate_content(prompt)
mock_orders = json.loads(response.text)
print(json.dumps(mock_orders, indent=2))

Gemma 4 hiểu và tuân thủ các ràng buộc của JSON Schema: enum, pattern, min/max, v.v. Bạn chỉ cần cung cấp schema, mô hình sẽ sinh dữ liệu kiểm thử hợp lệ cho mọi endpoint.

Để tạo mock nâng cao hơn, bạn có thể kết hợp logic phản hồi có điều kiện (ví dụ: trả về lỗi nếu user_id nhất định), hoặc dán toàn bộ đặc tả OpenAPI vào prompt và yêu cầu Gemma 4 tạo dữ liệu kiểm thử hàng loạt.

Một quy trình thực tế: xuất bộ sưu tập Apidog của bạn dưới dạng OpenAPI, dán vào prompt, và yêu cầu Gemma 4 sinh 10 trường hợp kiểm thử cho mỗi endpoint.

Kiểm thử phản hồi API Gemma 4 với Apidog

Khi bạn đã có Gemma 4 sinh dữ liệu hoặc đóng vai trò trong pipeline API, hãy xác thực phản hồi bằng kịch bản kiểm thử của Apidog.

Quy trình làm việc:

Bước 1: Nhập endpoint API Gemma 4 vào Apidog. Tạo endpoint mới, định nghĩa schema phản hồi mong đợi.

Bước 2: Sử dụng Smart Mock để tạo phản hồi mẫu nhanh từ schema. Smart Mock tự động sinh dữ liệu thực tế dựa trên tên trường và kiểu dữ liệu, ví dụ email sẽ là email hợp lệ, created_at sẽ là timestamp đúng chuẩn.

Smart Mock ưu tiên: giá trị tùy chỉnh > khớp tên thuộc tính > mặc định JSON Schema.

Bước 3: Tạo Kịch bản Kiểm thử cho pipeline của bạn:

Gọi endpoint xác thực lấy token
Gửi prompt đến Gemma 4 kèm token
Trích xuất JSON từ phản hồi
Xác thực JSON với schema
Gửi dữ liệu đã xác thực tới endpoint POST tiếp theo

Bước 4: Thiết lập xác nhận: kiểm tra mã trạng thái, headers, các trường JSON. Dùng bộ xử lý Trích xuất Biến của Apidog để lấy output của Gemma 4 vào biến và sử dụng trong các bước tiếp theo.

Bước 5: Kiểm thử dựa trên dữ liệu: nhập file CSV/JSON chứa nhiều biến thể prompt, chạy hàng loạt kiểm thử chỉ với một cú nhấp.

Toàn bộ quy trình từ định nghĩa schema đến thực thi kiểm thử có thể thiết lập trong 15 phút và tự động hoá qua Apidog CLI trong pipeline CI/CD.

Các trường hợp sử dụng thực tế

Tạo dữ liệu kiểm thử API: Sinh hàng trăm bản ghi kiểm thử thực tế từ schema chỉ trong vài phút.
Mock API thông minh: Trả về phản hồi động, phù hợp ngữ cảnh và truy vấn.
Tạo tài liệu API: Đưa toàn bộ codebase vào prompt, nhờ Gemma 4 viết đặc tả OpenAPI tự động.
Xác thực schema phản hồi: Dùng Gemma 4 để phân tích phản hồi API, phát hiện vi phạm schema, trường thiếu, kiểu dữ liệu sai, enum không nhất quán.
Viết kiểm thử hồi quy tự động: Đưa đặc tả API và danh sách bug, yêu cầu Gemma 4 sinh case test để bao phủ các lỗi đó.

Gemma 4 so với các mô hình mở khác để sử dụng API

Mô hình	Tham số	Ngữ cảnh	Đầu ra JSON	Gọi hàm	Giấy phép
Gemma 4 31B	31B	256K	Tự nhiên	Tự nhiên	Apache 2.0
Gemma 4 26B MoE	26B (3.8B active)	256K	Tự nhiên	Tự nhiên	Apache 2.0
Llama 3.3 70B	70B	128K	Qua prompt	Qua prompt	Llama Community
Mistral 7B	7B	32K	Qua prompt	Hạn chế	Apache 2.0
Qwen 2.5 72B	72B	128K	Tự nhiên	Tự nhiên	Apache 2.0

Gemma 4 31B/26B nổi bật nhờ hỗ trợ JSON output và gọi hàm tự nhiên, cửa sổ ngữ cảnh lớn, giấy phép rõ ràng.
Llama 3.3 70B mạnh nhưng đòi hỏi tài nguyên gấp đôi Gemma 4 31B và giấy phép hạn chế thương mại.
Mistral 7B nhẹ, rẻ nhưng cửa sổ ngữ cảnh nhỏ và không hỗ trợ JSON, gọi hàm tốt.
Qwen 2.5 72B đa ngữ, mạnh, nhưng yêu cầu phần cứng rất lớn.

Khuyến nghị: dùng Gemma 4 26B MoE cho latency-sensitive, Gemma 4 31B cho chất lượng cao.

Kết luận

Gemma 4 là lựa chọn mở mạnh mẽ cho các nhà phát triển API, thay thế xứng đáng cho các API AI độc quyền. Giấy phép Apache 2.0 rõ ràng, hỗ trợ gọi hàm tự nhiên và JSON output, phù hợp tích hợp trực tiếp vào quy trình phát triển API. Bốn kích thước mô hình đáp ứng mọi cấp phần cứng. 26B MoE là lựa chọn tối ưu cho đa số trường hợp sử dụng phát triển API.

Kết hợp Gemma 4 và Apidog để hoàn thiện vòng lặp tạo dữ liệu kiểm thử và xác thực API. Sử dụng Gemma 4 cho dữ liệu kiểm thử, phản hồi mock; dùng Smart Mock và Kịch bản Kiểm thử Apidog để xác thực output AI với hợp đồng API của bạn. Quy trình này giúp xây dựng và kiểm thử API hỗ trợ AI thực tế, hiệu quả.

Câu hỏi thường gặp

Gemma 4 là gì?

Gemma 4 là dòng mô hình ngôn ngữ mở mới nhất của Google DeepMind, phát hành tháng 4/2026. Có bốn kích thước (E2B, E4B, 26B MoE, 31B Dense), giấy phép Apache 2.0. 31B hiện xếp hạng #3 trên Arena AI.

Gemma 4 có miễn phí không?

Trọng số mô hình tải và sử dụng miễn phí theo Apache 2.0. Nếu chạy trên Google AI Studio thì có free tier; Vertex AI tính phí theo tài nguyên.

Gemma 4 có xuất JSON có cấu trúc không?

Có. Hỗ trợ response_mime_type: "application/json" tự nhiên qua SDK, luôn trả về JSON hợp lệ cho các case dùng API.

Gemma 4 so sánh với GPT-4o thế nào cho phát triển API?

GPT-4o là mô hình độc quyền, không triển khai cục bộ, chi phí API cao hơn. Gemma 4 31B có thể triển khai miễn phí cục bộ, benchmark cạnh tranh GPT-4o cho nhiều tác vụ. Phù hợp nhóm cần quyền riêng tư và kiểm soát chi phí.

Có thể tinh chỉnh Gemma 4 trên dữ liệu API riêng không?

Có. Google hỗ trợ tinh chỉnh qua AI Studio, Vertex AI, Hugging Face TRL. Tinh chỉnh trên schema và phản hồi API miền giúp tăng chất lượng output.

Cần phần cứng gì để chạy Gemma 4 cục bộ?

31B/26B phù hợp trên GPU NVIDIA H100 80GB (bfloat16); bản lượng tử hóa chạy trên GPU 16-24GB VRAM. E4B/E2B chạy trên điện thoại, Raspberry Pi, Jetson.

Gemma 4 hỗ trợ gọi hàm không?

Có, tất cả các biến thể đều hỗ trợ gọi hàm tự nhiên, định nghĩa dưới dạng JSON với tên, mô tả, schema tham số.

Kiểm thử phản hồi API Gemma 4 tự động thế nào?

Dùng Kịch bản Kiểm thử Apidog để xây dựng chuỗi kiểm thử, nhập endpoint Gemma 4, thiết lập request/validate, chạy tự động cục bộ hoặc trong CI/CD với CLI.

API Qwen3.6-Plus: Vượt Trội Claude Trên Benchmarks

Sebastian Petrus — Thu, 02 Apr 2026 09:32:17 +0000

TÓM TẮT

Qwen3.6-Plus đã chính thức ra mắt với hiệu suất mạnh trên nhiều benchmark: 78,8% SWE-bench Verified, 61,6% Terminal-Bench 2.0 – vượt Claude Opus 4.5. Mô hình hỗ trợ cửa sổ ngữ cảnh 1 triệu token, tham số preserve_thinking mới cho agent loop, và hoạt động trực tiếp với Claude Code, OpenClaw, Qwen Code qua API tương thích OpenAI.

Hãy thử Apidog ngay hôm nay

Bài viết này tập trung vào điểm mới, hướng dẫn gọi API Qwen3.6-Plus, cấu hình tích hợp thực tế và cách xác thực bằng Apidog trước khi triển khai vào quy trình tự động hóa.

Từ bản xem trước đến bản phát hành

Nếu bạn từng tham khảo hướng dẫn Qwen 3.6 Plus Preview trên OpenRouter, bạn đã biết các khả năng của mô hình này. Bản xem trước từng được phát hành miễn phí, không cần danh sách chờ, qua OpenRouter và đã xử lý hơn 400 triệu token chỉ trong hai ngày đầu.

Ở bản chính thức, Qwen3.6-Plus được đưa lên Alibaba Cloud Model Studio với API ổn định, SLA đảm bảo và tham số API mới, tối ưu hơn cho các tác vụ agent đa bước.

Dưới đây là các thay đổi thực tế, mẫu gọi API, và quy trình kiểm thử tích hợp với Apidog.

Qwen3.6-Plus là gì

Qwen3.6-Plus là mô hình mixture-of-experts (MoE) do nhóm Qwen – Alibaba phát triển. Tương tự Qwen3.5, nó sử dụng sparse activation, chỉ kích hoạt một phần nhỏ tham số mỗi token, giúp tiết kiệm chi phí tính toán nhưng giữ hiệu suất cao.

Thông số kỹ thuật nổi bật:

Cửa sổ ngữ cảnh mặc định: 1 triệu token
Hỗ trợ chain-of-thought reasoning bắt buộc
Tham số preserve_thinking cho agentic tasks
Hỗ trợ đa phương thức (thị giác, video, tài liệu)
API tương thích OpenAI, Anthropic và OpenAI function call

Các bản open-source nhẹ hơn sẽ ra mắt sớm. Trọng số self-host đang được phát triển.

Kết quả benchmark

Tác nhân mã hóa

Qwen3.6-Plus chỉ xếp sau Claude Opus 4.5 ở SWE-bench, nhưng vượt trội ở các tác vụ terminal thực tế.

Terminal-Bench 2.0: Kiểm thử thực tế trên shell (quản lý file, process, workflow dài, 32 CPU/48GB RAM/3h timeout). Qwen3.6-Plus: 61,6% (Claude Opus 4.5 chỉ 59,3%).

Agent đa năng & gọi công cụ

Chỉ số	Claude Opus 4.5	Qwen3.6-Plus
TAU3-Bench	70.2%	70.7%
DeepPlanning	33.9%	41.5%
MCPMark	42.3%	48.2%
MCP-Atlas	71.8%	74.1%
WideSearch	76.4%	74.3%

MCPMark: Dẫn đầu về gọi công cụ MCP – cực kỳ quan trọng khi xây dựng workflow dựa trên GitHub MCP.
DeepPlanning: Qwen3.6-Plus vượt trội trong các tác vụ lập kế hoạch dài hạn.

Khả năng suy luận & kiến thức

Chỉ số	Claude Opus 4.5	Qwen3.6-Plus
GPQA	87.0%	90.4%
LiveCodeBench v6	84.8%	87.1%
IFEval strict	90.9%	94.3%
MMLU-Pro	89.5%	88.5%

GPQA/IFEval: Dẫn đầu về reasoning và tuân thủ format – rất quan trọng khi cần đầu ra có cấu trúc, ít sai lệch.

Đa phương thức

Chỉ số	Qwen3.6-Plus	Ghi chú
OmniDocBench 1.5	91.2%	Dẫn đầu
RefCOCO avg	93.5%	Dẫn đầu
We-Math	89.0%	Dẫn đầu
CountBench	97.6%	Dẫn đầu
OSWorld-Verified	62.5%	Thua Claude (66.3%)

Qwen3.6-Plus dẫn đầu về nhận diện tài liệu, không gian, đối tượng; chỉ OSWorld-Verified là Claude nhỉnh hơn.

Hướng dẫn gọi API

Qwen3.6-Plus đã khả dụng trên Alibaba Cloud Model Studio. Đăng ký và lấy API key tại modelstudio.alibabacloud.com.

Base URL theo khu vực:

Singapore: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Bắc Kinh: https://dashscope.aliyuncs.com/compatible-mode/v1
Virginia, US: https://dashscope-us.aliyuncs.com/compatible-mode/v1

Gọi API cơ bản với streaming

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

completion = client.chat.completions.create(
    model="qwen3.6-plus",
    messages=[{"role": "user", "content": "Review this Python function and find bugs."}],
    extra_body={"enable_thinking": True},
    stream=True
)

reasoning = ""
answer = ""
is_answering = False

for chunk in completion:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta
    if hasattr(delta, "reasoning_content") and delta.reasoning_content:
        if not is_answering:
            reasoning += delta.reasoning_content
    if delta.content:
        if not is_answering:
            is_answering = True
        answer += delta.content
        print(delta.content, end="", flush=True)

Tham số preserve_thinking

Ở bản chính thức, tham số preserve_thinking cho phép mô hình giữ lại chuỗi reasoning từ mọi lượt trước. Rất hữu dụng cho agent loop nhiều bước.

completion = client.chat.completions.create(
    model="qwen3.6-plus",
    messages=conversation_history,
    extra_body={
        "enable_thinking": True,
        "preserve_thinking": True,  # giữ reasoning xuyên suốt các lượt
    },
    stream=True
)

Lưu ý: Tắt mặc định để tiết kiệm token. Hãy bật khi xây agent đa bước.

Sử dụng Qwen3.6-Plus với Claude Code

API Qwen hỗ trợ giao thức Anthropic. Chỉ cần đổi biến môi trường, không cần sửa code.

npm install -g @anthropic-ai/claude-code

export ANTHROPIC_MODEL="qwen3.6-plus"
export ANTHROPIC_SMALL_FAST_MODEL="qwen3.6-plus"
export ANTHROPIC_BASE_URL=https://dashscope-intl.aliyuncs.com/apps/anthropic
export ANTHROPIC_AUTH_TOKEN=your_dashscope_api_key

claude

Sử dụng Qwen3.6-Plus với OpenClaw

OpenClaw là agent code open-source self-hosted.

# Cài đặt (Node.js 22+)
curl -fsSL https://molt.bot/install.sh | bash

export DASHSCOPE_API_KEY=your_key
openclaw dashboard

Chỉnh sửa ~/.openclaw/openclaw.json (hợp nhất, không ghi đè):

{
  "models": {
    "providers": [{
      "name": "alibaba-coding-plan",
      "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
      "apiKey": "${DASHSCOPE_API_KEY}",
      "models": [{"id": "qwen3.6-plus", "reasoning": true}]
    }]
  },
  "agents": {
    "defaults": {"models": ["qwen3.6-plus"]}
  }
}

Sử dụng Qwen3.6-Plus với Qwen Code

Qwen Code là agent terminal open-source của Alibaba, tặng 1.000 request miễn phí/ngày qua OAuth.

npm install -g @qwen-code/qwen-code@latest
qwen
# Gõ /auth để đăng nhập và kích hoạt gói miễn phí

Giải thích thực tiễn về preserve_thinking cho agent

Thông thường, mỗi lượt với LLM là độc lập, reasoning không được giữ lại. Điều này gây khó khăn cho agent đa bước: các quyết định trước không truyền được sang bước sau.

preserve_thinking: true sẽ giữ toàn bộ reasoning của các lượt trước, giúp agent hành động logic, nhất quán, không lặp lại reasoning thừa, tiết kiệm token.

Mẫu code agent loop:

conversation = []

def agent_step(user_message, preserve=True):
    conversation.append({"role": "user", "content": user_message})

    response = client.chat.completions.create(
        model="qwen3.6-plus",
        messages=conversation,
        extra_body={
            "enable_thinking": True,
            "preserve_thinking": preserve,
        },
        stream=False
    )

    message = response.choices[0].message
    conversation.append({"role": "assistant", "content": message.content})
    return message.content

# Ví dụ agent đa bước
result = agent_step("Analyze the auth module for security issues.")
result = agent_step("Now suggest fixes for the top 3 issues you found.")
result = agent_step("Write tests that validate each fix.")

Nếu không có preserve_thinking, bước 3 sẽ không biết 3 vấn đề ở bước 1. Có preserve_thinking, reasoning liền mạch.

Ứng dụng tối ưu của Qwen3.6-Plus

Sửa lỗi cấp kho lưu trữ: SWE-bench Verified 78,8% – cạnh tranh top hiện nay.
Tự động hóa terminal: Terminal-Bench 2.0 dẫn đầu – tối ưu cho workflow shell, quản lý file/process/build.
Gọi công cụ MCP: MCPMark 48,2% – tốt nhất cho tích hợp GitHub MCP.
Phân tích tài liệu dài: Context 1 triệu token, điểm LongBench v2 cao – có thể kiểm tra toàn bộ codebase hoặc tài liệu lớn trong một lần gọi.
Sinh mã frontend: Điểm Elo QwenWebBench 1501,7 – tương đương Claude Opus 4.5.
Đa ngôn ngữ: WMT24++ 84,3%, MAXIFE 88,2% trên 23 ngôn ngữ – mạnh với use case không phải tiếng Anh.

Kiểm thử API Qwen3.6-Plus với Apidog

Điểm cuối Qwen3.6-Plus tương thích OpenAI – nhập trực tiếp vào Apidog để kiểm thử.

Thiết lập:

Gửi POST tới: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
Header: Authorization: Bearer {{DASHSCOPE_API_KEY}}

Xác nhận phản hồi mẫu:

pm.test("Response contains choices", () => {
  const body = pm.response.json();
  pm.expect(body).to.have.property("choices");
  pm.expect(body.choices[0].message.content).to.be.a("string").and.not.empty;
});

pm.test("No empty reasoning when thinking enabled", () => {
  const choice = pm.response.json().choices[0];
  if (choice.message.reasoning_content !== undefined) {
    pm.expect(choice.message.reasoning_content).to.not.be.empty;
  }
});

Tips thực tiễn:

Sử dụng Smart Mock của Apidog để tạo phản hồi kiểm thử, không cần gọi API thật khi dev.
Nếu xây agent đa lượt, tạo Test Scenario trong Apidog để chuỗi nhiều request, xác thực việc preserve_thinking giữ reasoning qua lượt.
Tải Apidog miễn phí để thiết lập nhanh test này.

Roadmap

Nhóm Qwen xác nhận sẽ ra mắt các bản open-source nhẹ hơn trong vài ngày tới, theo mô hình Qwen3.5 (Apache 2.0, trọng số công khai).

Lộ trình:

Nâng cấp khả năng agent cho các tác vụ repository đa file, dài hạn.
Phát triển agent đa phương thức (GUI agent, visual coding) trở thành core feature.

Các bản open-source Qwen3.5 từng lọt top mô hình self-host chỉ sau vài tuần. Qwen3.6 dự báo cũng sẽ trở thành lựa chọn mặc định cho agent code tự lưu trữ.

Kết luận

Qwen3.6-Plus thu hẹp khoảng cách với Claude Opus 4.5 ở các benchmark code, vượt trội về terminal, MCP, và planning dài hạn. Context 1 triệu token, tương thích Anthropic, và preserve_thinking giúp agent production thực sự đáng tin cậy.

Tips kiểm thử:

Sử dụng Apidog để nhập endpoint, viết assert, mock khi dev, và chạy test hồi quy mỗi khi cập nhật mô hình hoặc API version.

Câu hỏi thường gặp

Qwen3.6-Plus khác gì bản preview?

Bản preview (qwen/qwen3.6-plus-preview) trên OpenRouter chỉ là thử nghiệm. Bản chính thức có thêm preserve_thinking, SLA uptime, hỗ trợ đầy đủ Model Studio và sắp có bản open-source nhẹ hơn.

preserve_thinking là gì, khi nào nên dùng?

Mặc định chỉ giữ reasoning lượt hiện tại. Khi bật preserve_thinking: true, mô hình giữ toàn bộ chuỗi reasoning trước đó – nên dùng cho agent loop đa bước.

So với Claude Opus 4.5 thế nào?

Claude Opus 4.5 mạnh hơn ở SWE-bench Verified (80,9% vs 78,8%) và OSWorld-Verified (66,3% vs 62,5%). Qwen3.6-Plus dẫn ở Terminal-Bench 2.0, MCPMark, DeepPlanning, GPQA.

Có dùng được với Claude Code không?

Có. Đổi biến môi trường trỏ về endpoint Anthropic của Dashscope, dùng model qwen3.6-plus và API key Dashscope.

Qwen3.6-Plus có open-source không?

API model chưa open-source. Các bản nhẹ hơn với trọng số public sẽ ra mắt rất sớm.

Cách lấy quyền truy cập miễn phí?

Cài Qwen Code (npm install -g @qwen-code/qwen-code@latest), chạy qwen, /auth đăng nhập bằng OAuth để nhận 1.000 request/ngày miễn phí.

Hỗ trợ context tối đa bao nhiêu?

Mặc định 1.000.000 token/lượt. Một số báo cáo benchmark dùng 256K để so sánh, nhưng API hỗ trợ 1M.

Làm sao kiểm thử API trước khi triển khai thực tế?

Nhập endpoint vào Apidog, cấu hình API key, viết assert, dùng Smart Mock để dev offline, tạo Test Scenario để kiểm tra hành vi agent đa lượt end-to-end.

Holo3: Mô Hình Sử Dụng Máy Tính Tốt Nhất?

Sebastian Petrus — Thu, 02 Apr 2026 08:53:36 +0000

Tóm tắt

H Company đã ra mắt Holo3 vào ngày 31 tháng 3 năm 2026, một mô hình "hỗn hợp chuyên gia" đạt 78.85% trên OSWorld-Verified, điểm số cao nhất từng được ghi nhận trên chuẩn mực hàng đầu về sử dụng máy tính để bàn. Nó vượt trội hơn GPT-5.4 và Opus 4.6 với chi phí chỉ bằng một phần nhỏ. API hiện đã hoạt động, và biến thể 35B là mã nguồn mở trên HuggingFace theo giấy phép Apache 2.0.

Dùng thử Apidog ngay hôm nay

Khoảng cách trong việc sử dụng máy tính mà hầu hết các nhà phát triển chưa giải quyết được

Bạn đã tự động hóa các API của mình, hệ thống CI/CD của bạn vận hành ổn định. Tuy nhiên vẫn còn nhiều quy trình bị chặn bởi các phần mềm doanh nghiệp cũ không có API, ứng dụng máy tính để bàn ra đời trước REST, hoặc quy trình làm việc phải đi qua nhiều giao diện người dùng khác nhau.

Các công cụ RPA truyền thống như UiPath hay Automation Anywhere phụ thuộc vào các kịch bản tọa độ màn hình rất dễ vỡ khi giao diện thay đổi. Giải pháp phổ biến là làm thủ công.

Ngày nay, AI sử dụng máy tính có thể xem ảnh chụp màn hình và tự động thực hiện các hành động như nhấp, gõ, cuộn trên bất kỳ giao diện đồ họa nào, không cần API. Holo3 là mô hình mạnh nhất hiện nay cho tác vụ này, đã chính thức phát hành và sẵn sàng tích hợp.

💡 Nếu bạn xây dựng workflow tự động hóa hoặc kiểm thử pipeline liên quan tới phần mềm máy tính để bàn, nên thử ngay API của Holo3. Nếu bạn sử dụng Apidog để thiết kế và kiểm thử API, các phần dưới sẽ hướng dẫn tích hợp gọi Holo3 vào quy trình của bạn.

Holo3 là gì?

Holo3 là mô hình AI sử dụng máy tính: bạn gửi ảnh chụp màn hình desktop hoặc browser, mô tả tác vụ, và nhận về các hành động (click, gõ phím, cuộn) để thực hiện trên màn hình. Quy trình: chụp kết quả, gửi lại, lặp lại đến khi hoàn thành.

H Company cung cấp:

Holo3-122B-A10B: Phiên bản mạnh nhất, 122B tham số (10B hoạt động, MoE thưa). Truy cập qua API tại hcompany.ai/holo-models-api. Đạt kỷ lục benchmark.
Holo3-35B-A3B: 35B tham số, 3B hoạt động. Mã nguồn mở trên HuggingFace (Apache 2.0). Có gói miễn phí qua API, hỗ trợ tự lưu trữ.

Kiến trúc MoE giúp chỉ kích hoạt một phần tham số/mỗi token, giảm chi phí vận hành so với tổng số tham số. H Company khẳng định Holo3-122B-A10B có chi phí thấp hơn GPT-5.4 và Opus 4.6 trên mỗi tác vụ.

OSWorld-Verified: Chuẩn mực thực tế cho sử dụng máy tính

OSWorld-Verified là benchmark hàng đầu đánh giá AI sử dụng máy tính. Khác với các benchmark chỉ chấm đầu ra văn bản, OSWorld kiểm tra tác vụ thực tế: agent phải hoàn thành tác vụ trên máy tính thật, xác minh bằng trạng thái hệ thống sau khi thực thi.

Phạm vi tác vụ:

Tác vụ một ứng dụng: mở file, điền form, sao chép dữ liệu giữa các ô
Quy trình đa ứng dụng: lấy dữ liệu từ PDF, cập nhật bảng tính, gửi email xác nhận
Chuỗi dài yêu cầu phối hợp nhiều hệ thống không mất ngữ cảnh

Holo3-122B-A10B đạt 78.85% trên OSWorld-Verified. Trước đây, điểm trên 40% đã là tiên tiến. Anthropic và OpenAI từng dẫn đầu với khoảng 60-65%.

Các benchmark nội bộ của H Company (H Corporate Benchmarks) trên 486 tác vụ thương mại điện tử, phần mềm doanh nghiệp, hợp tác và workflow đa ứng dụng cho thấy Holo3 đặc biệt mạnh ở workflow đa ứng dụng (phối hợp nhiều ứng dụng cùng lúc).

Holo3 được đào tạo như thế nào: Chu trình học tập Agentic

Hầu hết các mô hình sử dụng máy tính chỉ được đào tạo trên dữ liệu tĩnh. H Company xây dựng chu trình học tập Agentic gồm:

Dữ liệu điều hướng tổng hợp: Hướng dẫn người thật + dữ liệu tổng hợp tạo các ví dụ điều hướng cụ thể.
Mở rộng ngoài miền: Mở rộng kịch bản để mô hình gặp các UI state bất ngờ, case biên.
Học tăng cường được tuyển chọn: Dữ liệu được chọn lọc và đưa vào pipeline RL để tối đa hóa tỉ lệ hoàn thành tác vụ.

Dữ liệu học lấy từ Nhà máy môi trường tổng hợp - nơi agent tự code ứng dụng web doanh nghiệp giả lập, với tác vụ có thể xác minh end-to-end. Nhờ vậy, mô hình học trên workflow thực tế thay vì ví dụ đơn giản.

Kết quả: Holo3 vượt xa các mô hình lớn hơn về tham số như Qwen3.5 trên cùng benchmark, nhờ phương pháp huấn luyện thay vì chỉ dựa vào quy mô mô hình.

Cách gọi API Holo3

API Holo3 tuân theo mô hình vòng lặp chụp màn hình - hành động. Quy trình thực tế như sau:

1. Thiết lập xác thực

# API base URL
https://api.hcompany.ai/v1

# Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Lấy API key tại hcompany.ai/holo-models-api. Gói miễn phí hỗ trợ Holo3-35B-A3B.

2. Gửi ảnh chụp màn hình và tác vụ

import base64
import httpx
import pyautogui

screenshot = pyautogui.screenshot()
screenshot.save("/tmp/screen.png")

with open("/tmp/screen.png", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

response = httpx.post(
    "https://api.hcompany.ai/v1/computer-use",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "holo3-122b-a10b",
        "task": "Open the invoice folder and find the most recent PDF",
        "screenshot": image_b64,
        "screen_width": 1920,
        "screen_height": 1080
    }
)

action = response.json()
print(action)

3. Phân tích cú pháp và thực thi hành động

API trả về các hành động dạng JSON:

{
  "action_type": "click",
  "coordinate": [245, 380],
  "reasoning": "The invoice folder icon is visible at this position"
}

Các loại hành động gồm: click, double_click, right_click, type, key, scroll, screenshot_request, task_complete.

4. Lặp lại cho đến khi hoàn thành

def run_computer_use_task(task: str, max_steps: int = 20):
    for step in range(max_steps):
        screenshot = capture_screen()
        response = call_holo3_api(task, screenshot)
        action = response["action"]

        if action["action_type"] == "task_complete":
            print(f"Done in {step + 1} steps")
            return response["result"]

        execute_action(action)

    raise TimeoutError("Task not completed within step limit")

Kiểm thử các lệnh gọi API Holo3 với Apidog

Sau khi tích hợp API Holo3, bạn cần xác thực tích hợp hoạt động ổn định. Apidog giúp tự động hóa kiểm thử nhanh chóng.

Nhập endpoint: Trong Apidog, tạo HTTP request tới https://api.hcompany.ai/v1/computer-use. Thêm header Authorization dưới dạng biến môi trường.

Thiết lập xác nhận kiểm thử: Sử dụng script kiểm thử phản hồi để kiểm tra cấu trúc trả về:

// In Apidog's post-response script
pm.test("Action type is valid", () => {
    const validActions = ["click", "type", "key", "scroll", "task_complete", "screenshot_request"];
    pm.expect(validActions).to.include(pm.response.json().action.action_type);
});

pm.test("Coordinates are within screen bounds", () => {
    const action = pm.response.json().action;
    if (action.coordinate) {
        pm.expect(action.coordinate[0]).to.be.within(0, 1920);
        pm.expect(action.coordinate[1]).to.be.within(0, 1080);
    }
});

Giả lập API khi phát triển: Dùng Smart Mock của Apidog để giả lập phản hồi Holo3, tiết kiệm tín dụng API và cho phép frontend/backend phát triển song song.

Chạy kịch bản kiểm thử: Xâu chuỗi nhiều request Holo3 trong một Kịch bản kiểm thử Apidog để mô phỏng workflow nhiều bước, kiểm tra tính nhất quán trước khi chạy thật.

Holo3 so với Claude Computer Use so với OpenAI Operator

	Holo3-122B	Holo3-35B	Claude Computer Use	OpenAI Operator
OSWorld-Verified	78.85%	~55%	~65%	~62%
Truy cập API	Có	Có (free)	Có	Có
Mã nguồn mở	Không	Có	Không	Không
Tự lưu trữ	Không	Có	Không	Không
Chi phí so với GPT-5.4	Thấp hơn	Thấp hơn nhiều	Tương đương	Như GPT-5.4
Tốt nhất cho	Sản xuất	Dev/OSS	Anthropic users	OpenAI users

Lựa chọn thực tế:

Holo3-122B: Độ chính xác tối đa, workflow đa ứng dụng phức tạp, chi phí không phải vấn đề lớn.
Holo3-35B: Phù hợp phát triển, kiểm thử, dự án mã nguồn mở, hoặc tự lưu trữ.
Claude Computer Use: Nếu bạn đã dùng nhiều dịch vụ Anthropic.
OpenAI Operator: Nếu hệ thống của bạn tiêu chuẩn hóa trên GPT-5.4.

Các trường hợp sử dụng trong doanh nghiệp

Holo3 giải quyết các workflow không có API rõ ràng:

Nhập dữ liệu hệ thống cũ: ERP/CRM đời cũ không có REST API. Holo3 thao tác trực tiếp UI desktop.
Đối chiếu đa nền tảng: Trích dữ liệu từ PDF, kiểm tra với bảng tính, cập nhật dashboard bên thứ ba.
Kiểm thử hồi quy ứng dụng web: Không cần script Selenium dễ vỡ, chỉ cần mô tả tác vụ bằng tự nhiên ngữ.
Thông tin cạnh tranh: Trích xuất dữ liệu có cấu trúc từ web chống scraping.

Các benchmark doanh nghiệp nội bộ cho thấy Holo3 mạnh nhất ở workflow đa ứng dụng, nơi cần phối hợp nhiều ứng dụng mà không mất context.

Điều gì tiếp theo: Cơ chế thích ứng

H Company đang tập trung vào Cơ chế thích ứng – cho phép mô hình không chỉ sử dụng phần mềm từng thấy mà còn tự học cách vận hành phần mềm hoàn toàn mới, chưa từng huấn luyện, trong thời gian thực.

Hiện tại, mọi mô hình (kể cả Holo3) đều huấn luyện trên một tập hợp hữu hạn các môi trường phần mềm. Khi gặp phần mềm nội bộ tùy chỉnh, tỉ lệ thành công giảm. Cơ chế thích ứng sẽ giúp mô hình xây dựng hiểu biết về UI ngay lần đầu, không cần dữ liệu training trước.

Nếu thành công, AI sử dụng máy tính sẽ không còn giới hạn triển khai cho doanh nghiệp.

Kết luận

Holo3 đặt ra tiêu chuẩn mới cho tự động hóa GUI desktop. Với 78.85% OSWorld-Verified, nó vượt xa Claude và GPT ở workflow phức tạp. Gói miễn phí Holo3-35B-A3B và mã nguồn mở giúp thử nghiệm dễ dàng, không rào cản chi phí.

Tích hợp rất đơn giản: chụp màn hình, POST tới API, thực thi action trả về, lặp lại. Apidog giúp kiểm thử API tự động, giả lập phát triển, chuỗi workflow kiểm thử trước khi triển khai production.

Nếu bạn xây dựng workflow liên quan GUI desktop, hãy dùng thử Apidog miễn phí và kiểm thử tích hợp Holo3 trước khi đưa vào sản xuất.

Câu hỏi thường gặp

Holo3 là gì?

Holo3 là AI sử dụng máy tính từ H Company, nhận input ảnh chụp màn hình và trả về hành động (click, gõ, cuộn) để hoàn thành tác vụ trên desktop hoặc browser. Đạt 78.85% OSWorld-Verified – cao nhất tính đến nay.

Holo3 có phải mã nguồn mở?

Holo3-35B-A3B là mã nguồn mở (Apache 2.0), tải từ HuggingFace. Holo3-122B-A10B chỉ có qua API. Cả hai đều có API inference, 35B miễn phí.

OSWorld benchmark hoạt động thế nào?

OSWorld kiểm tra agent trên tác vụ thật: duyệt web, quản lý file, workflow đa ứng dụng. Thành công xác minh qua trạng thái hệ thống, không phải văn bản đầu ra.

Holo3 so với Claude Computer Use thế nào?

Holo3-122B đạt điểm cao hơn trên OSWorld-Verified (78.85% vs ~65% Claude), chi phí thấp hơn mỗi tác vụ. Claude vẫn mạnh nếu bạn dùng hệ sinh thái API Anthropic.

Có thể chạy Holo3 cục bộ không?

Có, với Holo3-35B-A3B. Trọng số tải ở HuggingFace (Apache 2.0). 122B chỉ có qua API.

Ứng dụng chính của API sử dụng máy tính?

Tự động hóa hệ thống cũ, workflow đa ứng dụng, kiểm thử hồi quy web không cần selector, thu thập thông tin cạnh tranh, bất kỳ workflow desktop nào yêu cầu thao tác người thật.

Cách kiểm thử tích hợp API Holo3?

Dùng Apidog: nhập endpoint, thiết lập xác thực phản hồi, giả lập API khi phát triển, xâu chuỗi các request thành kịch bản kiểm thử. Phát hiện lỗi tích hợp trước khi chạy thật.

"Cơ chế thích ứng" trong roadmap Holo3 là gì?

H Company nghiên cứu mô hình có thể sử dụng phần mềm hoàn toàn mới, học cấu trúc UI theo thời gian thực thay vì đòi hỏi dữ liệu training trước. Đây là bước loại bỏ giới hạn lớn nhất của AI sử dụng máy tính cho doanh nghiệp tuỳ chỉnh.

Tấn Công Chuỗi Cung Ứng axios@1.14.1: Cần Làm Gì Ngay?

Sebastian Petrus — Thu, 02 Apr 2026 08:49:18 +0000

TÓM TẮT

Vào ngày 30–31 tháng 3 năm 2026, các phiên bản axios 1.14.1 và 0.30.4 trên npm đã bị cài cắm phần phụ thuộc độc hại, cài đặt trojan truy cập từ xa (RAT) lên máy bị nhiễm. Cả hai phiên bản đã bị gỡ bỏ, phiên bản an toàn là 1.14.0. Nếu bạn từng cài axios@1.14.1 hoặc 0.30.4, hãy coi máy của mình đã bị xâm nhập và thay đổi toàn bộ thông tin xác thực ngay lập tức.

Dùng thử Apidog ngay hôm nay

Axios là gì và tại sao điều này lại quan trọng

axios đạt 100 triệu lượt tải mỗi tuần trên npm. Đây là HTTP client phổ biến cho cả frontend framework, backend Node.js và ứng dụng doanh nghiệp. Khi một gói nền tảng như vậy bị xâm phạm, phạm vi ảnh hưởng rất lớn — chỉ cần chạy npm install trong khung thời gian 30–31/3 là đã có thể vô tình cài phần mềm độc hại.

Đây là một rủi ro chuỗi cung ứng thực tế, không phải lý thuyết: trojan đa giai đoạn này cho phép thực thi lệnh tùy ý, đánh cắp dữ liệu hệ thống và duy trì hoạt động trên máy nhiễm. Nếu đội nhóm bạn dùng axios, và bạn dùng Apidog để thiết kế/kiểm thử HTTP client, hãy đọc kỹ hướng dẫn này trước khi deploy tiếp theo.

Dòng thời gian của cuộc tấn công

30/03/2026 — 23:59:12 UTC: Gói độc hại plain-crypto-js@4.2.1 được phát hành lên npm, sử dụng email nrwise@proton.me. Trước đó, bản sạch 4.2.0 đã được đưa lên để ngụy trang.
31/03/2026 — 00:05:41 UTC: Socket (hệ thống phát hiện phần mềm độc hại) gắn cờ plain-crypto-js@4.2.1 là mã độc chỉ sau 6 phút phát hành.
31/03/2026 — ngay sau nửa đêm: axios@1.14.1 được phát hành, kéo theo plain-crypto-js@4.2.1 làm dependency. Bản phát hành này không có trong GitHub tag chính thức.
31/03/2026 — buổi sáng: Issue GitHub #10604 công khai về việc axios bị xâm phạm. Ban đầu maintainer không thể thu hồi quyền của attacker do quyền npm vượt trội.
31/03/2026: Cả axios@1.14.1 và axios@0.30.4 bị gỡ khỏi npm. Maintainer thu hồi token, siết chặt kiểm soát quyền xuất bản và điều tra quy trình phát hành.

Cách cuộc tấn công diễn ra

Attacker tận dụng lỗ hổng quy trình phát hành: dùng một npm token có thời hạn dài cùng quy trình xuất bản tự động. Sau khi có được thông tin xác thực maintainer, attacker phát hành phiên bản mới ngoài quy trình chính thức, thêm plain-crypto-js@4.2.1 làm dependency. Gói này được ngụy trang như một thư viện mã hóa hợp pháp.

Bên trong plain-crypto-js@4.2.1 là một chuỗi mã độc đa giai đoạn:

Giai đoạn 1 — Thực thi: Gói chạy mã tại thời điểm cài đặt (qua npm lifecycle script) để drop payload thứ cấp.
Giai đoạn 2 — RAT: Payload cài đặt trojan truy cập từ xa, mở backdoor bền vững.
Giai đoạn 3 — Đánh cắp dữ liệu: RAT thực thi lệnh shell từ C2, đọc biến môi trường & file bí mật, gửi dữ liệu ra ngoài.

RAT có thể duy trì hoạt động kể cả sau khi gói npm đã bị gỡ bỏ, trừ khi máy bị quét và làm sạch thủ công.

Tôi có bị ảnh hưởng không?

Bạn có khả năng bị ảnh hưởng nếu:

Đã chạy npm install axios hoặc npm install (axios trong package.json) từ 23:59 UTC ngày 30/3 đến trưa UTC ngày 31/3/2026.
node_modules/axios/package.json báo version 1.14.1 hoặc 0.30.4.
package-lock.json hoặc yarn.lock phân giải axios về các version trên.

Kiểm tra ngay:

# Kiểm tra axios đã cài
npm list axios

# Kiểm tra package-lock
grep '"axios"' package-lock.json | head -5

# Kiểm tra plain-crypto-js
npm list plain-crypto-js
ls node_modules/plain-crypto-js 2>/dev/null && echo "BỊ NHIỄM" || echo "Không tìm thấy"

Nếu plain-crypto-js xuất hiện trong node_modules, máy bạn đã chạy mã độc.

Cần làm gì ngay bây giờ

1. Cập nhật axios ngay lập tức

npm install axios@1.14.0
# hoặc ghim vào phiên bản an toàn mới nhất
npm install axios@latest

Xác minh lại:

npm list axios
# Phải là 1.14.0 hoặc cao hơn (sau khi có bản sạch mới)

2. Nếu bạn đã cài phiên bản bị xâm phạm

Đây không phải update dependency thông thường — hãy coi máy đã bị xâm nhập:

Thay đổi toàn bộ bí mật có thể truy cập từ máy: API key, database credential, SSH key, token cloud, biến .env, v.v.
Kiểm tra biến môi trường — RAT nhắm đến các biến môi trường và file bí mật.
Kiểm tra outbound network trong khung thời gian nghi ngờ — tìm kết nối tới IP lạ.
Quét dấu vết duy trì hoạt động — cron job, script khởi động, service systemd được thêm bất thường.
Cài lại OS nếu là CI runner hoặc production server đã cài bản bị xâm phạm. Nếu là laptop dev, thay đổi toàn bộ credential trước khi coi là sạch.

3. Kiểm tra các pipeline CI/CD

Nếu CI/CD đã từng chạy npm install trong khoảng thời gian trên, môi trường CI có thể đã nhiễm mã độc:

# Kiểm tra build log trong thời điểm bị ảnh hưởng
# Tìm axios@1.14.1 trong output cài đặt

# Xác minh lại node_modules của CI
npm list axios plain-crypto-js

Thay đổi tất cả bí mật mà pipeline CI có quyền truy cập: deployment key, cloud credential, registry token.

4. Xác minh tệp khóa

Hãy chắc chắn package-lock.json/yarn.lock không còn reference tới 1.14.1/0.30.4. Nếu có, tạo lại file khóa:

rm package-lock.json
npm install

Kiểm tra file khóa mới phải phân giải axios về bản an toàn trước khi commit.

Sử dụng Apidog để kiểm tra các cuộc gọi API của axios của bạn

Nếu bạn dùng axios làm HTTP client, Apidog giúp xác minh tích hợp API vẫn hoạt động đúng sau khi cập nhật dependency.

Sau khi lên axios@1.14.0, nhập các endpoint API hiện có vào Apidog và chạy kiểm thử hồi quy để đảm bảo không xảy ra sai lệch request/response. Đặc biệt, nếu lo rằng bản mã độc đã tiêm thêm dữ liệu, hãy bổ sung assert kiểm tra:

// Khẳng định phản hồi của Apidog
pm.test("Phản hồi sạch — không có trường nào bị tiêm vào", () => {
    const body = pm.response.json();
    pm.expect(body).to.not.have.property('__injected');
    pm.expect(pm.response.headers.get('X-Injected-Header')).to.be.null;
});

Chạy toàn bộ test suite với axios đã nâng cấp trong Apidog sẽ cho bạn baseline sạch trước khi đẩy lên production.

Dùng thử Apidog miễn phí để thiết lập kiểm thử hồi quy HTTP client.

Tại sao các cuộc tấn công chuỗi cung ứng trên npm lại khó ngăn chặn

Đây là mô hình phổ biến, không phải ngoại lệ:

event-stream (2018): Maintainer độc hại thêm mã độc nhắm tới ví bitcoin.
ua-parser-js (2021): Bị xâm phạm để cài cryptominer và password stealer.
node-ipc (2022): Maintainer cố ý thêm mã phá hoại nhắm tới IP nhất định.
xz utils (2024): Chiến dịch kéo dài 2 năm để cài backdoor vào thư viện nén Linux.
axios (2026): Credential maintainer bị xâm phạm, RAT được phát hành qua dependency độc hại.

Điểm chung: quyền xuất bản thuộc về tài khoản, không phải mã nguồn. Nếu credential maintainer bị rò rỉ, attacker sẽ thừa hưởng toàn bộ trust chain.

Các biện pháp thực tiễn:

Biện pháp	Tác dụng
Tệp khóa (`package-lock.json`)	Ghim version, ngăn update âm thầm
`npm audit` trong CI	Cảnh báo lỗ hổng đã biết trước khi deploy
Socket.dev / Snyk	Phân tích hành vi, cảnh báo gói đáng ngờ trước khi có CVE
Xác thực hai yếu tố trên npm	Khó xâm phạm credential hơn
`npm publish` với short-lived token	Hạn chế thời gian lộ nếu token bị leak
Đọc diff tệp khóa trong PR	Phát hiện thay đổi dependency bất thường khi duyệt code

Nhóm axios hiện đã chuyển sang kiểm soát xuất bản chặt chẽ, loại bỏ dần token dài hạn. Nhưng giải pháp cần đến từ cả hệ sinh thái, không chỉ từng gói riêng lẻ.

Chỉ số về sự thỏa hiệp (IOCs)

Theo Socket:

Gói độc hại: plain-crypto-js@4.2.1, axios@1.14.1, axios@0.30.4
Email phát hành: nrwise@proton.me
Hành vi: Kết nối mạng khi cài npm, RAT duy trì hoạt động, đánh cắp biến môi trường
Phiên bản axios an toàn: 1.14.0 trở xuống (trừ 0.30.4), 1.13.x, 1.12.x

Nếu nghi ngờ bị lây nhiễm, báo cáo về security@npmjs.com và lưu toàn bộ log.

Kết luận

Sự kiện axios 1.14.1 bị xâm phạm nhấn mạnh rằng bảo mật dependency là quy trình liên tục, không phải kiểm tra một lần. Hãy luôn khóa version, tích hợp phân tích hành vi như Socket vào CI, thay đổi credential khi nghi ngờ bất thường, và duyệt lại file khóa thường xuyên.

Nếu cần xác thực lại tích hợp API sau khi cập nhật axios, Apidog cung cấp đầy đủ test case, assertion và mock để đảm bảo hành vi HTTP client ổn định trước khi deploy.

Câu hỏi thường gặp

Các phiên bản axios nào đã bị xâm phạm?

axios@1.14.1 và axios@0.30.4. Đã bị gỡ khỏi npm. An toàn: 1.14.0 hoặc các bản 1.13.x, 1.12.x.

Gói độc hại của axios làm gì?

Kéo theo plain-crypto-js@4.2.1, triển khai RAT đa giai đoạn: thực thi lệnh từ xa, đánh cắp biến môi trường, duy trì hoạt động cả sau reboot.

Làm sao biết mình đã cài bản dính mã độc?

Chạy npm list axios — nếu ra 1.14.1/0.30.4 thì đã bị ảnh hưởng. Kiểm tra thêm npm list plain-crypto-js — có là mã độc đã chạy.

Chỉ cần update axios là đủ?

Không. Update chỉ ngăn future install, nhưng RAT có thể đã được cài và hoạt động. Nếu đã từng cài bản bị xâm phạm, phải đổi toàn bộ credential + kiểm tra máy kỹ càng.

Kẻ tấn công phát hành lên npm bằng cách nào?

Khả năng cao đã lấy được credential maintainer và dùng token npm dài hạn có quyền publish. Nhóm axios đang điều tra và đã siết lại quy trình.

Khác biệt giữa vụ này và lỗ hổng phần mềm bình thường?

Lỗ hổng là bug trong mã hợp pháp. Chuỗi cung ứng là mã độc được phát hành qua kênh chính thống. Mã độc không bao giờ có trong GitHub axios — chỉ bị tiêm vào npm.

Bảo vệ dự án khỏi tấn công chuỗi cung ứng thế nào?

Dùng tệp khóa, chạy npm audit trong CI, thêm Socket.dev để phân tích hành vi, bật 2FA tài khoản npm, dùng short-lived token khi publish, kiểm tra diff của file lock khi duyệt PR.

AI Coding Agent Tốt Nhất 2026? So Sánh Claude Code vs OpenClaw

Sebastian Petrus — Thu, 02 Apr 2026 08:20:03 +0000

TL;DR / Câu trả lời nhanh

Claude Code mạnh hơn cho các quy trình kỹ thuật phần mềm tập trung vào terminal và IDE: chỉnh sửa mã, suy luận theo kho lưu trữ, tự động hóa review và vòng lặp code có kiểm soát. OpenClaw mạnh hơn cho các hoạt động tác nhân đa kênh: nhắn tin nhiều nền tảng, định tuyến đa nhà cung cấp, hệ sinh thái plugin, tự động hóa cấp cổng.

💡Đối với các nhóm API, bộ công cụ thực tế không chỉ là "Claude Code vs OpenClaw". Hãy dùng một trong số chúng để viết mã và điều phối, sau đó dùng Apidog để quản lý toàn bộ vòng đời API: thiết kế, kiểm thử, gỡ lỗi, giả lập và tài liệu.

Dùng thử Apidog ngay hôm nay

nút

Giới thiệu

Nhiều bài "Claude Code vs OpenClaw" chỉ tóm tắt sự khác biệt trong một câu, nhưng để chọn công cụ phù hợp, bạn cần phân tích sâu hơn: vị trí mỗi công cụ trong quy trình, chi phí vận hành, kiểm soát bảo mật và phản hồi thực tế từ cộng đồng.

Bài viết này so sánh:

Phạm vi & kiến trúc sản phẩm
CLI và tự động hóa
Quyền hạn, phê duyệt & sandboxing
Mô hình bộ nhớ và ngữ cảnh
Tích hợp, phạm vi kênh
Quản lý đa tác nhân & vận hành
Trường hợp sử dụng thực tế

Bài viết cũng trả lời câu hỏi: Apidog phù hợp ở đâu khi công cụ tác nhân mã hóa và quản trị vòng đời API là hai sản phẩm khác nhau?

Apidog xuất hiện sớm vì vai trò quan trọng: Nếu chỉ dùng tác nhân viết mã, bạn vẫn cần một hệ thống để thiết kế API schema-first, kiểm thử hồi quy, giả lập và tài liệu có thể xuất bản. Apidog đáp ứng trọn quy trình này.

Phần 1: Sự khác biệt cốt lõi của sản phẩm

Claude Code và OpenClaw có chồng lấn, nhưng không phải bản sao.

Claude Code: Tác nhân viết mã, tập trung vào hiểu codebase, chỉnh sửa file, thực thi lệnh, tích hợp IDE, hook, session, quy trình CI.
OpenClaw: Nền tảng cổng rộng hơn, có khả năng viết mã, nhấn mạnh lệnh đa dạng, hỗ trợ nhiều nhà cung cấp mô hình, kết nối kênh, plugin, định tuyến đa tác nhân, kiểm soát vận hành.

Ứng dụng thực tế

Claude Code tối ưu vòng lặp developer.
OpenClaw tối ưu vòng lặp platform agent.

Nếu nhóm bạn làm việc chủ yếu trong code repo, pull request → Chọn Claude Code.

Nếu nhóm cần tác nhân hoạt động đa kênh, multi-provider, kiểm soát cổng → Chọn OpenClaw.

Bảng định vị nhanh

Danh mục	Claude Code	OpenClaw
Hướng chính	Tác nhân viết mã	Nền tảng tác nhân + cổng
Giá trị chính	Chất lượng quy trình nhà phát triển	Phạm vi tích hợp & điều phối
Giao diện ưu tiên	Terminal + IDE	CLI + kênh + plugin
Nhóm phù hợp nhất	Backend/Platform Dev	Nhóm vận hành, tự động hóa
Vòng đời API	Một phần (viết mã)	Một phần (tự động hóa)

Phần 2: So sánh đầy đủ từng tính năng

1) CLI & Mô hình lệnh

Claude Code CLI: Tối ưu code, có session, flag hệ thống, setting model, worktree, limit tool.
OpenClaw CLI: Lệnh rộng, bao gồm agent/model/memory/approval/sandbox/browser/cron/webhook/channel/plugin/security.

Thực tế:

Claude Code: CLI gọn cho code.
OpenClaw: CLI rộng cho platform.

2) Tích hợp IDE & Trải nghiệm code

Claude Code: Extension cho VS Code (inline diff, diagnostic, context, tích hợp tool IDE).
OpenClaw: Hỗ trợ code, tài liệu tập trung bề mặt đa dạng hơn là workflow sâu trong IDE.

Thực tế:

Claude Code: Trải nghiệm code native IDE vượt trội.
OpenClaw: Phù hợp khi IDE chỉ là một phần trong hệ thống lớn.

3) Đa tác nhân & Ủy quyền

Claude Code: Hỗ trợ agent phụ/nhóm cho task phần mềm.
OpenClaw: Định tuyến đa tác nhân, workspace riêng, session/agent, policy/agent.

Thực tế:

Claude Code: Parallel coding tốt.
OpenClaw: Phân vùng đa tác nhân rõ ràng, mạnh.

4) Bộ nhớ & Ngữ cảnh dài hạn

Claude Code: Dùng file CLAUDE.md, memory auto, lưu trữ theo phạm vi dự án.
OpenClaw: Tìm kiếm ngữ nghĩa, lệnh index/search file memory.

Thực tế:

Claude Code: Memory tích hợp sâu session code.
OpenClaw: Memory rõ ràng, thao tác thuận tiện.

5) Kiểm soát bảo mật: Quyền, phê duyệt, sandbox

Claude Code: Cấu hình quyền, policy theo hook, kiểm soát cấp cài đặt.
OpenClaw: Tài liệu bảo mật đầy đủ, giả định triển khai, ranh giới tin cậy, policy approval, hướng dẫn tăng cường bảo mật.

Thực tế:

Claude Code: Dễ áp dụng quản trị code.
OpenClaw: Bảo mật vận hành, đa kênh.

6) Hook & Rào chắn xác định

Claude Code: Hook là mẫu chuẩn cho hành vi xác định trên event tool.
OpenClaw: Hook & automation event qua cổng, plugin, lệnh vận hành.

Thực tế:

Claude Code: Chuẩn hóa code standard, lệnh guard.
OpenClaw: Tốt khi cần điều phối hoạt động lớn.

7) Tính linh hoạt nhà cung cấp mô hình

Claude Code: Ưu tiên Claude, có roadmap tích hợp bên thứ 3.
OpenClaw: Hỗ trợ đa provider, hướng dẫn bắt đầu nhanh, danh mục provider rộng.

Thực tế:

Claude Code: Tốt nhất nếu tiêu chuẩn hóa Claude.
OpenClaw: Linh hoạt ghép provider.

8) Tích hợp kênh & nhắn tin

Claude Code: Hỗ trợ collaboration, không phải sản phẩm chính.
OpenClaw: Hỗ trợ kênh rộng: Telegram, Slack, Discord, WhatsApp, Signal, Google Chat, Teams, IRC, Mattermost...

Thực tế:

Nếu kênh nhắn tin là trọng tâm, OpenClaw nổi trội.

9) Plugin & Khả năng mở rộng

Claude Code: Mở rộng qua MCP, lệnh, hook trong context code.
OpenClaw: Đầy đủ quản lý plugin (list, install, enable, disable, doctor), mẫu marketplace.

Thực tế:

Claude Code: Mở rộng theo workflow developer.
OpenClaw: Mở rộng platform builder.

10) Chi phí vận hành

Claude Code: Nhanh đưa vào sử dụng cho nhóm phần mềm.
OpenClaw: Linh hoạt hơn, cần kỷ luật vận hành: policy gateway, boundary kênh, security, runbook.

Thực tế:

Claude Code: Chi phí thiết lập thấp cho nhóm dev.
OpenClaw: Lợi ích cao khi cần điều phối large-scale.

Phần 3: Trường hợp sử dụng cộng đồng (Tín hiệu thực địa)

Danh sách tính năng hữu ích, nhưng tín hiệu xã hội cho thấy điểm mạnh/yếu thực tế.

Trường hợp A: Phạm vi truy cập máy cục bộ

Thảo luận cộng đồng (26/3/2026): quyền truy cập rộng cục bộ = không thể đoán trước, nên giới hạn phạm vi.

Claude Code mạnh về task cục bộ, nhưng cần giới hạn phạm vi rõ ràng.
Ưu tiên ranh giới thư mục/tác vụ thay vì quyền root máy.
Đây là mẫu governance, không chỉ là mẫu mô hình.

Trường hợp B: Áp lực giới hạn phiên & lập lịch công việc

Community post (26/3/2026): giới hạn session giờ cao điểm, cần lên lịch ngoài giờ cao điểm.

Với Claude Code, cần lên kế hoạch thông lượng, xử lý batch/off-peak.
Policy vận hành thành quy tắc nhóm.

Trường hợp C: Triển khai OpenClaw + Telegram cục bộ

Community post (24/1/2026): workflow OpenClaw chạy qua Telegram, thành công sau khi tăng bảo mật.

OpenClaw phù hợp cho điều khiển từ xa qua kênh.
Bảo mật cổng vẫn là yếu tố then chốt.

Trường hợp D: Lớp điều phối OpenClaw với worker code

Community post (2/2026): OpenClaw làm lớp điều phối, agent code xử lý task triển khai.

OpenClaw là control plane cho pipeline đa tác nhân.
Claude Code vẫn là chuyên gia code trong sơ đồ rộng.

Trường hợp E: Thử nghiệm tự động hóa ưu tiên kênh

Community post (2/2026): hackathon kiểm soát OpenClaw qua nhắn tin cho hoạt động robot.

OpenClaw có tốc độ thử nghiệm tự động hóa native channel.
Vượt khỏi phạm vi của agent code-only.

Tổng kết tín hiệu xã hội

Claude Code mạnh nhất với workflow kỹ thuật trong repo/IDE.
OpenClaw mạnh nhất với điều phối đa giao diện/kênh/tác nhân.

Phần 4: Chi phí & thời gian giới thiệu

Đừng chỉ so sánh tính năng, hãy tính cả chi phí công cụ và thời gian setup.

Ảnh chụp chi phí giới thiệu (27/3/2026)

Mục	Claude Code	OpenClaw
Truy cập sản phẩm cơ bản	Anthropic Pro (20$/tháng), Max (100$/tháng), API usage	Mã nguồn mở MIT, không phí nền tảng
Chi phí giấy phép	Theo gói đăng ký	0$
Yếu tố chi phí	Giới hạn Claude/token API	API provider + hạ tầng
Phong cách lập ngân sách	Chỗ ngồi/token	Hạ tầng + token provider

Ảnh chụp thời gian giới thiệu

Bước	Claude Code	OpenClaw
Cài đặt lần đầu	Ngắn (Node + CLI auth)	Ngắn (installer + `openclaw onboard`)
Thời gian sử dụng đầu tiên	Nhanh (code terminal/IDE)	Nhanh (bảng điều khiển, thêm thời gian cho kết nối kênh)
Thời gian đến production	Trung bình	Trung bình-cao
Rủi ro lớn nhất	Sai policy/quyền tự động hóa code	Sai bảo mật gateway/kênh

Giải thích thực tế về chi phí-thời gian

Claude Code: Chi phí đầu vào dự báo tốt nếu nhóm đã dùng Anthropic.
OpenClaw: Rẻ về giấy phép, nhưng tổng chi phí phụ thuộc usage provider, hạ tầng, vận hành.
Setup Claude Code nhanh với quy trình chỉ code.
OpenClaw setup nhanh cho cục bộ, tăng dần với yêu cầu kênh/bảo mật.

Phần 5: Vị trí của Apidog (Không thể bỏ qua cho nhóm API)

Claude Code & OpenClaw không thay thế quản trị vòng đời API.

Chúng giúp tạo & tự động hóa triển khai, nhưng không là nguồn sự thật cho hợp đồng thiết kế API, kiểm thử endpoint hồi quy, giả lập thực tế, tài liệu xuất bản.

Khoảng trống này là Apidog lấp đầy.

Kiến trúc đề xuất

Dùng Claude Code hoặc OpenClaw để triển khai/tái cấu trúc dịch vụ.
Định nghĩa API & workflow schema-first trong Apidog.
Chạy kịch bản kiểm thử hồi quy, xác nhận endpoint trong Apidog.
Xuất bản, duy trì tài liệu API từ Apidog.
Dùng môi trường/giả lập Apidog để ổn định công việc frontend & QA.

Ví dụ: Vòng lặp xác thực Agent + Apidog

# Mã dịch vụ được tạo/tinh chỉnh bởi agent code
npm run dev

# Sau đó trong Apidog:
# 1) nhập OpenAPI hoặc bộ sưu tập
# 2) cấu hình môi trường, biến xác thực
# 3) tạo xác nhận kịch bản thành công/thất bại
# 4) lưu thành bộ hồi quy có thể tái sử dụng

Ví dụ Payload cho kịch bản hồi quy

{
 "request": {
   "method": "POST",
   "url": "/v1/invoices",
   "body": {
     "customerId": "cus_1001",
     "amount": 1499,
     "currency": "USD"
   }
 },
 "expect": {
   "status": 201,
   "json": {
     "id": "string",
     "customerId": "cus_1001",
     "currency": "USD",
     "amount": 1499
   }
 }
}

Đây là nơi các nhóm giảm thiểu hồi quy: tốc độ agent + xác thực Apidog > chỉ dùng agent.

Phần 6: Khung quyết định theo hồ sơ nhóm

Chọn Claude Code khi

Nút thắt là tốc độ developer trong codebase.
Nhóm làm việc full terminal/IDE.
Cần tín hiệu cao từ UX code & hook policy.
Không cần agent đa kênh.

Chọn OpenClaw khi

Cần assistant chạy đa kênh chat & vận hành.
Cần đa nhà cung cấp model.
Cần policy gateway & routing rõ ràng.
Sẵn sàng chấp nhận phức tạp vận hành.

Dùng cả hai khi

OpenClaw làm điều phối/kiểm soát, Claude Code chuyên gia code.
Đủ trưởng thành để quản lý ranh giới governance rõ ràng.
Phân chia vai trò tool minh bạch.

Luôn kết hợp với Apidog khi

Sản phẩm dựa vào API, không chỉ script nội bộ.
Cần tự tin về hợp đồng, regression, tài liệu chất lượng.
Các bên liên quan backend, QA, frontend, docs cùng làm việc trên workspace API.

Phần 7: Kế hoạch thí điểm 30 ngày (Khuyến nghị)

Đừng chọn theo ý kiến. Hãy thử triển khai đo lường thực tế.

Đo: Thời gian chu kỳ PR, lỗi API phát sinh, tỷ lệ vượt kiểm thử hồi quy, vi phạm policy.
Kiểm tra trên 1 API nặng CRUD và 1 API tích hợp.
Thêm endpoint, refactor module, sửa bug giống production, thêm regression test.
Đo thời gian setup, điều chỉnh policy, giải quyết sự cố.

Các bước:

Xác định chỉ số trước khi thử nghiệm.
Chọn 2 dịch vụ đại diện.
Chạy gói task giống nhau trên từng setup candidate.
Giữ kiểm thử API cố định trong Apidog cho cả hai công cụ.
So sánh chi phí vận hành.
Review phát hiện cùng kỹ thuật & bảo mật.

Quyết định dựa trên số liệu, không hype.

Phần 8: Kế hoạch triển khai theo loại nhóm

Nếu triển khai thực tế, dùng các kế hoạch sau:

Kế hoạch A: Nhóm API khởi nghiệp (5-12 kỹ sư)

Chỉ chọn 1 agent code trong 60 ngày đầu.
Chuẩn hóa policy review code, an toàn lệnh từ đầu.
Giữ công việc hợp đồng API & regression trong Apidog.
Đánh giá chỉ số hàng tuần: thời gian thực hiện, rollback, tỷ lệ pass kiểm thử API.

Hiệu quả:

Tránh phân tán tool, vẫn tự động hóa mạnh.
Duy trì chất lượng API ổn định dù prompt code thay đổi.

Kế hoạch B: Nhóm đa sản phẩm cỡ trung

Claude Code cho team chuyên sâu repo.
OpenClaw cho team cần hoạt động kênh.
Một không gian Apidog chung cho mọi sản phẩm.
Mỗi nhóm phải xuất bản release note endpoint kèm bằng chứng kiểm thử Apidog.

Hiệu quả:

Mỗi nhóm có tool phù hợp, không áp đặt 1 mode duy nhất.
Apidog là lớp kiểm soát chất lượng trên các setup agent.

Kế hoạch C: Nhóm Nền tảng hoặc DevEx

OpenClaw nếu cần điều phối agent đa kênh/hệ thống.
Claude Code sẵn có cho task codebase, refactor.
Định nghĩa boundary tin cậy, rule phê duyệt trước khi rollout rộng.
Apidog thực thi kiểm thử hành vi API nhất quán trước deploy.

Hiệu quả:

Tách biệt mối quan tâm điều phối vs code depth.
Giảm thiểu sự cố xuyên team do automation scope không rõ.

Kết luận

Claude Code và OpenClaw đều mạnh nhưng khác biệt rõ:

Claude Code: Thực thi code thuần túy tốt hơn.
OpenClaw: Điều phối rộng, tích hợp kênh tốt hơn.
Cộng đồng xác nhận phân chia này qua thực tế sử dụng.
Đảm bảo chất lượng API, luôn kết hợp với Apidog.

Nếu muốn tốc độ phát triển API đáng tin cậy, chọn agent/điều phối theo workflow, sau đó chuẩn hóa quản trị API trong Apidog.

nút

Câu hỏi thường gặp (FAQ)

Đây có phải là so sánh một đối một?

Không hẳn. Có chồng lấn, nhưng trọng tâm khác nhau: Claude Code tập trung viết mã, OpenClaw tập trung điều phối.

OpenClaw có thể thay thế hoàn toàn Claude Code không?

Tùy nhu cầu code chuyên sâu. OpenClaw xử lý automation rộng, nhưng Claude Code vẫn mạnh cho vòng lặp code hàng ngày.

Claude Code có thay OpenClaw cho workflow điều khiển kênh không?

Nếu hoạt động kênh là trọng tâm, OpenClaw phù hợp tự nhiên hơn do tích hợp kênh là cốt lõi.

Tại sao dùng tín hiệu cộng đồng trong so sánh kỹ thuật?

Vì hành vi thực tế xuất hiện qua báo cáo người dùng trước khi có case study chính thức. Tín hiệu cộng đồng giúp nhận diện phạm vi, lỗi và friction thực tế.

Apidog có trùng lặp với công cụ nào không?

Apidog bổ sung cho cả hai. Không cạnh tranh tạo mã với agent code, mà giải quyết kiểm soát, cộng tác vòng đời API.

Cách an toàn nhất để bắt đầu?

Bắt đầu hẹp: giới hạn scope, phê duyệt rõ ràng, kiểm thử có thể đo lường, xác thực API bằng Apidog trước khi tự động hóa rộng.