创建图片

POST/v1/images/generations

根据文本生成图片，或根据文本和一张或多张输入图片生成/编辑图片。图像生成会在本次请求中直接返回结果，不需要像视频生成一样先提交任务再轮询结果。你可以直接使用返回的 data[].url 下载图片。如需使用专用下载或删除接口，请先通过 GET /v1/images 获取图片记录 ID。

身份验证

Authorization Bearer

在 Authorization header 中使用 API key 作为 Bearer token。

Request Body

modelstringrequired

图片模型 ID。

promptstringrequired

要生成图片的文本描述。

ninteger

生成图片数量。可用性取决于所选模型。

sizestringdefault:模型默认值

图片尺寸或分辨率枚举。可用值取决于所选模型。

Example: "1024x1024"

response_formatstring

图片响应格式。可用性取决于所选模型。

watermarkboolean

是否添加供应商水印。可用性取决于所选模型。

seedinteger

随机种子。可用性取决于所选模型。

sequential_image_generationstring

连续生图模式。可用性取决于所选模型。

qualitystring

输出质量。可用性取决于所选模型。

ratiostring

输出宽高比。可用性取决于所选模型。

模型特殊说明

Kling Image O1：模型卡中提供专属 n 和 size 控制。
Seedream 4.5：模型卡中提供专属 seed、watermark、response_format、sequential_image_generation 控制。
Seedream 4.0：模型卡中提供专属 seed、watermark、response_format、sequential_image_generation 控制。
Dola-Seedream-5.0-lite：模型卡中提供专属 seed 和 watermark 控制。
Nano Banana Pro：模型卡中提供专属 ratio 和 quality 控制。
GLM-Image：不暴露额外的统一图像参数。

Response

createdinteger

Unix 时间戳。

modelstring

实际服务请求的供应商侧模型标识。

dataobject[]

生成的图片。

data.urlstring

下载生成图片的 URL。

data.b64_jsonstring

模型返回 Base64 图片时的内容。

usageobject

用量信息，例如 generated_images、output_tokens、total_tokens。

请求

1curl -X POST https://api.token360.ai/v1/images/generations \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "dola-seedream-5.0-lite",
6    "prompt": "A minimalist sunrise over calm water, digital illustration",
7    "size": "2048x2048"
8  }'

响应

JSON

1{
2  "created": 1776352070,
3  "model": "dola-seedream-5.0-lite",
4  "data": [
5    {
6      "url": "your-generated-image-url"
7    }
8  ],
9  "usage": {
10    "generated_images": 1,
11    "output_tokens": 16384,
12    "total_tokens": 16384
13  }
14}

此页面对您有帮助吗？