生成图像
使用 ShareAI Images API 创建图像,需使用支持的模型、文本提示和验证的图像生成选项。
本页面内容
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"
}'
Python
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))
TypeScript
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());
请求字段#
| 字段 | 价值 |
|---|---|
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