Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Tổng quan

Tạo biến thể của một hình ảnh cho trước. Yêu cầu content type multipart/form-data.

​
Nội dung yêu cầu

Timeout cho yêu cầu đồng bộ: một số nhà cung cấp hình ảnh được định tuyến sẽ trả ảnh cuối cùng inline và chờ quá trình tạo hoàn tất. Yêu cầu độ phân giải cao hoặc chất lượng cao có thể mất gần một phút hoặc lâu hơn, vì vậy hãy đặt timeout của HTTP client ít nhất là 120s. Nếu phản hồi tạo có status: "pending", task_id, hoặc poll_url, hãy theo poll_url được trả về để polling.
​
image
file
bắt buộc
Hình ảnh dùng làm cơ sở cho biến thể. Phải là file PNG hợp lệ, nhỏ hơn 50MB và có tỷ lệ vuông.
​
model
string
mặc định:"dall-e-2"
Mô hình sử dụng cho biến thể hình ảnh. Hiện tại chỉ hỗ trợ dall-e-2.
​
n
integer
mặc định:"1"
Số lượng hình ảnh cần tạo. Phải từ 1 đến 10.
​
size
string
Kích thước của hình ảnh được tạo. Phải là một trong 256x256, 512x512, hoặc 1024x1024.
​
response_format
string
mặc định:"url"
Định dạng trả về của hình ảnh được tạo. Phải là url hoặc b64_json.
​
user
string
Mã định danh duy nhất đại diện cho người dùng cuối để giám sát lạm dụng.

​
Phản hồi

​
created
integer
Dấu thời gian Unix khi hình ảnh được tạo.
​
data
array
Mảng các biến thể hình ảnh đã tạo.Mỗi đối tượng chứa:
  • url (string): URL của hình ảnh biến thể (nếu response_format là url)
  • b64_json (string): Hình ảnh mã hóa Base64 (nếu response_format là b64_json)
curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

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

​
Ghi chú

Biến thể hình ảnh chỉ khả dụng với DALL-E 2. Mô hình sẽ tạo ra các hình ảnh mới có phong cách và nội dung tương tự với hình ảnh gốc.