Thư Viện API Tạo Ảnh & Video AI — Hướng Dẫn RevidAPI AI Studio

Thư viện API RevidAPI gồm những gì?

RevidAPI AI Studio tách rõ hai nhóm API chính: Image Generation API (text-to-image, image-to-image, inpainting, upscale) và Video Generation API (text-to-video, image-to-video, motion control, lipsync). Mỗi nhóm có danh sách model riêng, tham số riêng và mức credit khác nhau — nhưng cùng một authentication header và cùng pattern POST job → GET status.

Trên giao diện web tại app.revidapi.com/docs, bạn thấy explorer liệt kê từng endpoint: POST /v1/image/generate, POST /v1/video/generate, POST /v1/motion-control, GET /v1/jobs/{job_id}. Đây chính là “thư viện API” mà video hướng dẫn trên YouTube demo — không phải tài liệu lý thuyết mà là bộ endpoint sẵn sàng copy-paste vào Postman, n8n hoặc backend Python/Node.

Điểm khác biệt so với marketplace API đa năng: RevidAPI tối ưu cho creator economy Việt Nam — vertical 9:16, prompt tiếng Việt, billing VND/USD linh hoạt, và tích hợp sẵn Lipsync, Vietsub trong cùng hệ sinh thái.

Chuẩn bị: API Key và môi trường

Bước 1: Đăng ký tại revidapi.com/login và tạo API Key trong Dashboard. Key dùng cho cả AI Studio REST API lẫn các dịch vụ download media — nhưng billing AI Studio tách biệt credit app.revidapi.com.

Bước 2: Lưu key vào biến môi trường REVIDAPI_KEY. Không commit key lên Git. Với production, dùng secret manager (AWS Secrets Manager, Vault, hoặc GitHub Actions secrets).

Bước 3: Base URL production: https://app.revidapi.com/api (tham chiếu docs mới nhất). Mọi request cần header Authorization: Bearer YOUR_KEY và Content-Type: application/json.

API tạo ảnh — Text to Image với Flux

Text-to-image là entry point phổ biến nhất. Agency dùng để tạo thumbnail YouTube, mockup sản phẩm, key visual campaign. Model Flux Dev/Pro cho chất lượng cao; Nano Banana cho tốc độ và chi phí thấp.

curl -X POST "https://app.revidapi.com/api/v1/image/generate" \
  -H "Authorization: Bearer $REVIDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-dev",
    "prompt": "Minimal product photo, white sneaker on marble, soft studio light, 4K",
    "width": 1024,
    "height": 1024,
    "num_images": 1
  }'

Response trả về job_id. Poll GET /v1/jobs/{job_id} mỗi 2–5 giây đến khi status: completed. URL ảnh nằm trong result.outputs[0].url.

Mẹo SEO content: luôn ghi rõ model, aspect ratio và prompt template trong tài liệu nội bộ — giúp team reproduce kết quả và giảm credit lãng phí.

API tạo video — Text/Image to Video

Nhóm video API hỗ trợ Kling 2.5/2.6/3.0, Veo 3, Seedance 2.0. Tham số quan trọng: duration (5s/10s), aspect_ratio (9:16 cho TikTok/Reels), image_url khi chạy image-to-video.

Workflow điển hình: (1) gọi image API tạo keyframe → (2) gọi video API animate → (3) optional lipsync hoặc dubbing. RevidAPI cho phép chain trong Workflow AI Studio hoặc n8n mà không cần code.

curl -X POST "https://app.revidapi.com/api/v1/video/generate" \
  -H "Authorization: Bearer $REVIDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-2.5",
    "prompt": "Fashion model walks runway, cinematic lighting, slow motion",
    "aspect_ratio": "9:16",
    "duration": 5
  }'

Bảng so sánh endpoint theo use case

Polling, lỗi thường gặp và best practice

429 Rate limit: backoff exponential, queue job phía client. 402 Insufficient credit: nạp tại app.revidapi.com/pricing. 422 Invalid model: kiểm tra tên model trong docs — model deprecated được announce trên changelog.

Nên log mọi job_id, lưu prompt và phiên bản model, đo credit theo từng campaign — RevidAPI có usage dashboard để báo cáo ROI cho khách hàng.

Tích hợp MCP/CLI: ngoài REST, RevidAPI hỗ trợ agent workflow qua MCP — phù hợp AI coding assistant tự gọi API tạo asset. Xem thêm hướng dẫn n8n automation.

Kết luận

Thư viện API tạo ảnh và video RevidAPI là lớp kết nối giữa model AI đa dạng và pipeline sản xuất nội dung thực tế của bạn. Bắt đầu từ một endpoint, mở rộng dần sang batch, workflow và multi-channel publish — tất cả với một API Key và billing rõ ràng.