创建图片

POST/v1/images/generations

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

身份验证

Authorization Bearer

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

Request Body

modelstringrequired

Model ID.

promptstringrequired

Image generation prompt.

ninteger

Number of images to generate.

sizestring

Requested output image dimensions, such as width-by-height, when the model uses explicit image size values.

aspect_ratiostring

Requested output image shape as a width-to-height ratio.

resolutionstring

Requested output image resolution or resolution tier.

qualitystring

Requested generation quality or fidelity tier.

seedinteger

Optional numeric seed for repeatable generation when deterministic seeding is supported.

prompt_extendboolean

Prompt extension flag.

negative_promptstring

Negative prompt.

max_reference_imagesinteger

Reference image limit.

watermarkboolean

Controls whether generated images include a watermark when supported.

response_formatstring

Response format.

imagesarray

Reference images.

sequential_image_generationstring

Sequential image generation mode.

sequential_image_generation_optionsobject

Sequential image generation configuration.

sequential_image_generation_options.max_imagesinteger

Maximum number of images to generate in sequential mode.

optimize_prompt_optionsobject

Prompt optimization configuration.

optimize_prompt_options.modestring

Prompt optimization mode, such as standard or fast.

strengthnumber

Input image influence strength.

enable_interleaveboolean

Interleaved generation flag.

enable_web_searchboolean

Web search flag.

output_formatstring

Requested file format for generated image outputs.

streamboolean

Streaming response flag.

metadataobject

Application metadata.

extra_bodyobject

Additional request body fields.

provider_optionsobject

Upstream configuration.

Response

createdinteger

Unix 时间戳。

modelstring

实际服务请求的模型标识。

dataobject[]

生成的图片。

data.urlstring

下载生成图片的 URL。

data.b64_jsonstring

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

data.output_formatstring

模型返回时的输出图片格式，例如 jpeg 或 png。

data.sizestring

模型返回时的输出图片尺寸，格式为 <width>x<height>。

data.errorobject | null

单张图片生成失败时的错误详情。

usageobject

本次请求的用量信息。

usage.generated_imagesinteger

模型成功生成的图片数量。

usage.input_imagesinteger

模型返回时的输入参考图片数量。

usage.output_tokensinteger

模型返回时，生成图片消耗的输出 token。

usage.total_tokensinteger

模型返回时，本次请求消耗的总 token。

errorobject

返回错误 payload 时的请求级错误详情。

error.codestring

错误码。

error.messagestring

错误信息。

请求

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-pro",
6    "prompt": "A minimalist sunrise over calm water, digital illustration",
7    "size": "2K",
8    "output_format": "png",
9    "watermark": false
10  }'

响应

JSON

1{
2  "created": 1776352070,
3  "model": "dola-seedream-5.0-pro",
4  "data": [
5    {
6      "url": "your-generated-image-url",
7      "output_format": "png",
8      "size": "2048x2048"
9    }
10  ],
11  "usage": {
12    "generated_images": 1,
13    "input_images": 0,
14    "output_tokens": 16384,
15    "total_tokens": 16384
16  }
17}

此页面对您有帮助吗？