生成图像
同步的 JSON 响应包含数据中的图像结果。.
本页面内容
https://api.shareai.now/api/v1/images生成图像
- 基础 URL
https://api.shareai.now- 身份验证
- Bearer API 密钥或已批准的 OAuth 访问令牌
- 必需范围
inferenceormonetization_gateway
同步的 JSON 响应包含图像结果在 data. 。别名 /api/v1/images/generations 也支持选项,例如 size、resolution、aspect_ratio、quality 和 output format,这些取决于所选模型。响应限制为 2 MiB;必要时减少图像数量或大小。返回的图像每边像素限制为 8192。.
开始之前#
在您的服务器上设置 SHAREAI_API_KEY,并将模型占位符替换为当前启用的模型。切勿在浏览器代码中暴露 API 密钥。模型、账户、凭证和提供者必须全部允许此操作。以下可选设置需要模型支持;API 安全范围并不保证每个模型支持所有值。.
发送请求#
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);请求字段#
| 字段 | 类型 | 含义与限制 |
|---|---|---|
model 必需 | 字符串 | 精确启用的公共模型标识符。必须声明此操作并由您的凭证允许。. |
prompt 必需 | 字符串 | 非空生成提示,最多 256 KiB 的 UTF-8 文本。. |
n | 整数 | 可选图像数量,1–10;默认值为1。您的模型可能允许更少的数量。. |
size | 字符串 | 模型支持的输出尺寸,最多 100 个字符,例如 1024×1024。并非每个模型都支持此选项。. |
resolution | 字符串 | 模型支持的分辨率选择器,最多 100 个字符;必须与发布的收费变体匹配。. |
aspect_ratio | 字符串 | 模型支持的宽高比选择器,最多 100 个字符。. |
quality | 字符串 | 模型支持的质量选择器,最多100个字符;可能选择不同的速率。. |
response_format | 字符串 | 模型支持的响应格式,最多 100 个字符。操作决定结果是 JSON 还是二进制。. |
output_format | 字符串 | 模型支持的输出编码选择器,最多100个字符。. |
background | 字符串 | 当模型支持时,可选的图像背景设置。. |
seed | 整数 | 可选模型支持的种子。视频需要非负整数;可重复性取决于执行者。. |
input_references | 数组 | 最多 16 个类型化的 image_url 部分,每个部分的 image_url.url 设置为 HTTPS URL 或支持的图像数据 URL。需要模型支持。. |
provider | 对象 | 可选的提供者路由偏好。使用 provider.only 接受的提供者标签,而不是模型 ID 的前缀。账户和凭证限制仍然适用。. |
阅读结果#
成功返回 HTTP 200 和 JSON。同步的 JSON 响应包含图像结果在 data. 。别名 /api/v1/images/generations 也支持选项,例如 size、resolution、aspect_ratio、quality 和 output format,这些取决于所选模型。响应限制为 2 MiB;必要时减少图像数量或大小。返回的图像每边像素限制为 8192。.
计费单位#
图像费用可以使用生成的图像、测量的百万像素、输入参考、请求或提供者报告的令牌。图像 URL 不是图像大小的测量。百万像素费用需要返回的图像尺寸;对于这些路径,请使用 base64 输出。.
从控制台选择精确启用的模型标识符。其声明的操作和输入/输出能力必须与此端点匹配;文本聊天模型不能替代其他操作。您的凭证、提供者和账户限制仍然适用。.
定价与使用#
费率以选定模型、提供者、单位和变体的 EUR AI 积分发布。仅收费于其活动费率中的维度。估算会在执行前保留积分;最终费用使用测量的使用量。价格可能取决于分辨率、输出格式或使用范围。请检查控制台使用情况以获取最终的 ShareAI 扣款。上游成本字段和媒体字节不会转换为虚构的令牌计数。.
访问与错误#
使用 inference 用于批准的网络成本推理或 monetization_gateway 用于批准的 Builder 加价和接受的计费条款。仅身份访问不授权支出。验证、模型授权、积分不足、费率限制和执行失败会返回结构化 error. 在超时或提交不确定后,请检查使用情况或视频任务,然后再创建另一个可能付费的请求。.
最近更新日期:2026年11月3日