Tạo một hình ảnh

Sử dụng mô hình hình ảnh hiện đang được kích hoạt trên ShareAI và được phép bởi thông tin xác thực của bạn. Mô hình xác định kích thước, mức chất lượng và các tùy chọn đầu ra mà nó hỗ trợ.

Gửi một yêu cầu#

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/images/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
}'

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

Các trường yêu cầu#

Đọc hình ảnh#

Kiểm tra các data mục trả về. Tùy thuộc vào mô hình và định dạng yêu cầu, một mục có thể chứa URL hình ảnh HTTPS hoặc dữ liệu hình ảnh base64. Sử dụng định dạng thực tế được trả về; không giả định rằng mọi nhà cung cấp đều trả về URL. API không tải xuống các URL hình ảnh trả về cho bạn.

Giới hạn kích thước và thời gian#

Các yêu cầu là đồng bộ. Văn bản kết hợp bị giới hạn ở 256 KiB, cuộc gọi nhà cung cấp bị giới hạn ở 120 giây và phản hồi bị giới hạn ở 2 MiB. Các hình ảnh base64 lớn có thể vượt quá giới hạn phản hồi đó. Chọn kích thước đầu ra phù hợp hoặc mô hình hỗ trợ đầu ra URL.

Thử lại cẩn thận#

Việc tạo hình ảnh có thể phát sinh chi phí sử dụng. Sau khi hết thời gian chờ hoặc lỗi mạng không rõ ràng, kiểm tra hoạt động trước khi thử lại; lặp lại yêu cầu có thể tạo và tính phí cho một hình ảnh khác. API không tự động thử lại yêu cầu hình ảnh sau khi gửi đến nhà cung cấp.

Các thao tác được hỗ trợ#

Tuyến đường này tạo hình ảnh từ văn bản. Chỉnh sửa hình ảnh, biến thể, tải lên nhiều phần và tạo hình ảnh phát trực tiếp không được hỗ trợ. Hiện tại việc tính phí yêu cầu hợp đồng sử dụng mã thông báo mô hình/nhà cung cấp tương thích; các nhà cung cấp chỉ tính phí theo hình ảnh có thể không khả dụng.

Sử dụng ủy quyền của khách hàng#

Đối với luồng OAuth đã được phê duyệt, gửi mã truy cập dưới dạng Bearer. Việc tạo hình ảnh được tài trợ bởi tài khoản yêu cầu surcharge và kế hoạch sử dụng được chấp nhận. Tất cả các hạn chế về mô hình, nhà cung cấp và tài khoản vẫn được áp dụng.