AI Image Generate

API AI Image Generate

Tổng quan

Endpoint tạo ảnh theo cơ chế bất đồng bộ:

1. Gọi API tạo ảnh để lấy job_id
2. Chờ khoảng 45 giây - 1 phút
3. Kiểm tra trạng thái job theo job_id
4. Khi status = completed, lấy link ảnh trong result

Hướng dẫn & bảng giá

• Xem dashboard, hướng dẫn sử dụng và bảng giá mới nhất tại: app.revidapi.com

---

Xác thực

Tất cả request yêu cầu Bearer token:

Authorization: Bearer sk_live_your_key

---

Bảng model tạo ảnh

Model	Mô tả ngắn
nano-banana	Bản tiêu chuẩn
nano-banana-pro	Bản chất lượng cao
nano-banana-fast	Bản ưu tiên tốc độ
nano-banana-pro-fast	Bản pro nhanh
imagen-4.0	Imagen thế hệ mới
imagen-4	Imagen v4
imagen-4-fast	Imagen v4 bản nhanh
imagen-4-ultra	Imagen chất lượng cao
flux-2-pro	Flux 2 Pro
seedream-4.5	Seedream 4.5
kling-01-image	Kling image
chatgpt-image	GPT image
nano-banana-2	Nano Banana 2
grok-image	Grok image

Dùng đúng tên model theo danh sách tài khoản của bạn.

---

1) Tạo Job Ảnh

• Method: POST
• URL: https://ai.revidapi.com/v1/image/generate
• Content-Type: multipart/form-data

Tham số form-data

Tên	Kiểu	Bắt buộc	Mô tả
prompt	string	Có	Mô tả ảnh cần tạo
model	string	Có	ID model
resolution	string	Không	Ví dụ: 1k, 2k, 4k
aspect_ratio	string	Không	Ví dụ: 1:1, 16:9, 9:16
speed	string	Không	Ví dụ: fast, slow
input_image	file	Không	Ảnh đầu vào cho image-to-image
img_url	string	Không	URL ảnh thay cho input_image
server_id	string	Không	Server tier nếu cần

Curl mẫu tối thiểu

curl -X POST https://ai.revidapi.com/v1/image/generate \
  -H "Authorization: Bearer sk_live_your_key" \
  -F "prompt=A futuristic city" \
  -F "model=nano-banana"

Curl mẫu đầy đủ

curl -X POST https://ai.revidapi.com/v1/image/generate \
  -H "Authorization: Bearer sk_live_your_key" \
  -F "prompt=A cinematic shot..." \
  -F "model=nano-banana-pro" \
  -F "resolution=1k" \
  -F "aspect_ratio=16:9" \
  -F "speed=fast"

Kết quả trả về

{
  "job_id": "job_abc123"
}

---

2) Kiểm tra trạng thái Job

• Method: GET
• URL: https://ai.revidapi.com/v1/jobs/{job_id}

Curl mẫu

curl -X GET "https://ai.revidapi.com/v1/jobs/job_abc123" \
  -H "Authorization: Bearer sk_live_your_key"

Đang xử lý

{
  "status": "processing",
  "result": null
}

Hoàn thành

{
  "status": "completed",
  "result": "https://storage.googleapis.com/.../image.png"
}

---

Mã lỗi

Code	Lỗi	Mô tả
400	Bad Request	Thiếu tham số hoặc payload/file không hợp lệ.
401	Unauthorized	Thiếu hoặc sai API key.
402	Insufficient Funds	Không đủ credits trong tài khoản.
403	Forbidden	API key không có quyền truy cập tài nguyên này.
404	Not Found	Job/tài nguyên không tồn tại.
429	Too Many Requests	Vượt giới hạn tốc độ (1000 req/phút).
500	Internal Server Error	Lỗi server nội bộ.
503	Service Unavailable	Nhà cung cấp model đang quá tải hoặc bảo trì.