Mô hình hình ảnh
Tạo và chỉnh sửa hình ảnh thông qua API mô hình hình ảnh của OneMux.
Giới thiệu API
Mô hình hình ảnh sử dụng API Images riêng. Không gửi yêu cầu tạo hình ảnh đến /v1/chat/completions.
- Tạo hình ảnh:
POST https://api.onemux.net/v1/images/generations - Chỉnh sửa hình ảnh:
POST https://api.onemux.net/v1/images/edits - Xác thực:
Authorization: Bearer YOUR_API_KEY - Mô hình: Sử dụng ID mô hình hình ảnh thực tế do API danh sách mô hình hiện tại trả về
Trước tiên, lấy danh sách mô hình hiện có:
curl https://api.onemux.net/v1/models \
-H "Authorization: Bearer $ONEMUX_API_KEY"
Việc mô hình hình ảnh có hỗ trợ tạo, chỉnh sửa, ảnh tham chiếu, kích thước, chất lượng, định dạng đầu ra và các tham số khác hay không phụ thuộc vào danh sách mô hình và khả năng thực tế của nhà cung cấp thượng nguồn.
Tạo hình ảnh
Dùng /v1/images/generations để gửi yêu cầu tạo hình ảnh từ văn bản.
curl https://api.onemux.net/v1/images/generations \
-H "Authorization: Bearer $ONEMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "一只坐在窗边的橘猫,午后自然光,写实摄影风格",
"size": "1024x1024",
"quality": "medium"
}'
Các tham số thường dùng:
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
model | Có | ID mô hình hình ảnh hiện có |
prompt | Có | Mô tả nội dung hình ảnh |
size | Không | Kích thước hình ảnh; phạm vi hỗ trợ tùy thuộc vào mô hình |
quality | Không | Chất lượng hình ảnh; các giá trị được hỗ trợ tùy thuộc vào mô hình |
n | Không | Số lượng hình ảnh tạo ra; phạm vi hỗ trợ tùy thuộc vào mô hình |
response_format | Không | b64_json hoặc url; chỉ dùng được với các mô hình hỗ trợ |
background | Không | Nền trong suốt hoặc không trong suốt; chỉ dùng được với các mô hình hỗ trợ |
output_format | Không | png, jpeg, webp; chỉ dùng được với các mô hình hỗ trợ |
Không áp dụng trực tiếp các tham số được một mô hình hỗ trợ cho những mô hình hình ảnh khác. Nếu gặp lỗi model_not_found, invalid_model hoặc lỗi không hỗ trợ tham số, trước tiên hãy kiểm tra ID mô hình và các khả năng của mô hình.
Chỉnh sửa hình ảnh
Dùng /v1/images/edits để chỉnh sửa hình ảnh có sẵn. Các mô hình hình ảnh tương thích với OpenAI thường dùng multipart/form-data để tải ảnh lên:
curl https://api.onemux.net/v1/images/edits \
-H "Authorization: Bearer $ONEMUX_API_KEY" \
-F "model=YOUR_IMAGE_MODEL_ID" \
-F "image[]=@input.png" \
-F "prompt=将背景改为浅蓝色,保持主体和文字不变" \
-F "size=1024x1024"
Có thể truyền nhiều ảnh tham chiếu bằng cách lặp lại image[], ví dụ:
-F "image[]=@person.png" \
-F "image[]=@product.png"
Số lượng và định dạng hình ảnh, mặt nạ, URL ảnh tham chiếu và định dạng chỉnh sửa JSON phụ thuộc vào mô hình và kênh nhà cung cấp thượng nguồn. Chỉ sử dụng các tham số này khi mô hình hỗ trợ rõ ràng.
Gọi bằng Python
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["ONEMUX_API_KEY"],
base_url="https://api.onemux.net/v1",
)
result = client.images.generate(
model="YOUR_IMAGE_MODEL_ID",
prompt="一张简洁的蓝色科技风产品海报",
size="1024x1024",
)
print(result.data[0].b64_json or result.data[0].url)
Chỉnh sửa hình ảnh thường yêu cầu gửi trực tiếp tệp multipart. Nếu phiên bản Python SDK hiện tại không hỗ trợ các tham số chỉnh sửa của mô hình mục tiêu, hãy dùng yêu cầu cURL ở trên.
Kết quả trả về
Phản hồi thành công thường chứa mảng data:
{
"created": 1760000000,
"data": [
{
"b64_json": "iVBORw0KGgo..."
}
]
}
Một số mô hình trả về địa chỉ hình ảnh khi yêu cầu đặt response_format thành url:
{
"created": 1760000000,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}
Khi trả về Base64, hãy lưu tệp theo định dạng hình ảnh thực tế. Khi trả về URL, hãy tải xuống và lưu lại kịp thời để tránh địa chỉ tạm thời hết hạn.
Thông tin tính phí
Mô hình hình ảnh không áp dụng chung một cách tính phí theo Token. OneMux tính phí theo quy tắc hiện hành được công bố cho từng mô hình; có thể bao gồm:
- Tính phí theo số lượng hình ảnh được tạo
- Tính phí theo độ phân giải hình ảnh hoặc mức chất lượng
- Tính phí theo Token đầu vào, đầu ra của hình ảnh hoặc mức sử dụng khác của nhà cung cấp thượng nguồn
Giá thực tế, đơn vị tính phí và thông số được hỗ trợ căn cứ vào thông tin hiện hành của mô hình tương ứng trong Danh mục mô hình. Yêu cầu thất bại thường không phát sinh phí hình ảnh tương ứng với kết quả thành công, nhưng hành vi cụ thể căn cứ vào thông tin hiển thị trên trang và phản hồi từ máy chủ.
Câu hỏi thường gặp
Vì sao không thể dùng API hội thoại để tạo hình ảnh?
Mô hình hình ảnh sử dụng tuyến Images riêng. Gửi yêu cầu đến /v1/chat/completions hoặc API không phù hợp khác có thể dẫn đến lỗi mô hình không hỗ trợ điểm cuối hoặc lỗi tham số.
Vì sao có thể tra cứu tên mô hình nhưng yêu cầu vẫn thất bại?
Hãy kiểm tra xem mô hình có cho phép tạo hoặc chỉnh sửa hình ảnh hay không, API Key hiện tại có quyền truy cập hay không, các tham số yêu cầu có nằm trong phạm vi mô hình hỗ trợ hay không và kênh nhà cung cấp thượng nguồn tương ứng có khả dụng hay không.
Vì sao kết quả trả về là Base64 chứ không phải liên kết hình ảnh?
Định dạng trả về phụ thuộc vào từng mô hình hoặc thiết lập response_format. Khi nhận b64_json, cần tự giải mã và lưu trong ứng dụng khách; khi nhận url, cần tải xuống từ địa chỉ được trả về.
Cần làm gì khi tạo hình ảnh mất nhiều thời gian?
Yêu cầu có độ phân giải cao, chất lượng cao hoặc chỉnh sửa phức tạp có thể mất nhiều thời gian hơn. Ứng dụng khách nên đặt thời gian chờ yêu cầu phù hợp; không gửi lại cùng một yêu cầu chỉ vì ứng dụng khách hết thời gian chờ, để tránh tạo tác vụ trùng lặp hoặc phát sinh phí.
GPT Image 2.6: SVG, GIF và độ phức tạp
Dòng GPT Image 2.6 bổ sung khả năng xuất SVG, ảnh động GIF và tham số complexity. Các khả năng này chỉ áp dụng cho những mô hình và kênh nhà cung cấp thượng nguồn có hỗ trợ.
Xuất SVG
SVG dùng để tạo hình ảnh, không dùng để chỉnh sửa hình ảnh. Khi gọi API tạo hình ảnh, đặt output_format thành svg và đặt n thành 1. Dữ liệu hình ảnh trong phản hồi ở dạng Base64; hãy giải mã rồi lưu thành tệp .svg.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一个简洁的蓝色几何图形标志",
"output_format": "svg",
"n": 1
}
Một số cấu hình nhà cung cấp thượng nguồn có thể yêu cầu thêm đối tượng svg, chẳng hạn như svg.model. Chỉ thêm đối tượng này khi tài liệu của mô hình hoặc kênh nêu rõ yêu cầu. Không phải mọi mô hình hình ảnh và kênh đều hỗ trợ SVG.
Xuất ảnh động GIF
Các mô hình GPT Image 2.6 hỗ trợ khả năng này có thể đặt output_format thành gif trong API tạo hình ảnh. Khi mô hình hỗ trợ, có thể dùng frame_count và frame_duration_ms để đặt số khung hình động và thời lượng mỗi khung hình. GIF là một khả năng tạo hình ảnh; không nên mặc định rằng API chỉnh sửa hình ảnh cũng có thể trả về GIF.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一只蓝色小鸟循环拍打翅膀的动画",
"output_format": "gif",
"frame_count": 6,
"frame_duration_ms": 200
}
Tham số độ phức tạp
Dòng GPT Image 2.6 hỗ trợ complexity: low, medium, high. Với chỉnh sửa đơn giản, có thể thử mức độ phức tạp thấp hơn; với hình ảnh nhiều chữ hoặc bố cục phức tạp, có thể thử mức cao hơn. Tham số này khác với quality; ở mức độ phức tạp cao, quá trình tạo có thể chậm hơn.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一张细节丰富的城市街景编辑插画",
"complexity": "high",
"quality": "high"
}
Các tham số trên không dùng chung cho mọi mô hình. Nếu API báo không hỗ trợ tham số, hãy bỏ các tham số tùy chọn hoặc xác nhận khả năng của mô hình và kênh đã chọn.