Tạo ảnh qua API

Tạo và bảo vệ API key

Mở Tài khoản, sau đó chọn API key. Mỗi tài khoản có một key đang hoạt động. Tạo lại sẽ vô hiệu token cũ ngay lập tức nhưng giữ thống kê sử dụng.

Chỉ gửi token trong header Authorization.
Không đặt API key trong mã chạy trên trình duyệt, ảnh chụp màn hình hoặc repository công khai.

Gửi yêu cầu tạo ảnh

Dùng JSON cho yêu cầu chỉ có prompt hoặc multipart form data khi có ảnh tham chiếu. API chỉ nhận yêu cầu qua subdomain API. Prompt là bắt buộc và tối đa 2.000 ký tự.

POST /api/ai/images tạo ảnh riêng tư.
POST /api/ai/images/publish tạo và publish kết quả.
Request API ảnh chạy đồng bộ. Request đồng thời dùng chung giới hạn tài khoản và HTTP 409 không tốn quota.

Xem quota và log yêu cầu

Quota API tách biệt với quota web hằng ngày. Chỉ trừ một quota sau khi tạo ảnh thành công. Lỗi validation, kiểm duyệt, quota và provider không bị trừ.

Dùng log yêu cầu gần nhất để chẩn đoán status code và thời gian xử lý.
Tạo lại token không đặt lại quota hoặc log.

Xử lý lỗi theo status code

Xem 401 là key không hợp lệ, 403 là tài khoản bị khóa, 422 là dữ liệu sai hoặc bị từ chối, 429 là hết quota và 503 là lỗi kiểm duyệt tạm thời.

Không thử lại 401, 403, 422 hoặc 429 khi chưa sửa nguyên nhân.
Dùng số lần thử giới hạn và backoff cho lỗi 503 hoặc lỗi mạng tạm thời.

curl -X POST https://api.genanh.com/api/ai/images \ -H "Authorization: Bearer genanh_xxx" \ -F "prompt=A cinematic product photo with soft studio lighting" \ -F "model=cx/gpt-5.5-image" \ -F "images[]=@/path/to/reference.jpg"

Tạo ảnh qua API

Ví dụ cURL hoàn chỉnh