#Hình ảnh

GetRouter cung cấp các endpoint riêng cho việc tạo và chỉnh sửa hình ảnh.

POST https://getrouter.ai/v1/images/generations
POST https://getrouter.ai/v1/images/edits

Chọn một model hình ảnh trên trang Model, đồng thời xem giá và các tùy chọn được hỗ trợ trước khi gửi yêu cầu.

#Tạo hình ảnh

curl https://getrouter.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "A minimal black-and-white illustration of an API router",
    "n": 1,
    "size": "1024x1024",
    "response_format": "url"
  }'

Phản hồi chứa một mảng data. Tùy theo yêu cầu và model, mỗi mục có thể chứa URL lưu trữ trên máy chủ hoặc dữ liệu hình ảnh mã hóa Base64.

#Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://getrouter.ai/v1",
)

response = client.images.generate(
    model="MODEL_ID",
    prompt="A minimal black-and-white illustration of an API router",
    size="1024x1024",
    n=1,
)

print(response.data[0].url or response.data[0].b64_json)

#Chỉnh sửa hình ảnh

Yêu cầu chỉnh sửa hình ảnh sử dụng dữ liệu biểu mẫu multipart:

curl https://getrouter.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=Replace the background with a clean studio wall" \
  -F "[email protected]" \
  -F "n=1"

Model tương thích cũng có thể chấp nhận mặt nạ và các trường bổ sung dành riêng cho model.

#Các trường thường dùng

API cũng hỗ trợ nội dung yêu cầu hình ảnh dành riêng cho nhà cung cấp đối với một số model. Khi model yêu cầu cấu trúc nội dung khác, hãy dùng lược đồ và ví dụ trong Tài liệu tham chiếu API.

#Xử lý đầu ra an toàn

• Tải xuống nội dung từ các URL được lưu trữ trước khi chúng hết hạn.
• Giải mã b64_json trước khi ghi vào tệp.
• Xác thực kiểu MIME đầu ra trong các ứng dụng phân phối tệp được tạo.
• Tránh thử lại một lần tạo đã thành công chỉ vì client không lưu được phản hồi.

#Bước tiếp theo

• Duyệt model hình ảnh
• Xem giá
• Mở Tài liệu tham chiếu API