生成图片

接口参考来自当前平台公开协议。具体模型的模式和规格请在模型详情中确认。

POST/v1/images/generations

身份认证

bearerAuth

认证方式Bearer <token>

传入位置: header

请求头参数

X-Client-Request-Id?string

可选客户端关联值，只能包含可见 ASCII，最多 512 字节；不能替代服务端 requestId。

长度length <= 512

请求正文

application/json

aspectRatio?string

受控输出长宽比；H3 由服务能力合同返回，例如 21:9、16:9、4:3、1:1、3:4、9:16。

generationMode?string

模型支持的生成模式，例如 t2i（文生图）、i2i（图生图）。

imageCount?integer

请求生成图片数量；以模型允许范围为准。

范围1 <= value

input_image_asset_id?string

受控单张图片素材，仅用于支持图片输入的模型。

input_image_asset_ids?array<string>

按顺序排列的输入图片 ID；仅支持多图的模型可用，不与单图字段混传。

input_image_url?string

可选：与 input_image_asset_id 并列的外部来源，二选一。只接受公网 HTTPS（443 端口），另接受 data:image/png|jpeg|webp;base64, 图片数据；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

input_image_urls?array<string>

有序 URL 数组，按位置改写为 input_image_asset_ids。可选：与 input_image_asset_ids 并列的外部来源，二选一。只接受公网 HTTPS（443 端口），另接受 data:image/png|jpeg|webp;base64, 图片数据；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

model*string

图片模型的公开别名。

orientation?string

画幅方向，合法值按模型规格选择。

outputSizeCode?string

模型公布的输出尺寸代码；不要自行拼接尺寸。

prompt*string

图片生成提示词；字符上限由所选服务声明。

qualityTier?string

模型公布的质量档位。

reference_image_url?string

可选：与 reference_image_asset_id 并列的外部来源，二选一。只接受公网 HTTPS（443 端口），另接受 data:image/png|jpeg|webp;base64, 图片数据；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

reference_image_urls?array<string>

有序 URL 数组，按位置改写为 reference_image_asset_ids。可选：与 reference_image_asset_ids 并列的外部来源，二选一。只接受公网 HTTPS（443 端口），另接受 data:image/png|jpeg|webp;base64, 图片数据；平台在接纳前经受控下载器摄入为当前调用身份和模型的一小时临时素材，再按资源 ID 原链路处理，等同先调用 /v1/assets/input。同槽位同时传 ID 与 URL 返回 400 ambiguous_input_source；同请求重复 URL 只下载一次；来源被拒为 400 invalid_source_url，下载失败 502 source_fetch_failed，超时 504 source_fetch_timeout；部署关闭本能力时返回 400 input_url_not_enabled。

resolutionTier?string

所选模型支持的清晰度档位。

seed?integer

可选随机种子；幂等重试时保持原值。

size?string

图片尺寸，格式为宽x高，例如1024x1024；仅可使用所选服务 mediaSpecContract 声明的尺寸。

storageMode?string

平台存储策略，使用顶层字段：默认 personal_30d，将本次主动上传或生成的资源保存到当前用户资源空间，自资源入库起 30 天到期，可在门户“我的资源”改为永久保存，仍占用配额。temporary_1h 自入库起 1 小时到期，仅后台已对所属用户或组织开启临时存储权限时可选；未授权时拒绝，不静默降级。生成请求不改变已引用素材的原到期时间。公网 URL 受控导入的临时输入遵循独立的 1 小时策略，不因本字段进入个人资源空间。

默认值"personal_30d"

可选值

"personal_30d"
"temporary_1h"

响应正文

`application/json`

{  "id": "job_example",  "jobId": "job_example",  "jobUrl": "https://api.example.test/v1/jobs/job_example?model=minimax-h3",  "model": "minimax-h3",  "requestId": "req_example",  "serviceKind": "video_generation",  "stage": "queued",  "status": "queued"}

身份认证

请求头参数

请求正文

响应正文

200application/json

202application/json

400application/json

401application/json

402application/json

403application/json

404application/json

409application/json

413application/json

415application/json

422application/json

429application/json

500application/json

502application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`