ShareAI Platform Docs

生成图像

同步的 JSON 响应包含数据中的图像结果。.

查看为Markdown格式
本页面内容
POST https://api.shareai.now/api/v1/images

生成图像

基础 URL
https://api.shareai.now
身份验证
Bearer API 密钥或已批准的 OAuth 访问令牌
必需范围
inference or monetization_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
}'

请求字段#

字段类型含义与限制
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日

ShareAI平台文档
所有文档

按标题或内容搜索。

询问关于此页面的问题

选择一个助手来探索此页面。您也可以复制页面并将其粘贴到您的对话中。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI