Trung Tâm Tài Liệu API

Cổng Dịch Vụ: LLM OpenAI-Compatible, Tạo Ảnh AI HD, Tạo Video Veo 3.1, Google OAuth, Email & SMS OTP

Trang Chủ Dashboard Token
Hiển thị 6/6 danh mục

1. LLM API (Chuẩn OpenAI /v1/chat/completions)

Hỗ trợ các Model Google Gemini 3.8 Flash tốc độ cao. Tính cước linh hoạt theo Lúa / request và Lúa / 1M token.

OpenAI Compatible
GET /v1/models Public

Lấy danh sách các Model AI đang sẵn sàng phục vụ.

curl https://api.haiphongdeveloper.com/v1/models
POST /v1/chat/completions Token Bearer

Gọi suy luận LLM (hỗ trợ cả streaming `stream: true` và non-streaming). Tự động khấu trừ ví Lúa theo Request + Tokens.

curl -X POST https://api.haiphongdeveloper.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ag/gemini-3.8-flash-tiered",
    "messages": [
      {"role": "user", "content": "Xin chào, hãy giới thiệu bản thân"}
    ],
    "stream": false
  }'
Các Model tiêu biểu:
  • ag/gemini-3.8-flash-tiered: Gemini 3.8 Flash tốc độ cao nhất (5.87s/task).
  • ag/gemini-3.8-flash-high: Gemini 3.8 Flash chế độ suy luận mở rộng (Thinking sâu).
  • ken-ai-helper: Trợ lý lập trình mặc định hệ thống.
GET /v1/pricing Public

Tra cứu bảng giá cước Lúa / Request và Lúa / 1M token hiện tại của hệ thống.

curl https://api.haiphongdeveloper.com/v1/pricing

2. AI Image Generation API (Tạo Ảnh AI Chuẩn HD 8K)

Hỗ trợ Text-to-Image (T2I) và Image-to-Image (I2I kết hợp nhiều ảnh nguồn, giữ khuôn mặt & trang phục). Tự động dịch và tối ưu Prompt tiếng Việt. Cơ chế Auto-refund 100% khi lỗi.

Image Engine V2
POST /api/v1/image/generate (hoặc /v1/images/generations) Token Bearer

Sinh ảnh AI chất lượng cao từ câu lệnh prompt hoặc kết hợp ảnh tham chiếu. Chi phí: 0.08 Lúa (~80đ) / ảnh HD.

Các tham số Request Body (JSON):
• prompt (string, bắt buộc nếu không có ảnh): Mô tả nội dung ảnh bằng tiếng Việt hoặc tiếng Anh (AI tự động dịch và thêm chi tiết thẩm mỹ).
• type (string, mặc định "normal"): "hd" (ảnh siêu thực 8K - 0.08 Lúa) hoặc "normal".
• size (string, mặc định "1024x1024"): Tỉ lệ ảnh: "1024x1024" (1:1), "1024x1792" (9:16), "1792x1024" (16:9).
• input_images (array, tùy chọn): Danh sách URL ảnh công khai hoặc chuỗi Base64 (data:image/...) để khóa mặt hoặc kết hợp trang phục (Multi-image I2I).
Ví dụ 1: Tạo ảnh từ câu lệnh tiếng Việt (Text-to-Image)
curl -X POST https://api.haiphongdeveloper.com/api/v1/image/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Chân dung một nữ doanh nhân Việt Nam thanh lịch, mặc áo dài trắng, đứng tại sảnh văn phòng hiện đại ánh sáng tự nhiên",
    "type": "hd",
    "size": "1024x1024"
  }'
Ví dụ 2: Kết hợp ảnh mẫu & Giữ khuôn mặt thật (Image-to-Image)
curl -X POST https://api.haiphongdeveloper.com/api/v1/image/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Hai người đồng nghiệp đứng cạnh nhau mỉm cười tự nhiên trong phòng họp công nghệ cao",
    "type": "hd",
    "size": "1024x1024",
    "input_images": [
      "https://example.com/face_nhanvien_a.jpg",
      "https://example.com/face_nhanvien_b.jpg"
    ]
  }'
Cấu trúc phản hồi (200 OK):
{
  "status": "success",
  "data": {
    "image_url": "https://api.haiphongdeveloper.com/ai_1788830912_x8k.jpg",
    "prompt": "Chân dung một nữ doanh nhân Việt Nam...",
    "type": "hd",
    "model_used": "ken-image-hd",
    "quota": {
      "remaining": 150,
      "balance_lua": 97.42
    }
  }
}
GET /api/client/image/info

Kiểm tra hạn mức Quota và trạng thái dịch vụ Tạo ảnh của Token.

curl -H "Authorization: Bearer YOUR_API_TOKEN" https://api.haiphongdeveloper.com/api/client/image/info
GET /api/client/image/logs

Truy xuất lịch sử các lần sinh ảnh, đường dẫn ảnh đã tạo và trạng thái.

curl -H "Authorization: Bearer YOUR_API_TOKEN" "https://api.haiphongdeveloper.com/api/client/image/logs?limit=10"

3. AI Video Generation API (Tạo Video AI Google Veo 3.1)

Hỗ trợ Text-to-Video (T2V), Image-to-Video (I2V) và Khóa diện mạo nhân vật phân cảnh liên hoàn (Sequential Last-Frame Chaining). Lưu trữ video vĩnh viễn và tự động hoàn Lúa khi lỗi.

Mở Studio Trực Quan Veo 3.1 Engine
POST /api/v1/video/generate (hoặc /v1/videos/generations) Token Bearer

Sinh video điện ảnh sắc nét với âm thanh tự nhiên (Native Audio). Chi phí: 0.5 Lúa (~500đ) / video Fast (4-8s) hoặc 1.0 Lúa (~1.000đ) / video Quality.

Các tham số Request Body (JSON):
• prompt (string, bắt buộc nếu không có ảnh): Mô tả kịch bản/chuyển động của cảnh quay video.
• type (string, mặc định "fast"): "fast" (Veo 3.1 Fast - 0.5 Lúa) hoặc "quality" (Veo 3.1 Quality HD - 1.0 Lúa).
• duration (number, mặc định 8): Thời lượng clip: 8 giây hoặc 4 giây.
• aspect_ratio (string, mặc định "16:9"): Tỷ lệ video: "16:9" (ngang điện ảnh/YouTube), "9:16" (dọc TikTok/Reels), "1:1" (vuông).
• image (string, tùy chọn): URL ảnh hoặc chuỗi Base64 (data:image/jpeg;base64,...) để tạo video từ ảnh (I2V) hoặc nối tiếp frame cuối của clip trước.
Ví dụ: Tạo video 8 giây tỷ lệ 16:9
curl -X POST https://api.haiphongdeveloper.com/api/v1/video/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Cinematic shot of a luxury electric car cruising along a coastal road at sunset, 4k",
    "type": "fast",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'
Phản hồi mẫu thành công:
{
  "status": "success",
  "data": {
    "video_url": "https://api.haiphongdeveloper.com/uploads/videos/video_1788948592_abc.mp4",
    "cdn_url": "https://flow-content.google/video/...",
    "prompt": "Cinematic shot of a luxury electric car...",
    "type": "fast",
    "duration": 8,
    "aspect_ratio": "16:9",
    "model_used": "ken-video",
    "cost_lua": 0.5
  }
}
GET /api/client/video/info

Kiểm tra số dư Ví Lúa, bảng giá và quyền tạo video của Token.

curl -H "Authorization: Bearer YOUR_API_TOKEN" https://api.haiphongdeveloper.com/api/client/video/info
GET /api/client/video/logs

Xem lịch sử các video đã tạo, đường dẫn MP4 và chi tiết trạng thái.

curl -H "Authorization: Bearer YOUR_API_TOKEN" "https://api.haiphongdeveloper.com/api/client/video/logs?limit=10"

4. Google Antigravity OAuth (Tự Động Nạp Tài Khoản)

Cho phép khách hàng 1-chạm đăng nhập Google để tự động nạp tài khoản vào pool 9Router.

Xem Demo UI
GET /api/v1/antigravity/auth-url

Sinh URL đăng nhập Google bằng Client ID nội bộ của Antigravity.

curl https://api.haiphongdeveloper.com/api/v1/antigravity/auth-url
POST /api/v1/antigravity/connect

Nạp link callback hoặc code để kích hoạt tài khoản vào 9Router.

curl -X POST https://api.haiphongdeveloper.com/api/v1/antigravity/connect \
  -H "Content-Type: application/json" \
  -d '{"callbackUrl": "http://localhost:8080/callback?code=4/0A..."}'

5. Email Doanh Nghiệp Tạm Thời

Tạo hòm thư tự nhiên theo domain riêng được cấp phép và tự động bắt mã OTP kích hoạt trong vài giây.

POST /api (Tạo Email Ngẫu Nhiên) Token 
curl -X POST https://api.haiphongdeveloper.com/api \
  -H "Content-Type: application/json" \
  -d '{"token": "YOUR_API_TOKEN"}'
POST /api/read_email (Đọc Thư & Bắt OTP) Token 
curl -X POST https://api.haiphongdeveloper.com/api/read_email \
  -H "Content-Type: application/json" \
  -d '{
    "token": "YOUR_API_TOKEN",
    "email": "[email protected]",
    "timeout": 30
  }'

6. Thuê SIM & Nhận Mã OTP Tự Động

Lấy số điện thoại và tự động đọc mã SMS từ hàng trăm dịch vụ (Telegram, Facebook, Google, Shopee...). Cước phí: 2.0 Lúa / mã.

GET /api/sms/request/getv2 (Tạo Đơn Thuê SIM) Token Bearer

Khởi tạo đơn thuê số cho dịch vụ (serviceId) và nhà mạng (network: viettel, vinaphone, mobifone...).

curl -H "Authorization: Bearer YOUR_API_TOKEN" "https://api.haiphongdeveloper.com/api/sms/request/getv2?serviceId=1&network=viettel"
GET /api/sms/session/getv2 (Lấy Mã OTP Trả Về) Token Bearer

Truy vấn mã xác nhận SMS gửi về cho đơn thuê theo requestId.

curl -H "Authorization: Bearer YOUR_API_TOKEN" "https://api.haiphongdeveloper.com/api/sms/session/getv2?requestId=123456"