Tạo hình ảnh
Phản hồi JSON đồng bộ chứa kết quả hình ảnh trong dữ liệu.
Trên trang này
https://api.shareai.now/api/v1/imagesTạo hình ảnh
- URL cơ sở
https://api.shareai.now- Xác thực
- Khóa API Bearer hoặc token truy cập OAuth đã được phê duyệt
- Phạm vi yêu cầu
inferenceormonetization_gateway
Phản hồi JSON đồng bộ chứa kết quả hình ảnh trong data. Bí danh /api/v1/images/generations cũng được hỗ trợ. Các tùy chọn như kích thước, độ phân giải, tỷ lệ khung hình, chất lượng và định dạng đầu ra phụ thuộc vào mô hình được chọn. Phản hồi bị giới hạn ở 2 MiB; giảm số lượng hoặc kích thước hình ảnh khi cần thiết. Hình ảnh trả về bị giới hạn ở 8192 pixel mỗi cạnh.
Trước khi bạn bắt đầu#
Đặt SHAREAI_API_KEY trên máy chủ của bạn và thay thế placeholder model bằng một model hiện đang được kích hoạt. Không bao giờ để lộ khóa API trong mã trình duyệt. Model, tài khoản, thông tin xác thực và nhà cung cấp phải cho phép thực hiện thao tác này. Các cài đặt tùy chọn dưới đây yêu cầu hỗ trợ từ model; giới hạn an toàn của API không đảm bảo rằng mọi model đều hỗ trợ mọi giá trị.
Gửi một yêu cầu#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_IMAGES_MODEL',
'prompt': 'A quiet forest painted in watercolor.',
'n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/images', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/images", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Các trường yêu cầu#
| Trường | Loại | Ý nghĩa và giới hạn |
|---|---|---|
model bắt buộc | chuỗi | Định danh mô hình công khai chính xác đã được kích hoạt. Phải khai báo thao tác này và được thông qua bởi thông tin xác thực của bạn. |
prompt bắt buộc | chuỗi | Lời nhắc tạo không rỗng, tối đa 256 KiB văn bản UTF-8. |
n | số nguyên | Số lượng hình ảnh tùy chọn, 1–10; mặc định là 1. Mô hình của bạn có thể cho phép ít hơn. |
size | chuỗi | Kích thước đầu ra được mô hình hỗ trợ, tối đa 100 ký tự, ví dụ 1024×1024. Không phải mọi mô hình đều hỗ trợ tùy chọn này. |
resolution | chuỗi | Bộ chọn độ phân giải được mô hình hỗ trợ, tối đa 100 ký tự; phải khớp với biến thể biểu giá đã công bố. |
aspect_ratio | chuỗi | Bộ chọn tỷ lệ khung hình được mô hình hỗ trợ, tối đa 100 ký tự. |
quality | chuỗi | Bộ chọn chất lượng được mô hình hỗ trợ, tối đa 100 ký tự; có thể chọn một mức giá khác. |
response_format | chuỗi | Định dạng phản hồi được mô hình hỗ trợ, tối đa 100 ký tự. Hoạt động xác định liệu kết quả là JSON hay nhị phân. |
output_format | chuỗi | Bộ chọn mã hóa đầu ra được mô hình hỗ trợ, tối đa 100 ký tự. |
background | chuỗi | Cài đặt nền hình ảnh tùy chọn khi được mô hình hỗ trợ. |
seed | số nguyên | Hạt giống tùy chọn được mô hình hỗ trợ. Video yêu cầu một số nguyên không âm; khả năng tái tạo phụ thuộc vào trình thực thi. |
input_references | mảng | Tối đa 16 phần image_url được gõ với image_url.url được đặt thành một URL HTTPS hoặc URL dữ liệu hình ảnh được hỗ trợ. Yêu cầu hỗ trợ mô hình. |
provider | đối tượng | Tùy chọn ưu tiên định tuyến nhà cung cấp. Sử dụng provider.only cho các thẻ nhà cung cấp được chấp nhận, không phải tiền tố trong ID mô hình. Các hạn chế về tài khoản và thông tin xác thực vẫn được áp dụng. |
Đọc kết quả#
Thành công trả về HTTP 200 với JSON. Phản hồi JSON đồng bộ chứa kết quả hình ảnh trong data. Bí danh /api/v1/images/generations cũng được hỗ trợ. Các tùy chọn như kích thước, độ phân giải, tỷ lệ khung hình, chất lượng và định dạng đầu ra phụ thuộc vào mô hình được chọn. Phản hồi bị giới hạn ở 2 MiB; giảm số lượng hoặc kích thước hình ảnh khi cần thiết. Hình ảnh trả về bị giới hạn ở 8192 pixel mỗi cạnh.
Đơn vị thanh toán#
Biểu giá hình ảnh có thể sử dụng hình ảnh được tạo, đo lường megapixel, tham chiếu đầu vào, yêu cầu hoặc token được báo cáo bởi nhà cung cấp. Một URL hình ảnh không phải là phép đo kích thước hình ảnh. Biểu giá megapixel yêu cầu kích thước hình ảnh trả về; sử dụng đầu ra base64 cho các tuyến đó.
Chọn mã định danh model đã kích hoạt chính xác từ Console. Hoạt động được công bố và khả năng đầu vào/đầu ra của nó phải phù hợp với endpoint này; một model trò chuyện văn bản không thể thay thế cho một hoạt động khác. Các hạn chế về thông tin xác thực, nhà cung cấp và tài khoản của bạn vẫn được áp dụng.
Giá cả và sử dụng#
Mức giá được công bố bằng tín dụng AI EUR cho model, nhà cung cấp, đơn vị và biến thể đã chọn. Chỉ các yếu tố trong biểu giá đang hoạt động của nó mới bị tính phí. Một ước tính sẽ giữ trước tín dụng trước khi thực thi; phí cuối cùng sử dụng mức sử dụng được đo lường. Giá có thể phụ thuộc vào độ phân giải, định dạng đầu ra hoặc một dải sử dụng. Kiểm tra Console Usage để biết khoản ghi nợ ShareAI cuối cùng. Các trường chi phí thượng nguồn và byte phương tiện không được chuyển đổi thành số lượng token được tạo ra.
Truy cập và lỗi#
Sử dụng inference cho suy luận chi phí mạng được phê duyệt hoặc monetization_gateway cho một mức tăng giá của Builder được phê duyệt và các điều khoản thanh toán được chấp nhận. Quyền truy cập chỉ danh tính không cho phép chi tiêu. Xác thực, ủy quyền model, tín dụng không đủ, giới hạn tốc độ và lỗi thực thi trả về một cấu trúc error. Sau khi hết thời gian chờ hoặc gửi không chắc chắn, kiểm tra Usage hoặc công việc video trước khi tạo một yêu cầu khác có thể phải trả phí.
Cập nhật lần cuối Tháng 11 3, 2026