curl -X POST "https://t.ato2.nodesms.com/v1/images/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "dall-e-3",
"prompt": "A cute baby sea otter wearing a beret",
"n": 1,
"size": "1024x1024"
}'
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxx",
base_url="https://t.ato2.nodesms.com/v1"
)
response = client.images.generate(
model="dall-e-3",
prompt="A cute baby sea otter wearing a beret",
n=1,
size="1024x1024"
)
print(response.data[0].url)
{
"created": 1719123456,
"data": [
{
"url": "https://example.com/image.png"
}
],
"usage": {
"total_tokens": 500,
"input_tokens": 300,
"output_tokens": 200,
"input_tokens_details": {
"text_tokens": 300,
"image_tokens": 0
}
}
}
图像生成
根据文字描述自动生成图像,兼容 OpenAI Images API 格式。
POST
/
v1
/
images
/
generations
curl -X POST "https://t.ato2.nodesms.com/v1/images/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "dall-e-3",
"prompt": "A cute baby sea otter wearing a beret",
"n": 1,
"size": "1024x1024"
}'
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxx",
base_url="https://t.ato2.nodesms.com/v1"
)
response = client.images.generate(
model="dall-e-3",
prompt="A cute baby sea otter wearing a beret",
n=1,
size="1024x1024"
)
print(response.data[0].url)
{
"created": 1719123456,
"data": [
{
"url": "https://example.com/image.png"
}
],
"usage": {
"total_tokens": 500,
"input_tokens": 300,
"output_tokens": 200,
"input_tokens_details": {
"text_tokens": 300,
"image_tokens": 0
}
}
}
在给定提示的情况下创建图像。了解更多。
请求头
string
必填
Bearer Token 认证,格式:
Bearer <token>请求体
格式:application/json
string
用于图像生成的模型。
dall-e-2、dall-e-3 或 gpt-image-1 之一。默认为 dall-e-2,除非使用特定于 gpt-image-1 的参数。string
必填
所需图像的文本描述。
gpt-image-1 的最大长度为 32000 个字符,dall-e-2 的最大长度为 1000 个字符,dall-e-3 的最大长度为 4000 个字符。integer
要生成的图像数量。必须介于 1 到 10 之间。对于
dall-e-3,仅支持 n=1。string
生成的图像的大小。对于
gpt-image-1,必须是 1024x1024、1536x1024(横向)、1024x1536(纵向)或 auto(默认值)之一;对于 dall-e-2,必须是 256x256、512x512 或 1024x1024 之一;对于 dall-e-3,必须是 1024x1024、1792x1024 或 1024x1792 之一。string
允许为生成的图像的背景设置透明度。此参数仅支持
gpt-image-1。必须是以下之一:transparent(透明)、opaque(不透明)或 auto(默认值)。使用 auto 时,模型将自动确定图像的最佳背景。如果是透明的,则输出格式需要支持透明度,因此应将其设置为 png(默认值)或 webp。string
控制
gpt-image-1 生成的图像的内容审核级别。必须为 low(限制较少的筛选)或 auto(默认值)。string
将生成的图像的质量。
string
是否流式返回
string
生成图像的风格
string
代表最终用户的唯一标识符
响应
200
格式:application/json
integer
必填
创建时间戳(Unix 时间)。
object
必填
curl -X POST "https://t.ato2.nodesms.com/v1/images/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "dall-e-3",
"prompt": "A cute baby sea otter wearing a beret",
"n": 1,
"size": "1024x1024"
}'
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxx",
base_url="https://t.ato2.nodesms.com/v1"
)
response = client.images.generate(
model="dall-e-3",
prompt="A cute baby sea otter wearing a beret",
n=1,
size="1024x1024"
)
print(response.data[0].url)
{
"created": 1719123456,
"data": [
{
"url": "https://example.com/image.png"
}
],
"usage": {
"total_tokens": 500,
"input_tokens": 300,
"output_tokens": 200,
"input_tokens_details": {
"text_tokens": 300,
"image_tokens": 0
}
}
}
最后修改于 2026年10月28日
此页面对您有帮助吗?