TokenLab

Hình ảnh

Create Image Variation

Tạo một biến thể từ một hình ảnh cho trước

POST
/v1/images/variations

Tổng quan

Endpoint này hỗ trợ các client OpenAI Variations hiện có. Đối với các tính năng image-to-image mới, hãy sử dụng /v1/images/edits hoặc /v1/images/generations với mô hình image-to-image hiện tại. Các yêu cầu sử dụng multipart/form-data.

Phần thân yêu cầu (Request Body)

Endpoint này hoạt động đồng bộ: phản hồi trả về hình ảnh cuối cùng và không bao giờ trả về task. Hãy đặt timeout cho HTTP client của bạn tối thiểu là 120s.

imagefilebắt buộc

Hình ảnh nguồn dạng multipart. Tệp và toàn bộ request body phải có dung lượng dưới 50 MiB (tải lên lớn hơn sẽ trả về lỗi 413). Định dạng và kích thước được hỗ trợ tùy thuộc vào mô hình đã chọn. Chỉ mô hình có thông tin chi tiết ánh xạ image-to-image tới /v1/images/variations mới được chấp nhận; bất kỳ mô hình nào khác sẽ trả về lỗi 400.

modelstringbắt buộc

ID của mô hình. Endpoint này không có mô hình mặc định. Các ví dụ sử dụng placeholder your-legacy-variation-model: hãy thay thế bằng mô hình có thông tin chi tiết liệt kê endpoint này.

nintegermặc định: 1

Số lượng hình ảnh cần tạo (1-10, tùy thuộc vào mô hình).

sizestring

Kích thước hình ảnh được tạo. Các giá trị được hỗ trợ tùy thuộc vào mô hình đã chọn.

response_formatstring

Định dạng trả về của các hình ảnh được tạo. Phải là url hoặc b64_json.

userstring

Mã định danh duy nhất đại diện cho người dùng cuối của bạn nhằm mục đích giám sát lạm dụng.

Phản hồi

createdinteger

Unix timestamp thời điểm hình ảnh được tạo.

dataarray

Mảng chứa các biến thể hình ảnh được tạo.

Mỗi đối tượng bao gồm:

  • url (string): URL của hình ảnh biến thể (nếu response_format là url)
  • b64_json (string): Hình ảnh được mã hóa Base64 (nếu response_format là b64_json)

Yêu cầu

curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-legacy-variation-model" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

Phản hồi

Response
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

Lưu ý

Đây là endpoint tương thích kế thừa. Nó không có trong danh mục mô hình hình ảnh được đề xuất hiện tại. Đối với các tích hợp mới, hãy sử dụng /v1/images/edits với gpt-image-2, hoặc /v1/images/generations với operation: "image-to-image" và một mô hình image-to-image hiện tại.

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Header

X-TokenLab-Delivery-Policy?string

Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.

Giá trị hợp lệ

  • "auto"
  • "verified"
  • "official"

Nội dung yêu cầu

multipart/form-data

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json