Tài liệu Tham chiếu API Tham chiếu SDK Sử dụng Agent Kỹ năng AI

Hình ảnh

Tạo hình ảnh

Tạo hình ảnh từ prompt văn bản. Mặc định trả về JSON đồng bộ tương thích OpenAI (dùng được với client.images.generate()); truyền stream: true để nhận luồng sự kiện SSE. Hỗ trợ image-to-image qua inputImages / input_references.

POST/api/v1/images/generations

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Body

modelbắt buộc

string

Model tạo ảnh cần dùng, có tiền tố nhà cung cấp, ví dụ "openai/gpt-image-2".

minLength: 1

Example: "openai/gpt-image-2"

promptbắt buộc

string

Mô tả văn bản của hình ảnh mong muốn.

minLength: 1

Example: "a red cat on a sofa"

n

integer

Số lượng hình ảnh cần tạo, 1–10.

1–10

Example: 1

size

string

Kích thước ảnh — pixel rõ ràng ("2048x2048") hoặc bậc ("2K", "4K"). Chuyển tiếp nguyên trạng đến nhà cung cấp; kích thước hỗ trợ tùy model.

Example: "1024x1024"

stream

boolean

Chọn dạng phản hồi: bỏ qua hoặc false = JSON đồng bộ tương thích OpenAI (mặc định), true = luồng sự kiện SSE.

input_references

string[]

Ảnh nguồn cho image-to-image (URL data: hoặc https:), tối đa 8. Bí danh của inputImages (tên trường thông dụng trong ngành); cả hai đều qua kiểm duyệt nội dung trước. Trả về 400 — không phải warning — khi tuyến model không hỗ trợ i2i.

≤ 8 images

aspect_ratio

enum<string>

Tỷ lệ khung hình của ảnh được tạo. Được hỗ trợ gốc trên một số tuyến model — kiểm tra supported_parameters trong phản hồi GET /api/v1/images/models cho từng model; tuyến không hỗ trợ sẽ bỏ qua trường này và ghi vào warnings[] của phản hồi (yêu cầu vẫn thành công).

1:11:21:41:82:12:33:23:44:14:34:55:48:19:1616:99:19.519.5:99:2020:99:2121:9auto

Example: "16:9"

resolution

enum<string>

Bậc độ phân giải; pixel cụ thể do nhà cung cấp quy đổi. Được hỗ trợ gốc trên một số tuyến model — kiểm tra supported_parameters trong phản hồi GET /api/v1/images/models cho từng model; tuyến không hỗ trợ sẽ bỏ qua trường này và ghi vào warnings[] của phản hồi (yêu cầu vẫn thành công).

5121K2K4K

Example: "2K"

quality

enum<string>

Chất lượng kết xuất. Được hỗ trợ gốc trên một số tuyến model — kiểm tra supported_parameters trong phản hồi GET /api/v1/images/models cho từng model; tuyến không hỗ trợ sẽ bỏ qua trường này và ghi vào warnings[] của phản hồi (yêu cầu vẫn thành công).

autolowmediumhigh

background

enum<string>

Xử lý nền; transparent cần output_format hỗ trợ alpha (png/webp). Được hỗ trợ gốc trên một số tuyến model — kiểm tra supported_parameters trong phản hồi GET /api/v1/images/models cho từng model; tuyến không hỗ trợ sẽ bỏ qua trường này và ghi vào warnings[] của phản hồi (yêu cầu vẫn thành công).

autotransparentopaque

output_format

enum<string>

Định dạng mã hóa của byte ảnh trả về. Được hỗ trợ gốc trên một số tuyến model — kiểm tra supported_parameters trong phản hồi GET /api/v1/images/models cho từng model; tuyến không hỗ trợ sẽ bỏ qua trường này và ghi vào warnings[] của phản hồi (yêu cầu vẫn thành công).

pngjpegwebpsvg

Example: "png"

output_compression

integer

Mức nén (0–100) cho đầu ra webp/jpeg; bỏ qua với png. Được hỗ trợ gốc trên một số tuyến model — kiểm tra supported_parameters trong phản hồi GET /api/v1/images/models cho từng model; tuyến không hỗ trợ sẽ bỏ qua trường này và ghi vào warnings[] của phản hồi (yêu cầu vẫn thành công).

0–100

Example: 100

seed

integer

Seed lấy mẫu xác định; seed + tham số giống nhau sẽ tái tạo kết quả, nhưng không phải nhà cung cấp nào cũng đảm bảo. Được hỗ trợ gốc trên một số tuyến model — kiểm tra supported_parameters trong phản hồi GET /api/v1/images/models cho từng model; tuyến không hỗ trợ sẽ bỏ qua trường này và ghi vào warnings[] của phản hồi (yêu cầu vẫn thành công).

Hướng dẫn chi tiết →

POST /api/v1/images/generations

1
2
3
4
5
6
7
8
curl https://bazaarlink.ai/api/v1/images/generations \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "a red cat on a sofa",
    "size": "1024x1024"
  }'

Ví dụ phản hồi

Thành công. Mặc định (hoặc stream: false) trả về JSON đồng bộ bên dưới; với stream: true, trả về luồng sự kiện SSE (xem hướng dẫn chi tiết). Tham số bị tuyến bỏ qua xuất hiện trong warnings[] cấp cao nhất (chỉ mang tính thông tin).

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "created": 1753500000,
  "data": [
    {
      "url": "https://bazaarlink.ai/api/v1/images/proxy/eyJhbGciOi..."
    }
  ],
  "warnings": [
    {
      "param": "aspect_ratio",
      "action": "dropped",
      "reason": "'aspect_ratio' is not yet mapped for this model's upstream and was ignored; the image was still generated using the model's default."
    }
  ]
}