Gemini 3.1 Flash Image Preview

• Mô hình: gemini-3.1-flash-image-preview (cố định)
• Tính năng: Tạo ảnh từ văn bản, tạo ảnh từ ảnh (tối đa 14 ảnh tham chiếu), lên đến 4K, tỷ lệ khung hình cực đoan, tùy chọn căn cứ tìm kiếm Google

Không gọi mô hình này qua /v1/chat/completions — bạn sẽ nhận được 400 kèm gợi ý sử dụng Images API.

Các điểm cuối

Chế độ	Điểm cuối	Khi nào sử dụng
Đồng bộ (khuyến nghị)	POST https://apimaster.ai/v1/images/generations	Một vòng HTTP; nền tảng thăm dò upstream và trả về { "data": [{ "url" }] }
Bất đồng bộ	POST https://apimaster.ai/v1/images/generations/async → GET https://apimaster.ai/v1/tasks/{task_id}?model=gemini-3.1-flash-image-preview	Các tác vụ dài, hàng đợi tùy chỉnh

Bắt đầu nhanh (đồng bộ)

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "Cyberpunk city at night, neon lights",
    "size": "16:9",
    "resolution": "2K",
    "n": 1
  }'

Thành công

{
  "created": 1782633696,
  "data": [{ "url": "https://apimaster.ai/imgs/1782633695067198543.jpg" }]
}

Đặt thời gian chờ đọc HTTP thành ≥ 180s cho 2K/4K. Tải xuống hoặc sao chép URL kịp thời — chúng sẽ hết hạn.

Luồng bất đồng bộ

Gửi

curl -s "https://apimaster.ai/v1/images/generations/async" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "a corgi astronaut on the moon",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'

Phản hồi gửi

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" }]
}

Thăm dò

curl -s "https://apimaster.ai/v1/tasks/TASK_ID?model=gemini-3.1-flash-image-preview" \
  -H "Authorization: Bearer YOUR_API_KEY"

Khi thành công, đọc data.result.images[0].url. Các trạng thái thăm dò điển hình: in_progress → succeeded / completed.

Chờ 10–20s trước lần thăm dò đầu tiên, sau đó mỗi 3–5s.

Xác thực

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Tham số body

Trường	Kiểu	Bắt buộc	Ghi chú
model	string	có	gemini-3.1-flash-image-preview
prompt	string	có	Mô tả cảnh
size	string	không	Tỷ lệ khung hình; xem bên dưới
resolution	string	không	0.5K / 1K / 2K / 4K, mặc định 1K; không phân biệt chữ hoa/thường
n	integer	không	Chỉ hỗ trợ 1 (số, không phải chuỗi)
image_urls	array	không	Ảnh tham chiếu (URL hoặc data URI)
google_search	boolean	không	Căn cứ tìm kiếm văn bản Google
google_image_search	boolean	không	Yêu cầu google_search: true

Các mức độ phân giải và thanh toán

Giá trị	~pixel	Giá so với cơ sở 1K
0.5K	~512	giống như 1K
1K	~1024	cơ sở
2K	~2048	× 4/3
4K	~4096	× 2

Phí thực tế = giá kênh × hệ số độ phân giải × tỷ lệ nhóm. Xem marketplace hoặc nhật ký console.

Lỗi

HTTP	Ý nghĩa
400	Tham số sai, hoặc điểm cuối sai (chat)
401	Khóa API không hợp lệ
402	Số dư không đủ
408	Hết thời gian thăm dò đồng bộ — thử lại bất đồng bộ hoặc giảm độ phân giải
500 / 502	Lỗi upstream hoặc nền tảng

Tỷ lệ khung hình không hợp lệ có thể xuất hiện dưới dạng 500 khi chỉ có một kênh được cấu hình.

Ghi chú

• Nhật ký sử dụng bao gồm result_url để xem trước ảnh và request_data.effective_resolution.
• Giá cả thay đổi theo kênh và độ phân giải — xem marketplace.