ShareAI Platform Docs

生成图像

使用 ShareAI Images API 创建图像,需使用支持的模型、文本提示和验证的图像生成选项。

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

从文本提示生成图像。

基础 URL
https://api.shareai.now
身份验证
Bearer API 密钥或已批准的 OAuth 访问令牌

使用当前在 ShareAI 上启用并由您的凭证允许的图像模型。模型决定支持的尺寸、质量级别和输出选项。

发送请求#

cURL

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"
}'

请求字段#

字段价值
model一个启用的图像生成模型 ID。
prompt一个非空的文本描述。
n图像数量,从 1 到 10,具体取决于模型支持。
size / quality可选的模型支持的尺寸和质量值。
response_format / output_format可选的模型支持的响应和文件格式设置。
background可选的模型支持的背景设置。

阅读图像#

检查返回的 data 条目。根据模型和请求的格式,条目包含一个 HTTPS 图像 URL 或 base64 图像数据。使用实际返回的格式;不要假设每个提供者都会返回 URL。API 不会为您下载返回的图像 URL。

尺寸和时间限制#

请求是同步的。组合文本限制为 256 KiB,提供者调用限制为 120 秒,响应限制为 2 MiB。较大的 base64 图像可能会超过该响应限制。选择合适的输出尺寸或支持 URL 输出的模型。

谨慎重试#

生成图像可能会产生使用费用。在超时或网络故障不明确的情况下,请检查活动后再重试;重复请求可能会生成并收费另一个图像。API 不会在提交给提供者后自动重试图像请求。

支持的操作#

此路由从文本生成图像。不支持图像编辑、变体、多部分上传和流式图像生成。当前计费需要兼容的模型/提供者令牌使用合同;仅按图像收费的提供者可能不可用。

使用客户授权#

对于批准的 OAuth 流程,请将访问令牌作为 Bearer 发送。账户资助的图像生成需要 surcharge 和接受的使用计划。所有模型、提供者和账户限制仍然有效。

最近更新于 9 月 15, 2026

ShareAI平台文档
所有文档

按标题或内容搜索。

询问关于此页面的问题

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

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI