Sinh ảnh AI

Tạo ảnh từ prompt văn bản, biến đổi ảnh có sẵn, upscale lên độ phân giải cao. Hỗ trợ 8+ models — chọn thủ công hoặc để Smart Router tự chọn.

Endpoint

POST https://api.aigate.id.vn/v1/generate/image

Tham số đầy đủ

Tham số	Kiểu	Bắt buộc	Mô tả
`prompt`	string	Có	Mô tả ảnh muốn tạo (≤ 2.000 ký tự, hỗ trợ tiếng Việt)
`negative_prompt`	string	Không	Những gì không muốn xuất hiện
`model`	string	Không	Mặc định `auto` (xem bảng models)
`aspect_ratio`	string	Không	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `21:9`
`quality`	string	Không	`standard` (mặc định) hoặc `hd`
`style`	string	Không	`realistic`, `artistic`, `anime`, `3d`, `sketch`
`seed`	integer	Không	Tái tạo cùng kết quả (0-2147483647)
`steps`	integer	Không	Số bước denoise (4-50, mặc định 20)
`guidance`	float	Không	Mức tuân thủ prompt (1-20, mặc định 7.5)
`image`	string	Không	URL ảnh đầu vào (image-to-image)
`strength`	float	Không	Chỉ với image-to-image: 0.1-1.0 (mặc định 0.75)
`mask`	string	Không	URL ảnh mask cho inpaint (vùng đen sẽ bị thay)
`n`	integer	Không	Số ảnh sinh cùng lúc (1-4, mặc định 1)
`webhook_url`	string	Không	Nhận callback khi xong (cho job HD)

Models hỗ trợ

Model	Credits	Tốc độ	Phù hợp với
`auto`	10	~5s	Smart Router tự chọn
`flux-schnell`	8	~3s	Nhanh, chất lượng tốt, prompt tiếng Việt OK
`flux-pro`	20	~8s	Chất lượng photorealistic cao nhất
`sdxl`	10	~6s	Anime, artistic, fantasy
`sdxl-lightning`	5	~2s	Cực nhanh, chấp nhận chất lượng vừa
`dalle3`	30	~12s	Hiểu prompt phức tạp, text-in-image tốt
`imagen3`	25	~10s	Photorealistic, người & mặt
`recraft-v3`	22	~9s	Logo, illustration vector style

Ví dụ chi tiết

1. Sinh ảnh cơ bản

curl -X POST https://api.aigate.id.vn/v1/generate/image \
  -H "Authorization: Bearer aig_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "ngôi nhà mặt tiền hướng đông, ánh sáng vàng buổi sáng, phong thủy hài hòa",
    "aspect_ratio": "16:9",
    "model": "flux-pro",
    "quality": "hd"
  }'

2. Image-to-image (biến đổi ảnh có sẵn)

{
  "prompt": "đổi sang phong cách tranh thủy mặc Trung Hoa",
  "image": "https://example.com/original-house.jpg",
  "strength": 0.7,
  "model": "sdxl"
}

3. Inpaint (sửa một vùng)

{
  "prompt": "thêm một con rồng vàng cuộn quanh cây",
  "image": "https://example.com/scene.jpg",
  "mask": "https://example.com/mask.png",
  "model": "flux-pro"
}

4. Sinh nhiều ảnh cùng lúc (batch)

{
  "prompt": "logo tiệm trà phong thủy, tối giản, gradient xanh",
  "n": 4,
  "model": "recraft-v3",
  "aspect_ratio": "1:1"
}

Phản hồi sẽ chứa mảng urls:

{
  "ok": true,
  "id": "img_batch_x9k2",
  "urls": [
    "https://cdn.aigate.id.vn/img/x9k2_1.png",
    "https://cdn.aigate.id.vn/img/x9k2_2.png",
    "https://cdn.aigate.id.vn/img/x9k2_3.png",
    "https://cdn.aigate.id.vn/img/x9k2_4.png"
  ],
  "credits_used": 88
}

Upscale (nâng độ phân giải)

Endpoint riêng cho việc nâng cấp ảnh đã tạo lên 2x / 4x:

POST /v1/upscale
{
  "image": "https://cdn.aigate.id.vn/img/x9k2_1.png",
  "scale": 2,
  "face_enhance": true
}

Credits: scale 2× = 5 credits, scale 4× = 15 credits.

Mẹo viết prompt tiếng Việt hiệu quả

✓ Cụ thể về ánh sáng: "ánh sáng vàng hoàng hôn", "ánh sáng studio mềm" — model hiểu rõ ràng
✓ Đề cập style: "phong cách tranh sơn dầu", "ảnh chụp cinematic", "minh họa flat-design"
✓ Mô tả camera: "góc chụp từ thấp lên", "ống kính 35mm", "depth of field nông"
✓ Negative prompt: thêm "text, watermark, bad anatomy" để loại lỗi thường gặp
✗ Tránh prompt quá dài (>500 từ) — model có thể bỏ qua phần cuối
✗ Tránh đếm cụ thể (model thường đếm sai > 5 vật thể)

Thư viện 1.000+ assets có sẵn

Thay vì sinh mới, bạn có thể tìm trong thư viện có sẵn — chỉ tốn 1 credit cho mỗi asset:

GET /v1/library/search?q=phong+thuy+nha&type=image&limit=20

{
  "results": [
    {
      "id": "lib_a8f3",
      "url": "https://cdn.aigate.id.vn/lib/a8f3.jpg",
      "thumb": "https://cdn.aigate.id.vn/lib/a8f3_thumb.jpg",
      "tags": ["phong-thuy", "kien-truc", "nha-mat-tien"],
      "credits_to_use": 1
    }
  ],
  "total": 47
}

Tải về:

POST /v1/library/asset/lib_a8f3/use

👉 Sinh video AI — Kling, Pika, Runway, Luma

👉 Webhooks — nhận thông báo cho job HD/upscale